Skip to main content
POST
manage skills

Authorizations

Authorization
string
header
required

An API key (es_live_…) from Settings, under API keys, or an OAuth access token.

Headers

Idempotency-Key
string

Retry a paid dispatch safely: the same key returns the job already dispatched instead of charging again.

x-workspace-id
string

The workspace this one call acts in, when it is not the default: for a key or a connected agent, one of the workspaces the user allowed it.

Body

application/json
action
enum<string>
required
Available options:
create,
list,
get,
update,
delete,
disable,
enable
id
string

Skill id from list, required for update, delete, disable and enable; get also takes the name. A skill's parts switch with it.

ids
string[]

For get: skill ids in order. Missing ids are named; get next_ids next; get each read_individually id alone, paged by next_cursor.

Required array length: 1 - 20 elements
max_chars
integer

For get: the most characters this answer may hold. One skill is cut at a paragraph, with next_cursor for the rest; several are returned whole up to there.

Required range: 2000 <= x <= 100000
cursor
integer

For get with one id: continue a body from the next_cursor a previous answer returned.

Required range: x >= 0
name
string

create: the kind of job, in a few plain words, distinct from every name in list. get: a skill by name.

body
string

The whole body; update replaces it. Line one is the description agents choose by: one plain sentence, 140 characters or fewer, not a heading. The method follows, up to 25,000 tokens (about 100,000 characters), the most a host hands an agent whole.

context
string

Optional: one sentence shown to the user beside this action.

Maximum string length: 600

Response

Done, or a job started for work that runs longer (follow it with get_jobs).

ok
any
required
data
object
required
meta
object
required
media
object[]