Working with multiple versions

Create a new version of an existing API definition.

1. On the homepage, go to the API for which you want to create a new version.
   You can filter the list by name or owner if needed.
2. Click the button next to the version that you want to copy and click Create a new version from <version> .

   

3. Enter the new version in the Version field.
4. Click Create.

1. On the homepage, click the button next to the version that you want to delete and click Delete.
   Information noteNote: You cannot delete a version if its documentation is published on API Portal. You need to unpublish it or mark it as unpublished before deleting it. For more information, see Managing your API documentation.
2. Click Delete to confirm.

Import content from an existing contract into an API version, replacing or merging its current content.

1. Open Import version content for the version you want to update.

   You can access this action from the following locations:

   • On the homepage, click the menu button next to the version and click Import version content.

     

   • On the homepage, select the version to open the detail pane, then click Import version content.

     

   • In the version editor, click Edit > Import version content.

     

2. Select a format and a source for the contract to import.
   You can import from a local file, a URL, or text you paste directly into the dialog box.
3. Under Behavior, select how to apply the imported content.
   • Replace: overwrites all current content with the imported contract. The API name, version identifier, and specification version are preserved.
   • Merge: combines the imported content with the existing version content. The API name and version identifier are preserved. If an imported element has the same name as an existing element, the imported element is renamed with a _merge suffix (for example, User_merge). Duplicate base URLs and media types are skipped.

   

4. Click Import.