---
schema_version: "1"
id: ac36abe2f0cb55c05b667164c3cd104f9a5c05c03402bf964f51c26d6d22b81e
title: Managing API Instance Versions
collection: mulesoft
version: current
locale: en-us
portal_url: https://docs.salesforce.com/mulesoft/current/en-us/api-manager/latest/manage-versions-instances-concept.md
canonical_url: https://docs.mulesoft.com/api-manager/latest/manage-versions-instances-concept
source_site: docs.mulesoft.com
content_type: documentation
content_hash: d178b19ee77a90ec9924462e2e187b86a04e8af07771a8e8649be49d7f2b6db0
description: MuleSoft Documentation Site
release: 2.x
latest: true
---
---
product: API Manager
version: 2.x
is-latest-version: true
---

# Managing API Instance Versions

> For the full documentation index, see: https://docs.mulesoft.com/llms.txt

After you publish new version details for an API definition to Exchange, you must update the **Asset
version** of your deployed API instances in API Manager to reflect the changes.

The API Asset version can only be upgraded or downgraded within the same major version (minor and
patch versions). If you need to upgrade to a different major version, you must create a new API
Instance.

For more information about versions in Exchange, see
[Asset Versions](https://docs.mulesoft.com/exchange/asset-versions).

To change the asset version of an API instance:

1.  Navigate to **Anypoint Platform** > **API Manager**.

2.  In **API Administration**, click the name of the API instance for which you want to change the
    version.

3.  Select **Actions** > **Change API specification**.

4.  In **Asset version**, select your desired version.

5.  Click **Change**.

## See Also

- [API Instance](https://docs.mulesoft.com/api-manager/latest/api-instance-landing-page)

- [Granting Permission to Access an environment](https://docs.mulesoft.com/api-manager/latest/environment-permission-task)

- [Anypoint Exchange documentation](https://docs.mulesoft.com/exchange/)

- [Create an Asset in Exchange](https://docs.mulesoft.com/exchange/to-create-an-asset)

- [Delete an Asset in Exchange](https://docs.mulesoft.com/exchange/to-delete-asset) (also describes deprecating an
  asset)

- [About Exchange Portals](https://docs.mulesoft.com/exchange/about-portals)