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.
PATCH
cURL
What are the rules for attach and detach?
What are the rules for attach and detach?
Every request follows these rules:
- 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.
Authorizations
A personal API key or an OAuth 2.0 access token. Personal API keys also require the x-auth-key header with your user ID.
Path Parameters
Body
application/json
Response
The resulting skill set plus what this request changed.