API Basics
API versioning
3 min
all api endpoints contain a numbered version in the url whenever breaking changes are made to the api, a new major version will be created https //api crbcos com/core/v1/cm/customers breaking changes adding new required fields to request changes to the response format data type changes modifying an endpoint url removing endpoints non breaking changes 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 when 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