Skip to main content
POST
Create a skill

Authorizations

Authorization
string
header
required

User session JWT or instance API key (iak_*). Send as Authorization: Bearer <token>.

Body

application/json

Writable fields for creating or updating a skill.

name
string
display_name
string
description
string
instructions
string
tools
object[]

Response

Skill created (note: the implementation returns 200, not 201).

Registry entry (prompt/instructions). Intentionally permissive. Note the implementation does NOT emit an object discriminator, and the field is instructions (plural).

id
string
required
name
string
display_name
string
description
string
instructions
string
tools
object[]
user_id
string
orgSlug
string | null