Learn about our API versioning, our policy for backwards compatibility, and the end-of-life schedule for our APIs.
Current API versions
We currently offer these versions of the Cognite Data Fusion API.
|Playground||Unstable||Do not use in production environments. This version showcases our newest ideas, experimental features and demos. The interface is highly unstable and constantly changing.|
Deprecated API versions
The following API versions have been removed. If you make direct API calls to these versions or use SDKs or other tools that depend on them, you will receive errors.
|API version||SDK version||Removed|
|API 0.4||Python SDK 0.11.x or earlier||September 10, 2019|
|API 0.3||Python SDK 0.11.x or earlier||September 10, 2019|
If we change the current stable API in a way that is backwards-incompatible, we will release those changes as part of a new major API version. The current stable API will be available for 12 months after the release of the next major API version to provide a migration period for our users.
A backwards-incompatible change is a change that causes a previously successful request, or successful parsing of the response, to fail or give different results after the change is released.
Backwards-compatible (non-breaking) changes
We consider the following to be examples of backwards-compatible (non-breaking) changes:
- Increasing the request limits.
- Adding properties to the response body.
- Adding properties to the request body (as long as it doesn't affect previous requests).
- Adding support for more query parameters (as long as it doesn't affect previous requests).
Backwards-incompatible (breaking) changes
We consider the following to be examples of backwards-incompatible (breaking) changes:
- Removing an endpoint.
- Removing a property in the response.
- Changing the error response format (not the status code).
- Changing the status code from 2xx to another 2xx.
- Reducing the limit on a request (not the response). Example: the number of assets to retrieve by
- Changing the name of query parameters and body properties.
- Changing the sort order if the original order was expected by the user.