Sign in

v1

latestOpenAPI 3.0.02026-07-26492143.5 KB
Agents

Attach or detach agent skills

Attach and/or detach skills on an agent using deltas. This is not a replace-list: skills you don't mention are left untouched.

  • The operation is idempotent. Re-attaching a skill that's already attached (or detaching one that isn't) is reported under already_attached / already_detached rather than failing.
  • A skill ID may not appear in both attach and detach.
  • Up to 100 unique skill IDs total (attach + detach) per request.
  • Attaching requires INVOKE permission on the skill. Detaching is permissive so stale attachments can always be removed.
patch/agents/{agent_id}/skills

Path parameters

agent_idstring required

ID of the agent whose skills to update.

Request body

attachstring[]

Skill IDs to attach. Ignored if already attached.

detachstring[]

Skill IDs to detach. Ignored if not attached.

Response

The resulting skill set plus what this request changed.

agent_idstring
skill_idsstring[]

Full set of skills attached to the agent after this request.

attachedstring[]

Skills newly attached by this request.

detachedstring[]

Skills newly detached by this request.

already_attachedstring[]

Requested attaches that were already attached (no-op).

already_detachedstring[]

Requested detaches that weren't attached (no-op).

Example response

{
  "agent_id": "abc123DEFghiJKL"
}