Versioning and changes
The public API is in preview. Its current version is v1, under
/api/v1/. During preview, requests, responses and available operations may
change, including changes that require updating your integration.
Before updating an integration, read the changelog and the current API reference. Download its OpenAPI document when you need the machine-readable contract.
After the first stable release
A stable API version will keep its published contract. Breaking changes will require a new version, with a separate reference and OpenAPI document. The API section under Developers lists the available reference versions.
Response objects may gain fields. Read the fields your integration needs
and accept additional fields. Match errors on their stable code, not on
human-readable messages.
The preview has no stable-release date announced here yet.