Stay organized with collections
Save and categorize content based on your preferences.
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:
In the APIs page in API hub, locate and select the API resource you created in the previous quickstart
to view its details page.
In the API details page, under the Versions section, click Add Version to display
the Add a new version form.
In the form:
Enter a name. You can use any name you wish. The name will appear in the user interface. Name is
a required field.
Optionally, add a description and make other selections such as Lifecycle, 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.
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.
In the Google Cloud console, go to the APIs page in API hub.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-28 UTC."],[[["\u003cp\u003eThis guide applies to both Apigee and Apigee hybrid platforms, focusing on managing API resources.\u003c/p\u003e\n"],["\u003cp\u003eYou can add versions to an API resource, which helps organize APIs by grouping them based on operations and other factors.\u003c/p\u003e\n"],["\u003cp\u003eAdding a version involves navigating to the API details page, clicking "Add Version," entering a name, and optionally adding a description and setting other attributes.\u003c/p\u003e\n"],["\u003cp\u003eAfter creating a version, you can view its details by finding the API resource in the API hub and selecting the specific version.\u003c/p\u003e\n"],["\u003cp\u003eYou can access settings and customizations for attributes, version deployment, and API specifications for the resource in the API hub.\u003c/p\u003e\n"]]],[],null,["# Create an API version\n\n*This page\napplies to **Apigee** and **Apigee hybrid**.*\n\nThis page shows you how to add a version to an API resource.\n\nBefore you begin\n----------------\n\nBefore you do the steps in this quickstart, you need to do the steps in [Register an API](./quickstart-api).\n\nAdd a version\n-------------\n\nYou can think of a version as the state of an API at a point in time. Fundamentally,\nversions help you group and organize your APIs based on underlying sets of operations,\ndeployments, and other attributes.To learn more, see [Versions overview](./versions-intro).\n\nTo add a version to your API resource:\n\n1. In the **APIs** page in API hub, locate and select the API resource you created in the previous quickstart to view its details page.\n2. In the **API details** page, under the **Versions** section, click **Add Version** to display the *Add a new version* form.\n\n In the form:\n 1. Enter a name. You can use any name you wish. The name will appear in the user interface. Name is a required field.\n 2. Optionally, add a description and make other selections such as Lifecycle, Compliance, and Accreditation if you wish. Note that values for these system attribute settings can be customized in [Settings](./manage-attributes). The **Documentation** field lets you supply a link to external documentation for the version.\n 3. Skip the remaining attributes, and click **Create**.\n\n| **Note:** You can also add deployments and API specifications to a version. For details, see [Introduction to deployments](./deployments-intro) and [Introduction to API specifications](./specs-intro).\n\nYou have created and linked a version to an API resource.\n\nView version details\n--------------------\n\nAfter you create a version, you can view its details.\n\n1. In the Google Cloud console, go to the **APIs** page in **API hub**.\n\n [Go to API hub](https://console.cloud.google.com/apigee/api-hub/apis)\n2. 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**.\n3. Click the API name to view its details.\n4. In the **Versions** section, locate and select the version you wish to inspect.\n5. The version details page appears. To edit the version's attributes, click **Edit version**.\n\nNext step\n---------\n\n[Create and edit attributes](./quickstart-settings)"]]
