Page history
Delete Skill Version
api/skills/versions/delete
History
api/skills/versions/delete Changed · +1 / -1 lines
from line 14
- `version: string` - Identifies the skill version: a version ID, or — where the endpoint accepts it — the literal `latest` for the skill's most recent version. + Identifies the skill version by its version ID. Requests carrying the `skills-2025-10-02` beta header address versions by their Unix epoch timestamp instead (e.g., "1759178010641129").
api/skills/versions/delete Changed · +9 / -14 lines
# Delete Skill Version ## Path parameters ## Returns ## Example ### Response (200) ## Delete Skill Version ### Path Parameters ### Returns ### Example #### Response
from line 1
---- -title: Delete Skill Version -url: https://platform.claude.com/docs/en/api/skills/versions/delete ---- +# Delete Skill Version -## Delete Skill Version +**DELETE** `/v1/skills/{skill_id}/versions/{version}` -**delete** `/v1/skills/{skill_id}/versions/{version}` - Delete Skill Version -### Path Parameters +## Path parameters - `skill_id: string`
from line 18
Requests carrying the `skills-2025-10-02` beta header address versions by their Unix epoch timestamp instead (e.g., "1759178010641129"). -### Returns +## Returns -- `DeletedSkillVersion object { id, type }` +- `DeletedSkillVersion object` - `id: string`
from line 33
For Skill Versions, this is always `"skill_version_deleted"`. - - `"skill_version_deleted"` + default: skill_version_deleted -### Example +## Example -```http +```bash curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions/$VERSION \ -X DELETE \ -H 'anthropic-version: 2023-06-01' \
from line 44
-H "X-Api-Key: $ANTHROPIC_API_KEY" ``` -#### Response +### Response (200) ```json {
api/skills/versions/delete New page · 59 lines, new page
## Delete Skill Version ### Path Parameters ### Returns ### Example #### Response
A whole new page. There's nothing to diff it against, so here is what it says.
---
title: Delete Skill Version
url: https://platform.claude.com/docs/en/api/skills/versions/delete
---
## Delete Skill Version
**delete** `/v1/skills/{skill_id}/versions/{version}`
Delete Skill Version
### Path Parameters
- `skill_id: string`
Unique identifier for the skill.
The format and length of IDs may change over time.
- `version: string`
Identifies the skill version: a version ID, or — where the endpoint accepts it — the literal `latest` for the skill's most recent version.
Requests carrying the `skills-2025-10-02` beta header address versions by their Unix epoch timestamp instead (e.g., "1759178010641129").
### Returns
- `DeletedSkillVersion object { id, type }`
- `id: string`
Unique identifier for this Skill Version. The id addresses the version in
paths and pins it in references.
- `type: "skill_version_deleted"`
Deleted object type.
For Skill Versions, this is always `"skill_version_deleted"`.
- `"skill_version_deleted"`
### Example
```http
curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions/$VERSION \
-X DELETE \
-H 'anthropic-version: 2023-06-01' \
-H "X-Api-Key: $ANTHROPIC_API_KEY"
```
#### Response
```json
{
"id": "id",
"type": "skill_version_deleted"
}
```