Skip to main content
POST
/
v1
/
skills
Error
A valid request URL is required to generate request examples
{
  "skill_id": "<string>",
  "name": "<string>",
  "content": "<string>",
  "scope": "<string>",
  "category": "<string>",
  "enabled": true,
  "display_name": "<string>",
  "description": "<string>",
  "icon": "<string>"
}

Authorizations

​
X-API-Key
string
header
required

Personal Access Token, sent verbatim as pat_<32 chars>. PATs are minted from the Chief settings UI.

Headers

​
X-Project-Id
string
required

Project identifier scoping the request. Required on every project-scoped public endpoint. Missing or malformed values respond with HTTP 400 and code publicapi.tenancy.project.missing.

Pattern: ^project_[a-z0-9]{20}$

Body

application/json

Mint a skill. scope is project or user (the compiled system scope is read-only). category is skill or persona.

​
name
string
required
​
content
string
required
​
scope
enum<string>
required
Available options:
project,
user
​
category
enum<string>
required
Available options:
skill,
persona
​
display_name
string
​
description
string
​
icon
string

Response

Skill created.

Full skill view. Tenancy, audit, and hidden internal fields are omitted. enabled reflects the caller's preference.

​
skill_id
string
required
Pattern: ^skill_[a-z0-9]{20}$
​
name
string
required
​
content
string
required
​
scope
string
required
​
category
string
required
​
enabled
boolean
required
​
display_name
string
​
description
string
​
icon
string