Skip to main content
PATCH
cURL
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_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.

Authorizations

Authorization
string
header
required

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

agent_id
string
required

ID of the agent whose skills to update. Also accepts the reserved aliases orchestrivoassistant and analytics.

Body

application/json
attach
string[]

Skill IDs to attach. Ignored if already attached.

detach
string[]

Skill IDs to detach. Ignored if not attached.

Response

The resulting skill set plus what this request changed.

agent_id
string
Example:

"abc123DEFghiJKL"

skill_ids
string[]

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

attached
string[]

Skills newly attached by this request.

detached
string[]

Skills newly detached by this request.

already_attached
string[]

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

already_detached
string[]

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