---
title: "Delete Skill Version Route"
method: DELETE
path: "/skills/{id_or_slug}/versions/{version}"
---

# Delete Skill Version Route

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

## Request

- Base URL: `https://api.goodeye.dev/v1`
- URL: `https://api.goodeye.dev/v1/skills/{id_or_slug}/versions/{version}`
- Auth: none declared

Permanently and immediately erase a single non-current skill version.

This is permanent: the version row, all its attached files, and any
content that is no longer referenced by any surviving version or published
template version are removed from the live system at once. There is no
recovery path. Use ``POST /{id_or_slug}/archive`` if you want a reversible
alternative for the whole skill.

Encrypted backups age out within the platform's standard retention window
(up to three months), so the data is not instantly erased from all systems
everywhere, but it is no longer accessible through any product surface after
this call.

The current (live) version cannot be erased with this call. Use
``DELETE /{id_or_slug}`` to permanently remove the entire skill including
its current version.

Version numbers remain monotonic with a gap where the erased version was.
Surviving versions are not renumbered.

Owner only. Returns ``{skill_id, version, deleted: true}``.

## Path parameters

- `id_or_slug` string, required
- `version` integer, required

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/goodeye/apis/goodeye-api.md) · [All operations](https://skmtc.dev/goodeye/apis/goodeye-api/llms.txt) · [OpenAPI document](https://skmtc.dev/goodeye/apis/goodeye-api/revisions/547cb8bb6ede?raw)