Contact Us 1-800-596-4880

Promoting an API Instance to Another Environment

Before promoting an API instance to another environment, ensure that you have the Manage APIs Configuration permission.

To promote an entity, you must have permissions to view and manage the entity. For example, you must have the View Policies and Manage Policies permissions to promote a policy.

Promote an API Instance from Another Environment

  1. Navigate to Anypoint Platform > API Manager.

  2. In API Administration, click Add API and select Promote API from environment.

  3. Select the Source Environment.

  4. Select the API by entering the name of the API into the search field.

  5. Select the API Version.

  6. Select the API instance label.

  7. Optionally, uncheck any of the Include in Promotion options you want to exclude.

  8. Click Promote.

  9. Review and update the Runtime & Endpoint Configuration details as needed and click Save.

Promoting an API instance affects only the API definition, not the existing deployed applications subscribed to the instance. After promoting an API, the API Label remains the same, but the API Instance ID changes.

For existing applications that must subscribe to a promoted API instance:

  1. Update the API Instance ID within the application.

  2. Update the application’s client ID and secret (because each environment has a different client ID and secret).