Replace an agent's complete tag set
Atomically replaces the agent’s classifications with tag_ids and returns the resulting full definitions. Every id must be live in the calling organization; [] clears the set. This never changes agent.updated_at or mints an AgentVersion.
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
Agent id (UUID) whose classifications are replaced.
Body
Request body for atomically replacing an agent's complete mutable tag classification.
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.
The complete live tag set for this response. Always an array; an empty array means no definitions exist or the agent has no classifications.