We’re working on creating a new and improved REST API for Discourse. This will provide a more consistent and better-documented interface for integrating with Discourse, as well as theme, plugin and core developers.
We’re aiming to adopt the JSON:API spec, with date-based versioning, and cursor-based pagination. The existing API will remain in-place while we build out the new system, and for some time afterwards.
For those interested in following along with the development, this PR and its stack are the place to start.