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|
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)|
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.
Updated about 3 years ago