Update API Spec

Mark everything that has not been implemented yet.
Update a few things where the spec was not that helpful.