Data Catalog is deprecated and will be discontinued on January 30, 2026. For steps to transition your Data Catalog users, workloads, and content to Dataplex Catalog, see Transition from Data Catalog to Dataplex Catalog.

Method: projects.locations.taxonomies.create

Creates a taxonomy in a specified project.

The taxonomy is initially empty, that is, it doesn't contain policy tags.

HTTP request

POST https://datacatalog.googleapis.com/v1/{parent}/taxonomies

Path parameters

Parameters

Parameters
`parent`	`string` Required. Resource name of the project that the taxonomy will belong to. It takes the form `projects/{project}/locations/{location}`. Authorization requires the following IAM permission on the specified resource `parent`: `datacatalog.taxonomies.create`

parent

string

Required. Resource name of the project that the taxonomy will belong to. It takes the form projects/{project}/locations/{location}.

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

datacatalog.taxonomies.create

Request body

The request body contains an instance of Taxonomy.

Response body

If successful, the response body contains a newly created instance of Taxonomy.

Authorization scopes

Requires the following OAuth scope:

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

For more information, see the Authentication Overview.