---
search:
  tags:
    - Skills
    - DELETE
seo:
  description: >-
    Deletes a Skill. Send the base_revision you read, in the query string. The…
    Reference for the DELETE /context/skills/{slug} endpoint in the AdCrunch
    API.
sidebar:
  label: Delete a Skill
  badge: DELETE
title: Delete a Skill
type: openapi-operation
---
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.

`DELETE /context/skills/{slug}`

**Responses**

- `204` — Deleted. The row is soft-deleted, and the slug is free for re-use.
- `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\`.
