Update a tag definition
Changes a tag’s label, color, or description without changing any application. This does not update an agent, mint an AgentVersion, or affect a running session.
Authorizations
A Recursion API key, created in the console under API keys.
Path Parameters
Tag id (UUID) as returned by createTag or listTags.
Body
Request body for changing a tag definition. Every field is optional and tag applications remain unchanged.
Replacement display color in #RRGGBB form. Omit to keep the current color.
7^#[0-9A-Fa-f]{6}$"#14b8a6"
Replacement description. Send an empty string to clear it; omit to keep the current description.
280Replacement display label. Leading and trailing whitespace is removed. Omit to keep the current label.
1 - 32Response
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.
Display color in #RRGGBB form.
7^#[0-9A-Fa-f]{6}$"#14b8a6"
Server-assigned RFC 3339 timestamp of when the tag was created.
Display label, trimmed by the service. Unique case-insensitively among live tags in this organization.
1 - 32Organization that owns the tag. Server-assigned from the authenticated principal and never accepted as authority from the request body.
Server-assigned tag id (UUID).
Server-assigned RFC 3339 timestamp of the most recent definition update.
Optional operator-facing explanation of the classification, up to 280 characters.
280