Creating a new version of an API definition

You can create multiple versions of an API definition and edit the versions independently.

Procedure

To create a new version of an API definition, complete the following instructions:

  1. If you have not previously pinned the UI navigation pane then click the Navigate to icon The Navigate to icon.
    The API Manager UI navigation pane opens. To pin the UI navigation pane, click the Pin menu icon The Pin menu icon..
  2. Click Drafts in the UI navigation pane, and then click APIs.
    The APIs tab opens.
  3. Click APIs.
    The APIs tab opens.
  4. Click the API definition that you want to create a new version of.
    The details of your API definition are displayed.
  5. Click the More Actions icon The More Actions icon and then click Save as a new version.
    The Save as a new version window opens.
  6. In the Version field, enter your new version number.
    Note: The version corresponds to the info.version property value of the API's OpenAPI (Swagger 2.0) definition. The version.release.modification version numbering scheme is recommended, for example 1.0.0.
  7. Icon indicating that this applies only to the API Designer UI[V5.0.4 or later] Accept or change the default file name as required.
  8. Click Save as a new version.

Results

You have created a new version of your API definition, which you can now edit independently of other versions. Each version of the API definition is listed separately in the APIs tab of the Compose page of the API Designer.