Method: projects.locations.integrations.versions.deactivate

Sets the status of the ACTIVE integration to SNAPSHOT with a new tag "PREVIOUSLY_PUBLISHED" after validating it. The "HEAD" and "PUBLISH_REQUESTED" tags do not change. This RPC throws an exception if the version being snapshot is not ACTIVE. Audit fields added include action, actionBy, actionTimestamp.

HTTP request

POST https://<GOOGLE_CLOUD_REGION>{name=projects/*/locations/*/integrations/*/versions/*}:deactivate

The URL uses gRPC Transcoding syntax.

Path parameters



Required. The version to deactivate. Format: projects/{project}/integrations/{integration}/versions/{version}

Request body

The request body must be empty.

Response body

If successful, the response body is empty.

Authorization Scopes

Requires the following OAuth scope:


For more information, see the Authentication Overview.

IAM Permissions

Requires one of the following IAM permissions on the name resource, depending on the resource type:

  • integrations.integrationVersions.deploy

For more information, see the IAM documentation.