{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/TagKey",
  "title": "TagKey",
  "type": "object",
  "description": "A tag key, used to group tag values. Tag keys define namespaces for tag values that can be attached to resources for organization and policy purposes.",
  "properties": {
    "name": {
      "type": "string",
      "description": "The resource name of the tag key in the form tagKeys/{tag_key_id}. Output only.",
      "readOnly": true,
      "example": "Example Title"
    },
    "parent": {
      "type": "string",
      "description": "The resource name of the parent. Must be of the form organizations/{org_id}.",
      "example": "example_value"
    },
    "shortName": {
      "type": "string",
      "description": "The user-friendly short name for the tag key. The short name must be unique within the same parent and have a maximum length of 256 characters.",
      "maxLength": 256,
      "example": "example_value"
    },
    "namespacedName": {
      "type": "string",
      "description": "The namespaced name of the tag key in the form {parentId}/{shortName}. Output only.",
      "readOnly": true,
      "example": "example_value"
    },
    "description": {
      "type": "string",
      "description": "User-assigned description of the tag key. Maximum length of 256 characters.",
      "maxLength": 256,
      "example": "A sample description."
    },
    "createTime": {
      "type": "string",
      "format": "date-time",
      "description": "Timestamp when the tag key was created. Output only.",
      "readOnly": true,
      "example": "2026-01-15T10:30:00Z"
    },
    "updateTime": {
      "type": "string",
      "format": "date-time",
      "description": "Timestamp when the tag key was last modified. Output only.",
      "readOnly": true,
      "example": "2026-01-15T10:30:00Z"
    },
    "etag": {
      "type": "string",
      "description": "Entity tag for optimistic concurrency control.",
      "readOnly": true,
      "example": "example_value"
    }
  }
}