Skip to main content
DELETE
JavaScript
Remove a tool set or sub-agent assignment from a variation. Objectives it runs from now on no longer see that tool set’s tools, or can no longer call that sub-agent.

Pass the assignment id, not the resource id

The id in the path is the assignment’s own avt_... value, the join row, from the add-assignment response or the variation’s info.assignments. It is not the toolset_... or agent_... id of the thing assigned. Removing the assignment leaves the tool set or sub-agent itself untouched; it only unwires it from this variation. Removing one that is already gone is a 404, so treat a 404 as “already removed.”
This endpoint is for tool-set and sub-agent assignments (avt_...). Memory-layer assignments (avml_...) live on a separate path, remove those with Remove a memory layer.

Add an assignment

Wire a tool set or sub-agent back on.

Remove a memory layer

The memory-layer equivalent, on its own path.

List objective tools

Confirm what a variation’s objectives get.

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"

id
string
required
Example:

"avt_01HXKD2E5NQM3T9AYWCFJE6K89"

Response