Create a tag
Create a tag in a space. Tags are shared within the space and can then be attached to resources across the platform.
Payload Requirements
nameis required, must be non-empty after trimming, and at most 100 characters.namemust be unique within the space, compared case-insensitively — a space that already containsProductioncannot also containproduction. A collision returns409.space_idis required and must be a space the caller can create tags in.color, when provided, must be one of theTagColorvalues.- System-managed fields (
id,created_at,updated_at) are rejected on input. - Unrecognized fields are rejected with
400rather than ignored.
Valid example
{
"name": "production",
"description": "Resources serving production traffic",
"color": "GREEN",
"space_id": "U3BhY2U6MTIzNDU="
}
Invalid example (name collides with an existing tag, differing only in case)
Request:
{
"name": "Production",
"space_id": "U3BhY2U6MTIzNDU="
}
Response:
{
"type": "https://arize.com/docs/ax/rest-reference/errors#resource-conflict",
"title": "Conflict",
"status": 409,
"detail": "A tag with this name already exists in the space",
"request_id": "req_01HZY6X8E7"
}
Authorizations
Most Arize AI endpoints require authentication. For those endpoints that require authentication, include your API key in the request header using the format
Body
Body containing tag creation parameters
Name of the tag. Must be unique within the space, compared
case-insensitively — a space containing Production cannot also contain
production. Maximum 100 characters.
1 - 100The unique identifier of the space to create the tag in
"RW50aXR5OjEyMzQ1"
Description of what the tag is for. Defaults to null when omitted.
Display color for the tag. Defaults to null when omitted, meaning no
color is assigned.
GRAY, INDIGO, BLUE, CYAN, TEAL, PINE, GREEN, LIME, OLIVE, LEMON, YELLOW, ORANGE, RED, CORAL, PINK, PLUM, PURPLE, BROWN, AUBURN Response
A tag object
A tag is a reusable label defined once per space and attached to many resources across the platform, so the same vocabulary can be applied to projects, datasets, prompts, and more.
Tags are shared. Renaming a tag changes it everywhere it appears, and deleting a tag detaches it from every resource it was attached to.
The unique identifier of the tag
"RW50aXR5OjEyMzQ1"
The tag name. Unique within the space, compared case-insensitively.
The unique identifier of the space the tag belongs to
"RW50aXR5OjEyMzQ1"
When the tag was created
When the tag was last modified. Equal to created_at until the tag is
updated.
Free-form description of what the tag is for. null when no description
has been set.
Display color for the tag. null when no color has been assigned, which
clients render with a neutral treatment.
GRAY, INDIGO, BLUE, CYAN, TEAL, PINE, GREEN, LIME, OLIVE, LEMON, YELLOW, ORANGE, RED, CORAL, PINK, PLUM, PURPLE, BROWN, AUBURN