---
title: "POST /v1/{+name}:replace"
method: POST
path: "/v1/{+name}:replace"
tags: ["projects"]
---

# POST /v1/{+name}:replace

`POST /v1/{+name}:replace`

Replaces (updates) a taxonomy and all its policy tags. The taxonomy and its entire hierarchy of policy tags must be represented literally by `SerializedTaxonomy` and the nested `SerializedPolicyTag` messages. This operation automatically does the following: - Deletes the existing policy tags that are missing from the `SerializedPolicyTag`. - Creates policy tags that don't have resource names. They are considered new. - Updates policy tags with valid resources names accordingly.

## Path parameters

- `name` string, required

## Request body

- GoogleCloudDatacatalogV1ReplaceTaxonomyRequest — Request message for ReplaceTaxonomy.
  - `serializedTaxonomy` GoogleCloudDatacatalogV1SerializedTaxonomy — A nested protocol buffer that represents a taxonomy and the hierarchy of its policy tags. Used for taxonomy replacement, import, and export.
    - `displayName` string — Required. Display name of the taxonomy. At most 200 bytes when encoded in UTF-8.
    - `description` string — Description of the serialized taxonomy. At most 2000 bytes when encoded in UTF-8. If not set, defaults to an empty description.
    - `policyTags` GoogleCloudDatacatalogV1SerializedPolicyTag[] — Top level policy tags associated with the taxonomy, if any.
      - `policyTag` string — Resource name of the policy tag. This field is ignored when calling `ImportTaxonomies`.
      - `displayName` string — Required. Display name of the policy tag. At most 200 bytes when encoded in UTF-8.
      - `description` string — Description of the serialized policy tag. At most 2000 bytes when encoded in UTF-8. If not set, defaults to an empty description.
      - `childPolicyTags` GoogleCloudDatacatalogV1SerializedPolicyTag[] — Children of the policy tag, if any.
    - `activatedPolicyTypes` string[] — A list of policy types that are activated per taxonomy.

## Response `200`

Successful response

---

[API](https://skmtc.net/google/apis/datacatalog.md) · [All operations](https://skmtc.net/google/apis/datacatalog/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/datacatalog/versions/d65a3d49b170/schema)