This RPC throws an exception if the integration is in ARCHIVED or ACTIVE state. This RPC throws an exception if the version being published is DRAFT, and if the lockedBy user is not the same as the user performing the Publish. Audit fields updated include last_published_timestamp, last_published_by, lastModifiedTimestamp, last_modified_by. Any existing lock is on this integration is released.
HTTP request
POST https://integrations.googleapis.com/v1/{name=projects/*/locations/*/integrations/*/versions/*}:publish
[[["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-22 UTC."],[[["\u003cp\u003eThis page details how to publish a specific version of an integration using a POST request to a designated URL with the required path parameters.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires a JSON structured body containing optional configuration parameters, within an \u003ccode\u003eobject\u003c/code\u003e format.\u003c/p\u003e\n"],["\u003cp\u003eSuccessful execution of this publish request will result in an empty response body and will also release any existing locks on the integration.\u003c/p\u003e\n"],["\u003cp\u003eThis request updates audit fields like \u003ccode\u003elast_published_timestamp\u003c/code\u003e, \u003ccode\u003elast_published_by\u003c/code\u003e, \u003ccode\u003elastModifiedTimestamp\u003c/code\u003e, and \u003ccode\u003elast_modified_by\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe operation requires specific OAuth scopes (\u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e) and IAM permissions (\u003ccode\u003eintegrations.integrationVersions.deploy\u003c/code\u003e) for the target resource.\u003c/p\u003e\n"]]],[],null,["# Method: projects.locations.integrations.versions.publish\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [IAM Permissions](#body.aspect_1)\n- [Try it!](#try-it)\n\nThis RPC throws an exception if the integration is in ARCHIVED or ACTIVE state. This RPC throws an exception if the version being published is DRAFT, and if the `lockedBy` user is not the same as the user performing the Publish. Audit fields updated include last_published_timestamp, last_published_by, lastModifiedTimestamp, last_modified_by. Any existing lock is on this integration is released.\n\n### HTTP request\n\n`POST https://integrations.googleapis.com/v1/{name=projects/*/locations/*/integrations/*/versions/*}:publish`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n### Request body\n\nThe request body contains data with the following structure:\n\n### Response body\n\nIf successful, the response body is empty.\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/cloud-platform`\n\nFor more information, see the [Authentication Overview](/docs/authentication#authorization-gcp).\n\n### IAM Permissions\n\nRequires the following [IAM](https://cloud.google.com/iam/docs) permission on the `name` resource:\n\n- `integrations.integrationVersions.deploy`\n\nFor more information, see the [IAM documentation](https://cloud.google.com/iam/docs)."]]
