You can create multiple versions of a REST API without impacting the existing API definition. You can create multiple versions of an API. You can create a new version of an API from the most recent version of the API.
When you change or update any parameter of an existing API which impacts the existing definition of the API, create a new version of the API.
When you create a new version of an API, a copy of the existing API version gets created. The API name remains the same and the Name field gets updated with the next immediate version number. You can make necessary changes to the new version and then publish the API.
If you edit a previous version of an API, the changes to that particular version doesn't impact the any other versions of the API.
1On the Explore page, navigate to the API.
2On the Actions menu, click Create New Version.
Alternatively, if you published an API on the New > APIs > REST API > Create > Create API page, select Create New Version.
The version number of the API updates to the next immediate version.
If you have an updated version of the API, the Create New Version option on the Actions menu of a previous version of the API appears disabled.