Required. The name of the Connection to delete. Format: projects/*/locations/*/connections/*.
Query parameters
Parameters
etag
string
The current etag of the connection. If an etag is provided and does not match the current etag of the connection, deletion will be blocked and an ABORTED error will be returned.
validateOnly
boolean
If set, validate the request, but do not actually post it.
Request body
The request body must be empty.
Response body
If successful, the response body contains an instance of Operation.
[[["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-07-17 UTC."],[[["\u003cp\u003eThis endpoint deletes a specified connection using a \u003ccode\u003eDELETE\u003c/code\u003e HTTP request to the provided URL.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires a \u003ccode\u003ename\u003c/code\u003e path parameter to identify the connection and supports optional query parameters \u003ccode\u003eetag\u003c/code\u003e for concurrency control and \u003ccode\u003evalidateOnly\u003c/code\u003e for request validation.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must be empty, and a successful deletion will return an \u003ccode\u003eOperation\u003c/code\u003e instance in the response body.\u003c/p\u003e\n"],["\u003cp\u003eTo execute this request, the caller needs the \u003ccode\u003ecloudbuild.connections.delete\u003c/code\u003e IAM permission on the specified resource and the \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],[],null,["# Method: projects.locations.connections.delete\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [IAM Permissions](#body.aspect_1)\n- [Try it!](#try-it)\n\nDeletes a single connection.\n\n### HTTP request\n\n`DELETE https://cloudbuild.googleapis.com/v2/{name=projects/*/locations/*/connections/*}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n### Query parameters\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains an instance of [Operation](/build/docs/api/reference/rest/Shared.Types/Operation).\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](https://cloud.google.com/docs/authentication/).\n\n### IAM Permissions\n\nRequires the following [IAM](https://cloud.google.com/iam/docs) permission on the `name` resource:\n\n- `cloudbuild.connections.delete`\n\nFor more information, see the [IAM documentation](https://cloud.google.com/iam/docs)."]]
