---
title: "Delete a skill version."
method: DELETE
path: "/skills/{skill_id}/versions/{version}"
tags: ["Skills"]
---

# Delete a skill version.

`DELETE /skills/{skill_id}/versions/{version}`

## Path parameters

- `skill_id` string, required
- `version` string, required — The skill version number.

## Response `200`

Success

- DeletedSkillVersionResource
  - `object` 'skill.version.deleted', required
  - `deleted` boolean, required
  - `id` string, required
  - `version` string, required — The deleted skill version.

## Other responses

- `429` — The request was rejected because a rate limit was exceeded.

## Changes

- **2026-08-14** `6ac2618eefd7` — 1 info
  - added the non-success response with the status `429`
- **2026-05-13** `74cbcf73838f` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/openai/apis/openapi/changes/skills/:skill_id/versions/:version/delete.md)

---

[API](https://skmtc.dev/openai/apis/openapi.md) · [All operations](https://skmtc.dev/openai/apis/openapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/openai/openapi/revisions/959ef977e135/schema)