---
title: "POST /v3/tagValues"
method: POST
path: "/v3/tagValues"
tags: ["tagValues"]
---

# POST /v3/tagValues

`POST /v3/tagValues`

Creates a TagValue as a child of the specified TagKey. If a another request with the same parameters is sent while the original request is in process the second request will receive an error. A maximum of 1000 TagValues can exist under a TagKey at any given time.

## Query parameters

- `validateOnly` boolean

## Request body

- TagValue — A TagValue is a child of a particular TagKey. This is used to group cloud resources for the purpose of controlling them using policies.
  - `parent` string — Immutable. The resource name of the new TagValue's parent TagKey. Must be of the form `tagKeys/{tag_key_id}`.
  - `etag` string — Optional. Entity tag which users can pass to prevent race conditions. This field is always set in server responses. See UpdateTagValueRequest for details.
  - `description` string — Optional. User-assigned description of the TagValue. Must not exceed 256 characters. Read-write.
  - `namespacedName` string — Output only. The namespaced name of the TagValue. Can be in the form `{organization_id}/{tag_key_short_name}/{tag_value_short_name}` or `{project_id}/{tag_key_short_name}/{tag_value_short_name}` or `{project_number}/{tag_key_short_name}/{tag_value_short_name}`.
  - `updateTime` string, google-datetime — Output only. Update time.
  - `name` string — Immutable. Resource name for TagValue in the format `tagValues/456`.
  - `shortName` string — Required. Immutable. User-assigned short name for TagValue. The short name should be unique for TagValues within the same parent TagKey. The short name must be 256 characters or less, beginning and ending with an alphanumeric character ([a-z0-9A-Z]) with dashes (-), underscores (_), dots (.), and alphanumerics between.
  - `createTime` string, google-datetime — Output only. Creation time.

## Response `200`

Successful response

---

[API](https://skmtc.dev/google/apis/cloudresourcemanager.md) · [All operations](https://skmtc.dev/google/apis/cloudresourcemanager/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/google/cloudresourcemanager/revisions/3d76e8caf96a/schema)