Skip to main content
PATCH
Update a skill

Authorizations

x-api-key
string
header
required

Project API key. Create and manage keys in the dashboard under Project → API Keys. Send as header: x-api-key:

Path Parameters

id
string
required

Skill ID

Example:

"3fa85f64-5717-4562-b3fc-2c963f66afa6"

Body

application/json
name
string

Display name

Maximum string length: 200
Example:

"Invoice follow-up"

description
string

WHAT + WHEN for skill discovery (max 1024 chars)

Maximum string length: 1024
Example:

"Draft a polite follow-up when an invoice is 7 days overdue."

instructions
string

SKILL.md body (markdown instructions)

Example:

"# Invoice follow-up\n\n1. Load the invoice\n2. Draft a reminder email\n"

category
string | null

Optional category for browsing My Skills. Null clears it.

Maximum string length: 64
Example:

"finance"

tags
string[] | null

Free-form tags (max 20). Null clears them.

Example:
suggestedToolSlugs
string[] | null

Known tool slugs for this playbook (skip DISCOVER → GET_TOOL_SCHEMAS). Not merged onto agents. Null clears them.

Example:
isPublic
boolean

If true, other projects can discover the skill

Example:

false

version
string

Semver-style skill version

Maximum string length: 32
Example:

"1.1.0"

activeStatus
boolean

False disables the skill without deleting it

Example:

true

Response

200 - application/json

Operation completed successfully

success
boolean
required

Success status

Example:

true

message
string
required

Success message

Example:

"Operation completed successfully"

data
object
required
Example: