API Reference

Skills

Versions

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Delete a skill version.

DELETE/skills/{skill_id}/versions/{version}

Delete a skill version.

Path ParametersExpand Collapse

skill_id: string

version: string

The skill version number.

ReturnsExpand Collapse

DeletedSkillVersion = object { id, deleted, object, version }

id: string

deleted: boolean

object: "skill.version.deleted"

version: string

The deleted skill version.

Delete a skill version.

HTTP

HTTP

TypeScript

Python

Java

Go

Ruby

curl https://api.openai.com/v1/skills/$SKILL_ID/versions/$VERSION \
    -X DELETE \
    -H "Authorization: Bearer $OPENAI_API_KEY"

200 example

{
  "id": "id",
  "deleted": true,
  "object": "skill.version.deleted",
  "version": "version"
}

Returns Examples

200 example

{
  "id": "id",
  "deleted": true,
  "object": "skill.version.deleted",
  "version": "version"
}