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.
Sets the configuration related to the migration to Dataplex Universal Catalog for an organization or project.
HTTP request
POST https://datacatalog.googleapis.com/v1/{name}:setConfig
Path parameters
Parameters
name
string
Required. The organization or project whose config is being specified. It takes the form organizations/{organization}/locations/{location}.
Request body
The request body contains data with the following structure:
JSON representation
{// Union field configuration can be only one of the following:"tagTemplateMigration": enum (TagTemplateMigration),"catalogUiExperience": enum (CatalogUIExperience)// End of list of possible types for union field configuration.}
Fields
Union field configuration. The configuration field to set. configuration can be only one of the following:
[[["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 page describes how to set the configuration for migrating to Dataplex for an organization or project, using a POST request to the specified URL.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003ename\u003c/code\u003e parameter, which is required, indicates the organization or project for which the configuration is being set and should be formatted as \u003ccode\u003eorganizations/{organization}/locations/{location}\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must specify either the \u003ccode\u003etagTemplateMigration\u003c/code\u003e or \u003ccode\u003ecatalogUiExperience\u003c/code\u003e to control the migration to Dataplex, where \u003ccode\u003etagTemplateMigration\u003c/code\u003e is used for Tag Template migration and \u003ccode\u003ecatalogUiExperience\u003c/code\u003e for UI switch.\u003c/p\u003e\n"],["\u003cp\u003eA successful request will return a \u003ccode\u003eMigrationConfig\u003c/code\u003e instance in the response body, reflecting the applied configuration.\u003c/p\u003e\n"],["\u003cp\u003eSetting this configuration requires the \u003ccode\u003edatacatalog.migrationConfig.set\u003c/code\u003e IAM permission and the \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],[],null,["# Method: organizations.locations.setConfig\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [IAM Permissions](#body.aspect_1)\n- [Try it!](#try-it)\n\n| Data Catalog is deprecated. Please use Dataplex Universal Catalog instead.\nSets the configuration related to the migration to Dataplex Universal Catalog for an organization or project.\n\n### HTTP request\n\n`POST https://datacatalog.googleapis.com/v1/{name}:setConfig`\n\n### Path parameters\n\n### Request body\n\nThe request body contains data with the following structure:\n\n### Response body\n\nIf successful, the response body contains an instance of [MigrationConfig](/data-catalog/docs/reference/rest/v1/MigrationConfig).\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).\n\n### IAM Permissions\n\nRequires the following [IAM](https://cloud.google.com/iam/docs) permission on the `name` resource:\n\n- `datacatalog.migrationConfig.set`\n\nFor more information, see the [IAM documentation](https://cloud.google.com/iam/docs)."]]