Skip to main content
PUT
Replace an agent's complete tag set

Authorizations

Authorization
string
header
required

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

Headers

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

agent_id
string<uuid>
required

Agent id (UUID) whose classifications are replaced.

Body

application/json

Request body for atomically replacing an agent's complete mutable tag classification.

tag_ids
string[]
required

Complete replacement set of tag ids, with at most 32 distinct ids. Every id must be a live tag in the caller's organization. Duplicates are collapsed before enforcing the limit; [] removes every tag.

Response

A complete set of organization-scoped tag definitions. GET /managed-agents/v1/tags returns the organization catalog; agent tag PUT routes return the agent's resulting exact set.

A complete set of organization-scoped tag definitions. GET /managed-agents/v1/tags returns the organization catalog; agent tag PUT routes return the agent's resulting exact set.

tags
object[]
required

The complete live tag set for this response. Always an array; an empty array means no definitions exist or the agent has no classifications.