Skip to main content
PATCH
Update a skill

Authorizations

X-Api-Key
string
header
required

Workspace API key, created in the dashboard under Settings → API Keys.

Path Parameters

id
string
required

Skill UUID.

Body

application/json
title
string
Required string length: 1 - 200
content
string
Maximum string length: 20000
tags
string[]
Maximum array length: 20
Required string length: 1 - 64
appPackage
string | null

Send null to clear the package association.

Required string length: 1 - 256
resultSchema
object | null
folder
string | null

Folder grouping label; send null to clear.

Required string length: 1 - 120
clientRevision
integer<int64>

Monotonic client revision for update ordering.

Required range: 0 <= x <= 9007199254740991

Response

Updated skill (or current row when the revision was stale)

id
string
required
userId
string
required
title
string
required
content
string
required

Markdown skill document.

tags
string[]
required
folder
string | null
required

Optional folder grouping label shown in the skills panel tree.

clientRevision
integer<int64>
required

Persisted autosave revision. Autosave clients should seed their next clientRevision above this value (see PATCH).

isPublic
boolean
required
createdAt
string<date-time>
required
updatedAt
string<date-time>
required
orgId
string | null
appPackage
string | null