Skip to main content
POST
/
skills
Error
A valid request URL is required to generate request examples
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "<string>",
  "description": "<string>",
  "tools_config": {},
  "instructions_md": "<string>",
  "scope": "container_local",
  "is_platform": true,
  "created_by": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
name
string
required
​
tools_config
object
required

Tool configuration (shell, filesystem, health settings)

​
description
string
​
instructions_md
string

Behavioral guidance merged into agent RULES.md at start time.

​
scope
enum<string>
default:container_local

Scope determines assignment authority.

Available options:
container_local,
host_docker,
vps_system

Response

Skill created

​
id
string<uuid>
​
name
string
​
description
string
​
tools_config
object

JSONB tool configuration (shell, filesystem, health settings)

​
instructions_md
string

Behavioral guidance merged into agent RULES.md at start time (fresh-at-start).

​
scope
enum<string>
default:container_local

Scope determines assignment authority. container_local — any user. host_docker/vps_system — admin only.

Available options:
container_local,
host_docker,
vps_system
​
is_platform
boolean

Platform skills are immutable and undeletable.

​
created_by
string | null

Always NULL (admin-created shared resources).

​
created_at
string<date-time>
​
updated_at
string<date-time>