---
title: "Deletes a skill"
method: DELETE
path: "/api/v2/skills/{id}"
tags: ["Skills"]
---

# Deletes a skill

`DELETE /api/v2/skills/{id}`

## Request

- Base URL: `https://developer.productive.io` (the document declares no server; this is the origin it was published from)
- URL: `https://developer.productive.io/api/v2/skills/{id}`
- Auth: none declared

## Path parameters

- `id` string, required

## Response `204`

No Content

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `406`: Not Acceptable
- `408`: Request Timeout
- `423`: Locked
- `429`: Too Many Requests
- `500`: Internal Server Error

## Changes

- **2026-11-02** `fa3060fd0144`: 8 info
  - added the non-success response with the status `401`
  - added the non-success response with the status `403`
  - added the non-success response with the status `404`
  - added the non-success response with the status `406`
  - …4 more
- **2026-10-27** `f11a8740641a`: 1 warning
  - deleted the `header` request parameter `X-Organization-Id`
  - …this revision’s changelog is incomplete
- **2026-09-10** `474b9ec632d5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/productive/apis/api-documentation/changes/api/v2/skills/:id/delete.md)

---

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