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 creates an empty taxonomy within a specified project.\u003c/p\u003e\n"],["\u003cp\u003eThe HTTP request is a \u003ccode\u003ePOST\u003c/code\u003e to the provided URL, which includes the project and location in the path.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eparent\u003c/code\u003e path parameter is required to identify the project and location where the taxonomy will be created.\u003c/p\u003e\n"],["\u003cp\u003eThe request body should include an instance of the \u003ccode\u003eTaxonomy\u003c/code\u003e resource.\u003c/p\u003e\n"],["\u003cp\u003eSuccessful responses will return a newly created instance of the \u003ccode\u003eTaxonomy\u003c/code\u003e.\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 a specified project.\n\nThe taxonomy is initially empty, that is, it doesn't contain policy tags.\n\n### HTTP request\n\n`POST https://datacatalog.googleapis.com/v1/{parent}/taxonomies`\n\n### Path parameters\n\n### Request body\n\nThe request body contains an instance of [Taxonomy](/data-catalog/docs/reference/rest/v1/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/v1/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)."]]