Create an API version

This page applies to Apigee and Apigee hybrid.

This page shows you how to add a version to an API resource.

Before you begin

Before you do the steps in this quickstart, you need to do the steps in Register an API.

Add a version

You can think of a version as the state of an API at a point in time. Fundamentally, versions help you group and organize your APIs based on underlying sets of operations, deployments, and other attributes.To learn more, see Versions overview.

To add a version to your API resource:

1. In the APIs page in API hub, locate and select the API resource you created in the previous quickstart to view its details page.
2. In the API details page, under the Versions section, click Add Version to display the Add a new version form.

   In the form:

   1. Enter a name. You can use any name you wish. The name will appear in the user interface. Name is a required field.
   2. Optionally, add a description and make other selections such as Life cycle, Compliance, and Accreditation if you wish. Note that values for these system attribute settings can be customized in Settings. The Documentation field lets you supply a link to external documentation for the version.
   3. Skip the remaining attributes, and click Create.

You have created and linked a version to an API resource.

View version details

After you create a version, you can view its details.

1. In the Google Cloud console, go to the APIs page in Apigee API hub.

   Go to API hub
2. Versions are linked to API resources, so find the API resource you'd like to inspect. If you don't see it, type the name of the API in the Filter.
3. Click the API name to view its details.
4. In the Versions section, locate and select the version you wish to inspect.
5. The version details page appears. To edit the version's attributes, click Edit version.