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

# POST /v1/{+parent}/fields

`POST /v1/{+parent}/fields`

Creates a field in a tag template. You must enable the Data Catalog API in the project identified by the `parent` parameter. For more information, see [Data Catalog resource project](https://cloud.google.com/data-catalog/docs/concepts/resource-project).

## Path parameters

- `parent` string, required

## Query parameters

- `tagTemplateFieldId` string

## Request body

- GoogleCloudDatacatalogV1TagTemplateField — The template for an individual field within a tag template.
  - `name` string — Identifier. The resource name of the tag template field in URL format. Example: `projects/{PROJECT_ID}/locations/{LOCATION}/tagTemplates/{TAG_TEMPLATE}/fields/{FIELD}` Note: The tag template field itself might not be stored in the location specified in its name. The name must contain only letters (a-z, A-Z), numbers (0-9), or underscores (_), and must start with a letter or underscore. The maximum length is 64 characters.
  - `displayName` string — The display name for this field. Defaults to an empty string. The name must contain only Unicode letters, numbers (0-9), underscores (_), dashes (-), spaces ( ), and can't start or end with spaces. The maximum length is 200 characters.
  - `type` GoogleCloudDatacatalogV1FieldType
    - `primitiveType` 'PRIMITIVE_TYPE_UNSPECIFIED' | 'DOUBLE' | 'STRING' | 'BOOL' | 'TIMESTAMP' | 'RICHTEXT' — Primitive types, such as string, boolean, etc.
    - `enumType` GoogleCloudDatacatalogV1FieldTypeEnumType
      - `allowedValues` GoogleCloudDatacatalogV1FieldTypeEnumTypeEnumValue[] — The set of allowed values for this enum. This set must not be empty and can include up to 100 allowed values. The display names of the values in this set must not be empty and must be case-insensitively unique within this set. The order of items in this set is preserved. This field can be used to create, remove, and reorder enum values. To rename enum values, use the `RenameTagTemplateFieldEnumValue` method.
        - `displayName` string — Required. The display name of the enum value. Must not be an empty string. The name must contain only Unicode letters, numbers (0-9), underscores (_), dashes (-), spaces ( ), and can't start or end with spaces. The maximum length is 200 characters.
  - `isRequired` boolean — If true, this field is required. Defaults to false.
  - `description` string — The description for this field. Defaults to an empty string.
  - `order` integer — The order of this field with respect to other fields in this tag template. For example, a higher value can indicate a more important field. The value can be negative. Multiple fields can have the same order and field orders within a tag don't have to be sequential.

## 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)