Skip to main content
PUT
Add a skill revision

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

skill_id
string
required

Skill identifier returned by create or GET /v1/skills

Query Parameters

expected_revision
string
required

Opaque revision token the skill must currently be at. The write applies only if it matches, so it cannot race a concurrent update.

Body

multipart/form-data

The skill bundle as a zip archive

file
file
required

The skill bundle, a zip archive containing SKILL.md

Response

The updated skill

skill_id
string
required

Skill identifier

name
string

Skill name, read from the bundle's SKILL.md

description
string

Skill description, read from the bundle's SKILL.md

revision
string

Opaque token of the revision returned in this response; the latest revision, or the specific one requested via revision

latest_revision
string

Opaque token of the skill's current latest revision; pass as expected_revision to update or delete

created_at
string<date-time>
updated_at
string<date-time>