# API Instances Across Environments

*MuleSoft Platform Architect Study Guide · Governing web APIs on Anypoint Platform · Last updated November 13, 2026 · https://www.certifyforce.com/study-guide/mulesoft-platform-architect/governing-web-apis-on-anypoint-platform/api-instances-across-environments*

Choose environment boundaries for managed API instances, distinguish promotion from deployment and plan permissions and consumer transitions.

- Certification: Salesforce MuleSoft Platform Architect
- Exam section: Governing web APIs on Anypoint Platform
- Study guide: https://www.certifyforce.com/study-guide/mulesoft-platform-architect

**Official exam objective:**

> Make appropriate use of API instances and environments in API Manager, taking into account the nature of the API and the underlying data and system.

## What the exam expects

- Choose an API instance's environment using its operational purpose and underlying systems.
- Distinguish an API version, an instance label and an instance identifier.
- Plan promotion permissions, endpoint changes and application deployment separately.
- Explain classification and deprecation without confusing either with deletion.

An **environment** isolates deployment and administration; an **API instance** is the managed API configuration in that context; an **instance label** identifies the chosen instance; **promotion** copies its definition across environments; **deprecation** closes new access-contract creation while preserving existing contracts ([Environment concepts](https://docs.mulesoft.com/api-manager/latest/environments-concept), [Promotion](https://docs.mulesoft.com/api-manager/latest/promote-api-task), [Deprecation](https://docs.mulesoft.com/api-manager/latest/deprecate-api-latest-task)).

## Key facts

| Fact | Detail | Source |
| --- | --- | --- |
| Environment isolation | Testing can occur separately from production. | [Environments](https://docs.mulesoft.com/access-management/environments) |
| Environment type | Cannot change after creation; a rename does not convert it. | [Environments](https://docs.mulesoft.com/access-management/environments) |
| Unclassified instances | Earlier permissions apply until classification; environment permissions apply afterward. | [Environment concepts](https://docs.mulesoft.com/api-manager/latest/environments-concept) |
| Promotion permission | Manage APIs Configuration plus view/manage permissions for included entities. | [Promotion](https://docs.mulesoft.com/api-manager/latest/promote-api-task) |
| Promoted identity | Label remains; instance ID changes. | [Promotion](https://docs.mulesoft.com/api-manager/latest/promote-api-task) |
| Deployment boundary | Promotion copies the definition, not running applications. | [Promotion](https://docs.mulesoft.com/api-manager/latest/promote-api-task) |
| Target review | Review and update runtime and endpoint configuration as needed. | [Promotion](https://docs.mulesoft.com/api-manager/latest/promote-api-task) |
| Deprecation | Existing contracts remain active; no new contracts can be created. | [Deprecation](https://docs.mulesoft.com/api-manager/latest/deprecate-api-latest-task) |

## Check yourself

- When reviewing API Manager search results, which indicator identifies a deprecated instance?
- Why should an administrator use role permissions when granting environment access?
- When considering a runtime registered in Design, why is a Runtime Manager deployment inappropriate?

## Sources

- [Anypoint Platform Environments](https://docs.mulesoft.com/access-management/environments)
- [Reviewing Environment Concepts](https://docs.mulesoft.com/api-manager/latest/environments-concept)
- [Promoting an API Instance to Another Environment](https://docs.mulesoft.com/api-manager/latest/promote-api-task)
- [Deprecating an API instance on API Manager](https://docs.mulesoft.com/api-manager/latest/deprecate-api-latest-task)

## About the full unit

The "Core concepts", "Exam traps" and "Worked scenario" sections of this unit, its 5 linked practice questions, and unlimited timed mock exams are included with the MuleSoft Platform Architect pack (USD $19): https://www.certifyforce.com/practice-exams