[WIP] Get APIv3 Specification up-to-date with its implementation

This PR is not yet ready to be merged, it is **work in progress*.