Skip to main content
PATCH
Edit a skill

Authorizations

Authorization
string
header
required

Can be either an Organization API Key or Personal Access Token (PAT).

Include in the Authorization header as: Bearer YOUR_TOKEN

Path Parameters

skillId
string<uuid>
required

Skill UUID

Example:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"

Query Parameters

userId
string<uuid>

Requires an Organization API key. The membership ID of the user to attribute the action to.

Body

application/json
body
string

The instructions injected into the agent's context when the skill runs.

Required string length: 1 - 20000
Example:

"Pull revenue by month for the last four quarters, then..."

description
string

What the skill is for. Shown in the skills list, and given to the agent when it chooses between skills.

Required string length: 1 - 1024
Example:

"Summarizes the quarter and flags anything off trend."

identifier
string

Slash-command handle, stored without the slash. Lowercase letters, numbers and hyphens, starting with a letter or number.

Required string length: 1 - 48
Pattern: ^[a-z0-9][a-z0-9-]*$
Example:

"quarterly-report"

name
string

A human-readable name for the skill.

Required string length: 1 - 256
Example:

"Quarterly report"

Response

The updated skill

createdAt
string<date-time>
required

ISO 8601 timestamp of when the skill was created

Example:

"2026-01-15T10:00:00.000Z"

creator
object
required

Details about the user that created the skill.

description
string
required

What the skill is for. Shown in the skills list, and given to the agent when it chooses between skills.

Required string length: 1 - 1024
Example:

"Summarizes the quarter and flags anything off trend."

id
string<uuid>
required

Unique identifier for the skill

Example:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"

identifier
string
required

Slash-command handle, stored without the slash. Lowercase letters, numbers and hyphens, starting with a letter or number.

Required string length: 1 - 48
Pattern: ^[a-z0-9][a-z0-9-]*$
Example:

"quarterly-report"

name
string
required

A human-readable name for the skill.

Required string length: 1 - 256
Example:

"Quarterly report"

updatedAt
string<date-time>
required

ISO 8601 timestamp of the last time the skill was updated.

Example:

"2026-02-01T09:30:00.000Z"

body
string
required

The instructions injected into the agent's context when the skill runs.

Required string length: 1 - 20000
Example:

"Pull revenue by month for the last four quarters, then..."