Update a tag definition
Atomically merges one or more supplied fields into a live tag definition and returns the stored tag. Omitted fields keep their values; null and an empty object are rejected. This does not change an application, update an agent, mint an AgentVersion, or affect a running session. Concurrent updates serialize at the stored tag row, but a later write to the same field wins. After an ambiguous failure, read the tag and reconcile its current fields before submitting another patch; this operation does not replay a response.
Authorizations
A Recursion API key, created in the console under API keys.
Headers
Optional tenant consistency check. When present, it must name the tenant bound to the API key, including when x-organization-id is default.
1Organization 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.
1Path Parameters
Tag id (UUID) as returned by managedAgentsCreateTag or managedAgentsListTags.
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