---
title: "Delete skill"
method: DELETE
path: "/api/skills/{skill_id}"
tags: ["Skills"]
---

# Delete skill

`DELETE /api/skills/{skill_id}`

Delete a skill the authenticated caller is allowed to manage. This operation permanently removes all versions of the skill.

## Path parameters

- `skill_id` string, required

## Response `204`

Skill deleted. No content.

## Other responses

- `400` — Invalid request (malformed JSON, invalid parameter values, unknown fields).
- `401` — Missing or invalid authentication token.
- `403` — Token valid but lacks permission for the requested operation.
- `404` — Resource not found.
- `408` — Backend did not respond within the timeout window.
- `429` — Rate limit exceeded. Includes Retry-After header.
- `500` — Unexpected server-side failure.
- `503` — Backend temporarily unavailable.

---

[API](https://skmtc.net/gleanwork/apis/glean-platform-api.md) · [All operations](https://skmtc.net/gleanwork/apis/glean-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gleanwork/glean-platform-api/versions/34ba85db4644/schema)