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 Catalog. Methods that are related to policy tags and policy tag taxonomies are not deprecated.

Method: projects.locations.taxonomies.delete

Deletes a taxonomy. This operation will also delete all policy tags in this taxonomy along with their associated policies.

HTTP request

DELETE https://datacatalog.googleapis.com/v1beta1/{name}

Path parameters

Parameters

Parameters
`name`	`string` 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`

name

string

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.

Authorization scopes

Requires the following OAuth scope:

https://www.googleapis.com/auth/cloud-platform

For more information, see the Authentication Overview.