Skip to main content
POST
/
api
/
skills
/
{id}
/
shift-version
Error
A valid request URL is required to generate request examples
{
  "skill": {
    "id": "<string>",
    "name": "review-migrations",
    "description": "Reviews database migration safety and rollback behavior.",
    "license": "MIT",
    "compatibility": "Claude Code, Codex",
    "metadata": {},
    "extra_frontmatter": {},
    "allowed_tools": "<string>",
    "skill_md_body": "<string>",
    "latest_version": "1.0.0",
    "created_by": "<string>",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "files": [
      {
        "path": "references/style-guide.md",
        "mime_type": "text/markdown",
        "content": "<string>",
        "source_url": "<string>",
        "dataurl": "data:text/plain;base64,SGVsbG8=",
        "upload_id": "<string>",
        "storage_key": "<string>",
        "blob_id": "<string>",
        "id": "<string>",
        "skill_version_id": "<string>",
        "file_size_bytes": 123,
        "created_at": "2023-11-07T05:31:56Z",
        "updated_at": "2023-11-07T05:31:56Z"
      }
    ],
    "file_count": 123,
    "highest_version": "1.2.0"
  }
}

Authorizations

Authorization
string
header
required

Management API authentication for /api/* endpoints. Use the Authorization header with Bearer <API key>. Virtual keys, dashboard/user/session tokens, and x-api-key headers are not supported on management APIs.

Path Parameters

id
string
required

Skill ID

Body

application/json
version
string
required
Example:

"1.0.0"

Response

Served version shifted successfully

skill
object

Skill repository entry and currently served version metadata.