Data Catalog API methods that are related to Data Catalog search and metadata are deprecated and will be discontinued on January 30, 2026. See Transition from Data Catalog to Dataplex Universal Catalog. Methods that are related to policy tags and policy tag taxonomies are not deprecated.
Required. Resource name of the taxonomy to be deleted. All policy tags in this taxonomy will also be deleted. It takes the form projects/{project}/locations/{location}/taxonomies/{taxonomies}.
Authorization requires the following IAM permission on the specified resource name:
datacatalog.taxonomies.delete
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-17 UTC."],[[["\u003cp\u003eThis webpage documents how to delete a taxonomy, including all associated policy tags, using the Data Catalog API.\u003c/p\u003e\n"],["\u003cp\u003eThe HTTP request method for deleting a taxonomy is \u003ccode\u003eDELETE\u003c/code\u003e, and it requires a specific URL structure including the resource name.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003ename\u003c/code\u003e parameter is a required path parameter that specifies the taxonomy to delete in the format \u003ccode\u003eprojects/{project}/locations/{location}/taxonomies/{taxonomies}\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe request body for deleting a taxonomy must be empty, and a successful response is also an empty JSON object.\u003c/p\u003e\n"],["\u003cp\u003eDeleting a taxonomy requires the \u003ccode\u003edatacatalog.taxonomies.delete\u003c/code\u003e IAM permission and the \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],[],null,["# Method: projects.locations.taxonomies.delete\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_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 taxonomy. This operation will also delete all policy tags in this taxonomy along with their associated policies.\n\n### HTTP request\n\n`DELETE https://datacatalog.googleapis.com/v1beta1/{name}`\n\n### Path 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 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)."]]