The latest version of the Content Management API is version 3. You can specify the API version with the
POST https://site-api.datocms.com/<ANY ENDPOINT> HTTP/1.1X-Api-Version: 3....
Important: If no header is present on the request version 1 will be used — which has been deprecated for a long time — so make sure to always specify the
The guarantee that the Content Management API offers is to introduce breaking changes only when the API version changes.
It is considered a "breaking change":
a change in path for an existing endpoint;
a change in the format of the request/response payload compared to what stated in this API reference;
We reserve the right to change the format of payloads without changing API version only when:
an attribute/relationship that previously was mandatory in a HTTP request becomes optional;
a new optional attribute/relationship is introduced in a HTTP request;
a new attribute/relationship is introduced in a HTTP response;
a synchronous endpoint becomes asynchronous, but the job result has exactly the same signature as the old synchronous endpoint.
In other words, no fields will ever be removed from the responses, but new ones might be added if they do not break former behaviours.