Create skill version
POST/api/skills/:skill_id/versions
experimental
Expect changes and instability. Introduced on June 24, 2026. Learn how experimental APIs work.
Create a new immutable version for an existing caller-managed skill from an uploaded SKILL.md, .zip, or .skill bundle.
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 408
- 409
- 413
- 429
- 500
- 503
Successful response.
Invalid request (malformed JSON, invalid parameter values, unknown fields).
Missing or invalid authentication token.
Token valid but lacks permission for the requested operation.
Resource not found.
Backend did not respond within the timeout window.
Request conflicts with current state of the resource.
Request body exceeds the maximum allowed size.
Rate limit exceeded. Includes Retry-After header.
Unexpected server-side failure.
Backend temporarily unavailable.