Skip to main content
POST
Create a skill

Authorizations

X-Api-Key
string
header
required

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

Body

application/json
title
string
required
Required string length: 1 - 200
content
string
required

Markdown skill document. May be empty for a draft.

Maximum string length: 20000
tags
string[]
Maximum array length: 20
Required string length: 1 - 64
appPackage
string | null
Required string length: 1 - 256
resultSchema
object | null
folder
string | null

Folder grouping label.

Required string length: 1 - 120
clientRevision
integer<int64>
Required range: 0 <= x <= 9007199254740991

Response

Skill created

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