Software AG Products 10.7 | Using API Gateway | APIs | Versioning APIs | Creating New API Version
 
Creating New API Version
You must have the API Gateway's manage APIs functional privilege assigned to perform this task.
You can create a new version of an API from the latest version available for the API. For example, if the existing version is 1.1 for an API, you can create a version 1.2. If you want to create a version 1.3, you can only create it from the latest version 1.2 and not from 1.1. However, you can delete the intermediate versions. Additionally, even though the owner of the older API version is a different provider, when you create a new version of the API, you are the owner of the newly created version of the API. The new API version is in inactive state, irrespective of the state of the API from which it was versioned.
*To create a new version
1. Click APIs in the title navigation bar.
2. Select the required API from the list of APIs.
The API details page for the selected API appears.
3. Click and select Create new version.
4. In the Version field, type the new version for the API.
5. Clear the Retain applications checkbox if you do not want to retain applications that are associated with older versions of the API.
6. Click Create.
The Version drop-down lists the newly created API version in latest to older order in the API details page. The corresponding API details page is displayed when you select any particular version.
Note:
The version is appended to the Gateway endpoint(s) URL once the API is activated and this can be seen in the Technical information section of the API details page. When a client application invokes the API without the version in the endpoint, API Gateway invokes the latest version.