Get APIv3 Specification up-to-date with its implementation

This PR cleans up some outdated specification and replaces it by shiny new and valid specification.
Missing space after #.