---
title: "POST /v1/{+parent}/taxonomies:import"
method: POST
path: "/v1/{+parent}/taxonomies:import"
tags: ["projects"]
---

# POST /v1/{+parent}/taxonomies:import

`POST /v1/{+parent}/taxonomies:import`

Creates new taxonomies (including their policy tags) in a given project by importing from inlined or cross-regional sources. For a cross-regional source, new taxonomies are created by copying from a source in another region. For an inlined source, taxonomies and policy tags are created in bulk using nested protocol buffer structures.

## Path parameters

- `parent` string, required

## Request body

- GoogleCloudDatacatalogV1ImportTaxonomiesRequest — Request message for ImportTaxonomies.
  - `inlineSource` GoogleCloudDatacatalogV1InlineSource — Inline source containing taxonomies to import.
    - `taxonomies` GoogleCloudDatacatalogV1SerializedTaxonomy[] — Required. Taxonomies to import.
      - `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.
  - `crossRegionalSource` GoogleCloudDatacatalogV1CrossRegionalSource — Cross-regional source used to import an existing taxonomy into a different region.
    - `taxonomy` string — Required. The resource name of the source taxonomy to import.

## 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/revisions/d65a3d49b170/schema)