Upgrading API Manager from 1.8.0/1.9.0/1.9.1 to 3.2.0

The following information describes how to upgrade your API Manager server from APIM 1.8.0/1.9.0/1.9.1 to 3.2.0.


Before you follow this section, see Upgrading Process for more information.

Follow the instructions below to upgrade your WSO2 API Manager server from APIM 1.8.0/1.9.0/1.9.1 to 3.2.0.


If you are using WSO2 Identity Server (WSO2 IS) as a Key Manager, first follow the instructions in Upgrading WSO2 IS as the Key Manager to 5.10.0.

Step 1 - Upgrade WSO2 API Manager to 2.0.0


It is not possible to directly upgrade from WSO2 API Manager 1.8.0/1.9.0/1.9.1 to 3.2.0.

Upgrade your current WSO2 API-M version (1.8.0/1.9.0/1.9.1) to WSO2 API-M 2.0.0 as expained in the WSO2 API-M 2.0.0 documentation.

Step 2 - Upgrade WSO2 API Manager to 3.2.0

After you have successfully migrated your current WSO2 API-M version to 2.0.0, upgrade from API-M 2.0.0 to API-M 3.2.0. For more information, see Upgrading API Manager from 2.0.0 to 3.2.0.

This concludes the upgrade process.


The migration client that you use in this guide automatically migrates your tenants, workflows, external user stores, etc. to the upgraded environment. Therefore, there is no need to migrate them manually.


If you are using a migrated API and wants to consume it via an application which supports JWT authentication (default type in API-M 3.2.0), you need to republish the API. Without republishing the API, JWT authentication doesn't work as it looks for a local entry which will get populated while publishing.

You can consume the migrated API via an OAuth2 application without an issue.