Skip to main content
POST
Create a skill version

Authorizations

Authorization
string
header
required

API key: key id as the username, secret as the password. An account API key carries the same scopes as an OAuth token and is checked against the scopes listed under oauth2 on each operation. A trigger API key is limited to its trigger's workspace and reaches only the session operations that list this scheme alongside the oauth2 scopes.

Path Parameters

skill_id_or_name
string
required

Body

application/json
version_number
string
required

Semantic version, higher than the latest, e.g. 1.0.1

description
string
required

What changed

body
string
required

The skill's content, in Markdown

Maximum string length: 262144

Response

Successful response

id
string<uuid>
created_at
string<date-time>
updated_at
string<date-time>
author_id
string<uuid>

The user or API key that created this skill version.

body
string

Full markdown content for this skill version.

Maximum string length: 262144
description
string

Runtime-facing description that tells the LLM when to activate this skill.

Maximum string length: 8192
skill_id
string<uuid>

The skill this version belongs to.

version_number
string

The semantic version number (MAJOR.MINOR.PATCH).

Maximum string length: 64
author
any
skill
any
type
any