Deprecation policy

At Commerce, we make sure to maintain backward compatibility. This means that programs written against one version of a Commerce API will continue to work the same way, without modification, against future versions of the API. In cases where that won't possible and a deprecation becomes necessary, we'll follow this deprecation policy.

Notice

Commerce APIs follow the standard Atlassian deprecation policy of 6 months' notice.

There are exceptions to this policy:

• the period can be made shorter if there are critical security vulnerabilities being fixed as part of the deprecation
• the period can be made longer due to a client's business needs or migration complexity

Communication

When a REST API is deprecated, Commerce will issue a changelog entry which will detail:

• description of and reason for the deprecation
• link to a migration guide, if relevant
• specific date of deprecation