Skip to main content Skip to complementary content

Creating a new API version

Create a new version of an existing API definition.

Before you begin

You are an owner of the API or an editor of at least one version of the API.

Procedure

  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 Menu button next to the version that you want to copy and click Create a new version from <version> .
    View of the Movie catalog API and the Menu icon expanded for the 1.1.0 version.
  3. Enter the new version in the Version field.
  4. Optional: Clear the Copy sharing settings check box to reset the sharing settings.
    By default, if the source version is shared with other users or groups, the same settings are copied to the new version. If you clear this check box, the new version will inherit the sharing settings at the API level. For more information, see Sharing a specific version of an API.
  5. Optional: Edit your GitHub settings.
    By default, if the source version is linked to GitHub, the same settings are copied to the new version. You can change the branch and the path, or you can clear the Copy GitHub settings check box to disable the GitHub integration for the new version. You can then enable and configure it as needed. For more information, see Pushing an API version to GitHub.
  6. Click Create.
    Create a new version dialog box where the new version is created from the Movie catalog API version 1.1.0, the new version is 1.2.0 and the options to copy sharing and GitHub settings are selected. The version is created on the master branch.

Results

A new version of your API is created with the same content as the source version. The mock and documentation are disabled by default.

Did this page help you?

If you find any issues with this page or its content – a typo, a missing step, or a technical error – let us know how we can improve!