Upgrade versions

This page lists breaking changes between versions of API Mesh for Adobe Developer App Builder. For a list of new features and resolved issues, refer to the release notes.

Software updates

nvm 18 is required for API Mesh.

Update nvm to version 18. The following command shows one way to do this:
```
nvm use 18
```
Update the API Mesh plugin.

To update Adobe I/O and all registered plugins, run the following command:
```
aio update
```

To update the API Mesh plugin only, run the following command:

aio plugins:install @adobe/aio-cli-plugin-api-mesh

If you encounter any issues installing the plugin, try uninstalling any existing plugins first by running aio plugins:uninstall. The aio plugins command will list any installed plugins.

See our NPM page or Getting Started for more information.

Mesh create and update time

While most create and update commands will take a few seconds, complex meshes and meshes with several sources will take a few minutes to fully provision and propagate.

To check the status of your mesh, use the aio api-mesh:status command, which allows you to view where your mesh is in the provisioning process.

Additionally, due to our new asynchronous architecture, the create/update commands now add your mesh to a queue where it waits to be processed, which means you will no longer receive an error if your mesh fails to create/update. We have added the aio api-mesh:status command to allow you to check the processing status of your mesh and see any errors that occurred during creating/updating.

<!--

Update existing meshes

API Mesh now runs on updated versions of GraphQL Mesh handlers and transforms. To move to the new codebase and enable these upgrades, update your existing meshes.

Select the workspace that contains the mesh you want to update.
Retrieve your previously created mesh by running the following get command.
```
aio api-mesh:get download.json
```

This command creates a file named download.json that contains a copy of the mesh from the selected workspace.

Run the update command and reference the previously created file.
```
aio api-mesh:update download.json
```
It can take a few minutes to fully provision and propagate your mesh. -->