API Contract

Whenever Elastic Path decides to discontinue or remove features from an API, a 90 days notice is provided to the customers. However, we might provide less than 90 days notice before making major changes or decommissioning APIs if an API creates security risk or an update is required to be in compliance with a law or a third-party relationship.

For each deprecating API, we will provide the following information to the customers:

• The deprecating API and the version, if applicable.
• A new API, if available, to use instead of the deprecating API.

Compatibility

We ensure that every change to Elastic Path Commerce Cloud is compatible with existing API clients, and only contains the following backwards compatible changes:

• New API endpoints
• New optional fields to request payloads
• New fields in response and message payloads
• New events

Beta APIs

An API with Beta label provides users an early access to an upcoming feature. Users can provide feedback on the features earlier in the development process and before we finalize the APIs. These feedback help us to understand functional requirements better and address problems early.

important

Beta features are not certified for use in a production environment. These features might change without a notice.

When you use beta APIs, you must include the EP-Beta-Features header in the API call as in the following example:

EP-Beta-Features=feature1

When you request multiple beta features, use comma as a delimiter. An example for using EP-Beta-Features to call multiple beta feature is:

EP-Beta-Features=feature1,feature2