Skip to content

Update skill

PATCH
/v1/skills/{skill_id}
skill_id
required
string

Request to update a skill

object
skill_md

Updated SKILL.md content (re-parses frontmatter)

string | null
status
One of:
null

Skill updated

Skill entity (API response type)

object
allowed_tools
string | null
compatibility
string | null
created_at
required
string format: date-time
description
required
string
Example
Extract text and tables from PDF files.
id
required
string
Example
skill_01933b5a00007000800000000000001
license
string | null
metadata
object
key
additional properties
name
required
string
Example
pdf-processing
source_type
required

Skill source type

string
Allowed values: markdown archive
status
required

Skill lifecycle status

string
Allowed values: active disabled
updated_at
required
string format: date-time
version
required
string

Skill not found

Duplicate skill name

Standard error response for API endpoints.

object
error
required

Error message describing what went wrong.

string

Invalid SKILL.md

Standard error response for API endpoints.

object
error
required

Error message describing what went wrong.

string