Method: projects.locations.taxonomies.policyTags.delete

Deletes a policy tag together with the following:

  • All of its descendant policy tags, if any
  • Policies associated with the policy tag and its descendants
  • References from BigQuery table schema of the policy tag and its descendants

HTTP request


Path parameters



Required. Resource name of the policy tag to delete.

Note: All of its descendant policy tags are also deleted. It takes the form projects/{project}/locations/{location}/taxonomies/{taxonomies}/policyTags/{policytag}.

Authorization requires the following IAM permission on the specified resource name:

  • datacatalog.taxonomies.update

Request body

The request body must be empty.

Response body

If successful, the response body is empty.

Authorization scopes

Requires the following OAuth scope:


For more information, see the Authentication Overview.