HTTP endpoints

HTTP: skills

All 5 skills endpoints, with request fields and access notes.

On this page

GET /v1/skills
POST /v1/skills
DELETE /v1/skills/{id}
GET /v1/skills/{id}
PATCH /v1/skills/{id}

Request fields and access notes below are partial. Additional constraints and permissions may apply. Prefer the corresponding MCP tool and schema where available.

GET /v1/skills

List skills.

Query field names (types and requiredness not specified here): include_archived, include_body, include_manual, project_id.

POST /v1/skills

Create skill.

Access: LAN writes require an active session token. Local loopback requests are exempt from this requirement by default; other permissions still apply.

Request body fields (partial)

Field	Type	Required	Constraints
`project_id`	string	yes	See operation notes.
`name`	string	yes	See operation notes.
`slug`	string	no	See operation notes.
`summary`	string	no	See operation notes.
`activation`	string	no	See operation notes.
`tags`	array	no	See operation notes.
`delivery`	string	no	See operation notes.
`replacement_skill_id`	string	no	See operation notes.
`last_reviewed_at`	string	no	See operation notes.
`metadata`	object	no	See operation notes.

Other constraints may apply, including for fields marked optional.

Additional body field names (types and requiredness not specified here): body.

DELETE /v1/skills/{id}

Delete skill.

Path parameters: id.

Access: LAN writes require an active session token. Local loopback requests are exempt from this requirement by default; other permissions still apply.

This directory does not provide a request schema for this endpoint. Use the corresponding supported tool or client where available.

GET /v1/skills/{id}

Get skill.

Path parameters: id.

Query field names (types and requiredness not specified here): locale, session_id.

PATCH /v1/skills/{id}

Patch skill.

Path parameters: id.

Access: LAN writes require an active session token. Local loopback requests are exempt from this requirement by default; other permissions still apply.

Request body fields (partial)

Field	Type	Required	Constraints
`name`	string	no	See operation notes.
`slug`	string	no	See operation notes.
`summary`	string	no	See operation notes.
`activation`	string	no	See operation notes.
`tags`	array	no	See operation notes.
`delivery`	string	no	See operation notes.
`archived`	boolean	no	See operation notes.
`replacement_skill_id`	string	no	See operation notes.
`last_reviewed_at`	string	no	See operation notes.
`metadata`	object	no	See operation notes.

Other constraints may apply, including for fields marked optional.

Additional body field names (types and requiredness not specified here): body.