Skip to main content
POST

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

workspaceId
string
required

Workspace ID.

Example:

"workspace_01HXKD2E5NQM3T9AYWCF133E3Q"

agentId
string
required

Agent ID. Accepts the canonical agent_… form or the external_id:<value> form.

Example:

"agent_01HXKD2E5NQM3T9AYWCFMGWT9Y"

variationId
string
required

Variation ID. Accepts the canonical agentvar_… form or the external_id:<value> form.

Example:

"agentvar_01HXKD2E5NQM3T9AYWCF32BSPP"

Body

application/json

Attach a single tool, tool set, sub-agent, or agent pool to a variation. Exactly one of the target fields must be set; the assignment kind is inferred from the populated field. Adding an existing target returns AlreadyExists. All targets must be in the variation's workspace and eligible for assignment.

type
enum<string>
required
Available options:
toolId
toolId
string
required
Minimum string length: 1
Example:

"tool_01HXKD2E5NQM3T9AYWCFWVYY9K"

Response

OK

AgentVariation resource

metadata
object
required

Resource metadata

spec
object
required

Variation specification

info
object
required

Read-only summary information