Skip to main content
POST
Create a tag

Authorizations

Authorization
string
header
required

Most Arize AI endpoints require authentication. For those endpoints that require authentication, include your API key in the request header using the format

Body

application/json

Body containing tag creation parameters

name
string
required

Name of the tag. Must be unique within the space, compared case-insensitively — a space containing Production cannot also contain production. Maximum 100 characters.

Required string length: 1 - 100
space_id
string
required

The unique identifier of the space to create the tag in

Example:

"RW50aXR5OjEyMzQ1"

description
string | null

Description of what the tag is for. Defaults to null when omitted.

color
enum<string> | null

Display color for the tag. Defaults to null when omitted, meaning no color is assigned.

Available options:
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.

id
string
required

The unique identifier of the tag

Example:

"RW50aXR5OjEyMzQ1"

name
string
required

The tag name. Unique within the space, compared case-insensitively.

space_id
string
required

The unique identifier of the space the tag belongs to

Example:

"RW50aXR5OjEyMzQ1"

created_at
string<date-time>
required

When the tag was created

updated_at
string<date-time>
required

When the tag was last modified. Equal to created_at until the tag is updated.

description
string | null

Free-form description of what the tag is for. null when no description has been set.

color
enum<string> | null

Display color for the tag. null when no color has been assigned, which clients render with a neutral treatment.

Available options:
GRAY,
INDIGO,
BLUE,
CYAN,
TEAL,
PINE,
GREEN,
LIME,
OLIVE,
LEMON,
YELLOW,
ORANGE,
RED,
CORAL,
PINK,
PLUM,
PURPLE,
BROWN,
AUBURN