Sign in

v56

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-01142337440.5 KB
AgentVariationService
Agent Variations

Add an assignment to a variation

Assigns a tool, tool set, or sub-agent to a variation. Exactly one target ID must be set.

post/v1/workspaces/{workspaceId}/agents/{agentId}/variations/{variationId}/assignments

Path parameters

workspaceIdstring required
Example:workspace_01HXKD2E5NQM3T9AYWCF133E3Q

Workspace ID.

agentIdstring required
Example:agent_01HXKD2E5NQM3T9AYWCFMGWT9Y

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

variationIdstring required
Example:agentvar_01HXKD2E5NQM3T9AYWCF32BSPP

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

Request body

OR
OR

Example request

{
  "toolId": "tool_01HXKD2E5NQM3T9AYWCFWVYY9K",
  "workspaceId": "workspace_01HXKD2E5NQM3T9AYWCF133E3Q",
  "agentId": "agent_01HXKD2E5NQM3T9AYWCFMGWT9Y",
  "variationId": "agentvar_01HXKD2E5NQM3T9AYWCF32BSPP"
}

Response

OK

OR
OR

Example response

{
  "id": "avt_01HXKD2E5NQM3T9AYWCFJE6K89"
}