Create A Skill Version

Creating a skill version is part of the public beta skill surface.

Route

POST /api/skills/:id/versions

Auth

• auth mode: api_key_or_access_token
• user permission: ai.use
• API-key scope: skills:write

Workflow

1. Create or select a skill.
2. Post a new version to POST /api/skills/:id/versions.
3. Re-read GET /api/skills/:id to inspect the returned version object.
4. Publish with POST /api/skills/:id/publish when ready.

Dedicated prompt/layer/tool attachment routes exist in the implementation, but they are outside the current public docs boundary.

See also

• Publish A Version
• Skills