Skip to main content
PUT
Apply one tag to an agent

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) as returned by managedAgentsCreateAgent or managedAgentsListAgents.

tag_id
string<uuid>
required

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

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.