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.
[[["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 endpoint facilitates the creation of a new taxonomy within a specified project on Google Cloud Data Catalog.\u003c/p\u003e\n"],["\u003cp\u003eThe HTTP request method is POST, and the endpoint URL includes a required \u003ccode\u003eparent\u003c/code\u003e path parameter, defining the project and location for the taxonomy.\u003c/p\u003e\n"],["\u003cp\u003eCreating a taxonomy requires proper authorization, specifically the \u003ccode\u003edatacatalog.taxonomies.create\u003c/code\u003e IAM permission on the project resource and \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must contain the details of the new taxonomy as an instance of the \u003ccode\u003eTaxonomy\u003c/code\u003e resource, and a successful response will include the created \u003ccode\u003eTaxonomy\u003c/code\u003e instance.\u003c/p\u003e\n"]]],[],null,["# Method: projects.locations.taxonomies.create\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\nCreates a taxonomy in the specified project.\n\n### HTTP request\n\n`POST https://datacatalog.googleapis.com/v1beta1/{parent}/taxonomies`\n\n### Path parameters\n\n### Request body\n\nThe request body contains an instance of [Taxonomy](/data-catalog/docs/reference/rest/v1beta1/projects.locations.taxonomies#Taxonomy).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [Taxonomy](/data-catalog/docs/reference/rest/v1beta1/projects.locations.taxonomies#Taxonomy).\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)."]]