cURL
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_detachedrather than failing. - A skill ID may not appear in both
attachanddetach. - Up to 100 unique skill IDs total (
attach+detach) per request. - Attaching requires
INVOKEpermission on the skill. Detaching is permissive so stale attachments can always be removed.
PATCH
cURL
Authorizations
Path Parameters
ID of the agent whose skills to update.
Body
application/json
Response
The resulting skill set plus what this request changed.
Example:
"abc123DEFghiJKL"
Full set of skills attached to the agent after this request.
Skills newly attached by this request.
Skills newly detached by this request.
Requested attaches that were already attached (no-op).
Requested detaches that weren't attached (no-op).
