Skip to main content
POST
/
v1
/
skills
/
{id}
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}$

Path Parameters

​
id
string
required

Skill identifier.

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

Body

application/json

Patch a skill. Each field is optional; omitting one leaves it unchanged.

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

Response

Skill updated.

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