Versioning

The API is versioned, with a mandatory “Accept-Version” header. Some endpoints will only be available in newer versions, or change behaviour in ways which we will define in the Changelog.

curl -H 'Accept-Version: 1.0.0' ...

We will only update versions for breaking changes. New endpoints or new fields added to existing endpoints will not change version numbers.