---
title: "Delete Skill"
method: DELETE
path: "/v1/skills/{skill_id}"
tags: ["anthropic_skills"]
---

# Delete Skill

`DELETE /v1/skills/{skill_id}`

Delete a skill by ID from Anthropic.

Requires `?beta=true` query parameter.

Note: Anthropic does not allow deleting skills with existing versions.

Model-based routing (for multi-account support):
- Pass model via header: `x-litellm-model: claude-account-1`
- Pass model via query: `?model=claude-account-1`
- Pass model via body: `{"model": "claude-account-1"}`

Example usage:
```bash
# Basic usage
curl -X DELETE "http://localhost:4000/v1/skills/skill_123?beta=true"       -H "Authorization: Bearer your-key"

# With model-based routing
curl -X DELETE "http://localhost:4000/v1/skills/skill_123?beta=true"       -H "Authorization: Bearer your-key"       -H "x-litellm-model: claude-account-1"
```

Returns: DeleteSkillResponse with type="skill_deleted"

## Path parameters

- `skill_id` string, required

## Query parameters

- `custom_llm_provider` string, nullable

## Response `200`

Successful Response

- DeleteSkillResponse — Response from deleting a skill
  - `id` string, required
  - `type` string

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/flock/apis/litellm-api.md) · [All operations](https://skmtc.net/flock/apis/litellm-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/flock/litellm-api/revisions/8fbaab4fc7c5/schema)