Integrations are design time entities that are often developed in collaboration with multiple authors.
Although an integration can only be actively edited by one author at a time,
teams can collaborate on an integration and track changes in state through its versions.
A version of an integration can be in any of the following states:
DRAFT: The state of an integration version actively being edited by an author.
When an integration is in DRAFT, edit capabilities are only available to the current author.
The integration is locked for editing by others for 15 minutes from the last update. Locks are released after 15 minutes from the last update.
SNAPSHOT: When a new author takes over editing a version, the existing version
is converted to SNAPSHOT and a new DRAFT is created.
ACTIVE: The state of a published version.
DELETED: The state of a version that has been deleted by an author, or remains
untouched for a specified period of time.
Only a DRAFT version of the integration is editable and only an ACTIVE version of the integration can be run from the integration editor or fired by a configured trigger. For information about editing integrations and edit locks, see Edit and view integrations.
Viewing Version History
To view the version history of an integration, use the following steps:
In the Google Cloud console, go to the Application Integration page.
Click Integrations from the left navigation menu to open the Integrations page.
Select an existing integration. This opens the integration in the integration editor.
Click the Version drop-down in the designer toolbar. The drop-down lists all available versions of the integration, along with a color indicating
the version status:
Green: The version is currently active.
Yellow: The version is currently being edited.
Gray: The version is inactive.
Click on a version, and the integration editor displays the requested version in its last modified state.
Create a new version
To create a new version of an existing integration:
Click the Version drop-down in the integration editor toolbar.
Select Create New Version.
(Optional) Add a label to the new version to help other editors identify the version.
Click OK.
Delete a version
To delete a version of an integration that is no longer in use, perform the following steps:
Click the Version drop-down, and select the version to delete.
The integration editor displays the requested version in its last modified state.
In the toolbar, click
more_vert
(Actions menu) and select Delete the current version.
[[["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-26 UTC."],[[["\u003cp\u003eIntegrations can be developed collaboratively, with changes tracked through different versions, each having a status of \u003ccode\u003eDRAFT\u003c/code\u003e, \u003ccode\u003eSNAPSHOT\u003c/code\u003e, \u003ccode\u003eACTIVE\u003c/code\u003e, or \u003ccode\u003eDELETED\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eOnly \u003ccode\u003eDRAFT\u003c/code\u003e versions of an integration are editable, and only \u003ccode\u003eACTIVE\u003c/code\u003e versions can be run or triggered.\u003c/p\u003e\n"],["\u003cp\u003eThe version history of an integration can be viewed in the integration editor by selecting the "Version" drop-down, where each version is color-coded to indicate its status.\u003c/p\u003e\n"],["\u003cp\u003eNew versions of an integration can be created from the integration editor by using the "Version" drop-down and there is an option to add labels to help editors identify the version.\u003c/p\u003e\n"],["\u003cp\u003eUnneeded versions of an integration can be deleted from the integration editor, but deleting all versions will delete the entire integration.\u003c/p\u003e\n"]]],[],null,["# Integration versions\n\nSee the [supported connectors](/integration-connectors/docs/connector-reference-overview) for Application Integration.\n\nIntegration versions\n====================\n\nIntegrations are design time entities that are often developed in collaboration with multiple authors.\nAlthough an integration can only be actively edited by one author at a time,\nteams can collaborate on an integration and track changes in state through its *versions*.\n\nA version of an integration can be in any of the following states:\n\n- `DRAFT`: The state of an integration version actively being edited by an author. When an integration is in `DRAFT`, edit capabilities are only available to the current author. The integration is locked for editing by others for 15 minutes from the last update. Locks are released after 15 minutes from the last update.\n- `SNAPSHOT`: When a new author takes over editing a version, the existing version is converted to `SNAPSHOT` and a new `DRAFT` is created.\n- `ACTIVE`: The state of a published version.\n- `DELETED`: The state of a version that has been deleted by an author, or remains untouched for a specified period of time.\n\nOnly a `DRAFT` version of the integration is editable and only an `ACTIVE` version of the integration can be run from the integration editor or fired by a configured trigger. For information about editing integrations and edit locks, see [Edit and view integrations](/application-integration/docs/view-integration-details).\n\nViewing Version History\n-----------------------\n\nTo view the version history of an integration, use the following steps:\n\n1. In the Google Cloud console, go to the **Application Integration** page.\n\n [Go to Application Integration](https://console.cloud.google.com/integrations)\n2. Click **Integrations** from the left navigation menu to open the **Integrations** page.\n3. Select an existing integration. This opens the integration in the *integration editor*.\n4. Click the **Version** drop-down in the designer toolbar. The drop-down lists all available versions of the integration, along with a color indicating the version status:\n - **Green**: The version is currently active.\n - **Yellow**: The version is currently being edited.\n - **Gray**: The version is inactive.\n5. Click on a version, and the integration editor displays the requested version in its last modified state.\n\nCreate a new version\n--------------------\n\nTo create a new version of an existing integration:\n\n1. Click the **Version** drop-down in the integration editor toolbar.\n2. Select **Create New Version**.\n3. (Optional) Add a label to the new version to help other editors identify the version.\n4. Click **OK**.\n\nDelete a version\n----------------\n\nTo delete a version of an integration that is no longer in use, perform the following steps:\n| **Caution**: Deleting all versions of an integration will result in deleting the entire integration.\n\n1. Click the **Version** drop-down, and select the version to delete.\n\n\n The integration editor displays the requested version in its last modified state.\n2. In the toolbar, click more_vert (Actions menu) and select **Delete the current version**.\n3. In the confirmation dialog, click **OK**.\n\nQuotas and limits\n-----------------\n\nFor information about quotas and limits, see [Quotas and limits](/application-integration/docs/quotas).\n\nWhat's next\n-----------\n\n- Learn about [all tasks and triggers](/application-integration/docs/all-triggers-tasks).\n- Learn how to [test and publish an integration](/application-integration/docs/test-publish-integrations).\n\n- Learn about [error handling](/application-integration/docs/error-handling-strategy).\n- Learn about [integration execution logs](/application-integration/docs/introduction-logs)."]]
