Deletes a capacity commitment. Attempting to delete capacity commitment before its commitmentEndTime will fail with the error code google.rpc.Code.FAILED_PRECONDITION.
Required. Resource name of the capacity commitment to delete. E.g., projects/myproject/locations/US/capacityCommitments/123
Authorization requires the following IAM permission on the specified resource name:
bigquery.capacityCommitments.delete
Query parameters
Parameters
force
boolean
Can be used to force delete commitments even if assignments exist. Deleting commitments with assignments may cause queries to fail if they no longer have access to slots.
Request body
The request body must be empty.
Response body
If successful, the response body is an empty JSON object.
[[["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-02 UTC."],[[["\u003cp\u003eThis webpage outlines the process for deleting a capacity commitment via an HTTP DELETE request to a specified URL.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires a resource name in the path, which includes the project, location, and commitment ID.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization is required, specifically the \u003ccode\u003ebigquery.capacityCommitments.delete\u003c/code\u003e IAM permission, or the use of one of the two specified OAuth scopes.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must be empty, and the optional \u003ccode\u003eforce\u003c/code\u003e query parameter allows for the deletion of commitments even if assignments exist.\u003c/p\u003e\n"],["\u003cp\u003eA successful deletion results in an empty JSON response body, while attempting to delete a commitment before its \u003ccode\u003ecommitmentEndTime\u003c/code\u003e will result in a failed precondition error.\u003c/p\u003e\n"]]],[],null,["# Method: projects.locations.capacityCommitments.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- [Try it!](#try-it)\n\nDeletes a capacity commitment. Attempting to delete capacity commitment before its commitmentEndTime will fail with the error code `google.rpc.Code.FAILED_PRECONDITION`.\n\n### HTTP request\n\n`DELETE https://bigqueryreservation.googleapis.com/v1/{name=projects/*/locations/*/capacityCommitments/*}`\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 is an empty JSON object.\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/bigquery`\n- `https://www.googleapis.com/auth/cloud-platform`\n\nFor more information, see the [Authentication Overview](/docs/authentication#authorization-gcp)."]]
