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."],[[["This webpage documents how to delete a taxonomy, including all associated policy tags, using the Data Catalog API."],["The HTTP request method for deleting a taxonomy is `DELETE`, and it requires a specific URL structure including the resource name."],["The `name` parameter is a required path parameter that specifies the taxonomy to delete in the format `projects/{project}/locations/{location}/taxonomies/{taxonomies}`."],["The request body for deleting a taxonomy must be empty, and a successful response is also an empty JSON object."],["Deleting a taxonomy requires the `datacatalog.taxonomies.delete` IAM permission and the `https://www.googleapis.com/auth/cloud-platform` OAuth scope."]]],[]]
