All COS API endpoints contain a numbered version in the URL. Whenever breaking changes are made to the API, a new major version will be created.

We consider breaking changes to be any of the following and warrant a new major version:

Breaking Change Example

Adding new required fields to request

Changes to the response format

Data type changes

Modifying an endpoint URL

Removing endpoints

The following are NOT considered to be a breaking change and would be released as part of a minor version:

Non-breaking Change Example

Adding new endpoints

Adding new optional fields to request

Adding new fields to response

Adding new values to fields (e.g. a new status value)

Bug fixes


Deprecated Versions

Whenever we release a new major version, we will continue to support the previous version for a period of at least 6 months before it is deprecated. We strive to communicate changes such as this well in advance with our partners to avoid any disruption in service.

Did this page help you?