API Versions
Learn how to specify which REST API version to use whenever you make a request to the ICR REST API.
About API versioning
The ICR REST API is versioned. The API version name is based on the date when the API version was released. For example, the API version 2023-06-16 was released on 16 June 2023.
Any breaking changes will be released in a new API version. Breaking changes are changes that can potentially break an integration. Breaking changes include:
removing an entire operation
removing or renaming a parameter
removing or renaming a response field
adding a new required parameter
making a previously optional parameter required
changing the type of a parameter or response field
removing enum values
adding a new validation rule to an existing parameter
changing authentication or authorization requirements
Any additive (non-breaking) changes will be available in all supported API versions. Additive changes are changes that should not break an integration. Additive changes include:
adding an operation
adding an optional parameter
adding an optional request header
adding a response field
adding a response header
adding enum values
When a new REST API version is released, the previous API version will be supported for at least 6 more months following the release of the new API version.
Specifying an API version
You should use the X-ICR-Api-Version header to specify an API version. For example:
Requests without the X-ICR-Api-Version header will default to use the newest version.
If you specify an API version that is no longer supported, you will receive a 400 error.
Supported API versions
The following REST API versions are currently supported:
2023-06-16
Last updated