Skip to main content
POST
Create a skill

Authorizations

X-API-Key
string
header
required

Body

application/json
name
string
required
Pattern: ^[a-z0-9_]+$
Example:

"my_skill"

label
string
required
Example:

"My Skill"

instructions_md
string
default:""
description_md
string
default:""
webhook_url
string<uri> | null
http_method
enum<string>
default:POST
Available options:
GET,
POST,
PUT,
PATCH,
DELETE
parameters
object
headers
object

Response

Skill created.

id
string
name
string

Lowercase letters, digits, underscores. Used in soul allowed_skills.

label
string
instructions_md
string | null

Behavioral guide injected into the system prompt.

description_md
string | null

Tool description when webhook_url is set.

webhook_url
string | null

When set, the skill is a callable webhook tool.

http_method
enum<string>
default:POST
Available options:
GET,
POST,
PUT,
PATCH,
DELETE
parameters
object
headers
object
is_active
boolean
created_at
string<date-time>