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

# Delete Skill Route

`DELETE /skills/{id_or_slug}`

## Request

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

Permanently and immediately erase a skill you own.

This is permanent: the skill, all its versions, all attached files, and
all access grants 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.

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.

Owner only. Works on both live and archived skills.

Returns ``{skill_id, name, deleted: true}``.

## Path parameters

- `id_or_slug` string, 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)