---
title: "Promote a Skill Version"
method: POST
path: "/v1/skills/{id}/versions/{version}/promote"
tags: ["Skill Versions"]
---

# Promote a Skill Version

`POST /v1/skills/{id}/versions/{version}/promote`

## Request

- Base URL: `http://localhost:3000`
- URL: `http://localhost:3000/v1/skills/{id}/versions/{version}/promote`
- Auth: HTTP bearer

Promotes a version status (draft -> stable -> live).

## Path parameters

- `id` string, required
- `version` integer, required

## Response `200`

Version promoted successfully

## Changes

- **2026-07-14** `95f3baf4c960`: 2 info
  - api tag `Skill Versions` added
  - api tag `Skills` removed
- **2026-07-14** `bed7a47c6f25`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/px0-ai/apis/px0-api/changes/v1/skills/:id/versions/:version/promote/post.md)

---

[API](https://skmtc.dev/px0-ai/apis/px0-api.md) · [All operations](https://skmtc.dev/px0-ai/apis/px0-api/llms.txt) · [OpenAPI document](https://skmtc.dev/px0-ai/apis/px0-api/revisions/3ed72443989d?raw)