Skip to main content
GET
Get one organization tag

Authorizations

Authorization
string
header
required

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

Headers

If-None-Match
string

Previously returned ETag. When it still identifies the current representation, the response is 304 with no body.

x-tenant-id
string

Optional tenant consistency check. When present, it must name the tenant bound to the API key, including when x-organization-id is default.

Minimum string length: 1
x-organization-id
string

Organization in which to act. Required for a tenant-scoped API key. Optional for an organization-scoped key, where it must name that same organization. The value may be an organization id or default.

Minimum string length: 1

Path Parameters

tagId
string<uuid>
required

Tag id (UUID) as returned by managedAgentsCreateTag or managedAgentsListTags.

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
read-only

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
read-only

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
read-only

Server-assigned tag id (UUID).

updated_at
string<date-time>
required
read-only

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