---
title: "Delete a Skill"
method: DELETE
path: "/context/skills/{slug}"
tags: ["Skills"]
---

# Delete a Skill

`DELETE /context/skills/{slug}`

## Request

- Base URL: `https://api.adcrunch.dev`
- URL: `https://api.adcrunch.dev/context/skills/{slug}`
- Auth: HTTP bearer

Deletes a Skill. Send the `base_revision` you read, in the query string. The answer is `409` with `error=revision_mismatch` if the Skill changed after you read it. The row is soft-deleted: the Skill leaves every listing and every read, and only an operator can bring it back.

## Path parameters

- `slug` string, required

## Query parameters

- `base_revision` integer, required: The revision last read via GET — guards concurrent edits.

## Response `204`

Deleted. The row is soft-deleted, and the slug is free for re-use.

## Other responses

- `400`: The request does not match the schema of this operation: a field is missing or has the wrong type, or the body is not valid JSON. `error` is `invalid_request`, and `issues` names each field. Nothing was changed.
- `401`: No API key, or one that does not resolve. See the security scheme. `error` is `unauthorized`.
- `402`: The organization has no active subscription. An owner subscribes at `paywallUrl`. `error` is `organization_unentitled`.
- `403`: The caller does not hold `skill:write`. `error` is `forbidden`.
- `404`: No Skill with that slug. `error` is `not_found`.
- `409`: The Skill moved since you read it. `error` is `revision_mismatch`.

---

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