API Reference

Skills

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Versions

Create a new immutable skill version.

$ openai skills:versions create

POST/skills/{skill_id}/versions

Delete a skill version.

$ openai skills:versions delete

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

List skill versions for a skill.

$ openai skills:versions list

GET/skills/{skill_id}/versions

Get a specific skill version.

$ openai skills:versions retrieve

GET/skills/{skill_id}/versions/{version}

ModelsExpand Collapse

deleted_skill_version: object { id, deleted, object, version }

skill_version: object { id, created_at, description, 4 more }

skill_version_list: object { data, first_id, has_more, 2 more }

VersionsContent

Download a skill version zip bundle.

$ openai skills:versions:content retrieve

GET/skills/{skill_id}/versions/{version}/content