Skip to main content
POST
Create an organization tag

Authorizations

Authorization
string
header
required

A Recursion API key, created in the console under API keys.

Body

application/json

Request body for creating one organization-scoped tag definition. The organization always comes from the authenticated principal.

color
string
required

Display color in #RRGGBB form.

Required string length: 7
Pattern: ^#[0-9A-Fa-f]{6}$
Example:

"#14b8a6"

label
string
required

Display label. Leading and trailing whitespace is removed; the result must contain 1-32 characters and be unique case-insensitively among live tags in the organization.

Required string length: 1 - 32
description
string

Optional operator-facing explanation of this classification, up to 280 characters.

Maximum string length: 280

Response

An organization-scoped classification definition. Applying or removing it changes only catalog membership: it does not update the agent, mint an AgentVersion, or affect running sessions.

An organization-scoped classification definition. Applying or removing it changes only catalog membership: it does not update the agent, mint an AgentVersion, or affect running sessions.

color
string
required

Display color in #RRGGBB form.

Required string length: 7
Pattern: ^#[0-9A-Fa-f]{6}$
Example:

"#14b8a6"

created_at
string<date-time>
required

Server-assigned RFC 3339 timestamp of when the tag was created.

label
string
required

Display label, trimmed by the service. Unique case-insensitively among live tags in this organization.

Required string length: 1 - 32
organization_id
string
required

Organization that owns the tag. Server-assigned from the authenticated principal and never accepted as authority from the request body.

tag_id
string<uuid>
required

Server-assigned tag id (UUID).

updated_at
string<date-time>
required

Server-assigned RFC 3339 timestamp of the most recent definition update.

description
string

Optional operator-facing explanation of the classification, up to 280 characters.

Maximum string length: 280