API Reference

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Skills

Create a new skill.

$ openai skills create

POST/skills

List all skills for the current project.

$ openai skills list

GET/skills

Get a skill by its ID.

$ openai skills retrieve

GET/skills/{skill_id}

Update the default version pointer for a skill.

$ openai skills update

POST/skills/{skill_id}

Delete a skill by its ID.

$ openai skills delete

DELETE/skills/{skill_id}

ModelsExpand Collapse

deleted_skill: object { id, deleted, object }

id: string

deleted: boolean

object: "skill.deleted"

skill: object { id, created_at, default_version, 4 more }

id: string

Unique identifier for the skill.

created_at: number

Unix timestamp (seconds) for when the skill was created.

default_version: string

Default version for the skill.

description: string

Description of the skill.

latest_version: string

Latest version for the skill.

name: string

Name of the skill.

object: "skill"

The object type, which is skill.

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

data: array of Skill { id, created_at, default_version, 4 more }

A list of items

id: string

Unique identifier for the skill.

created_at: number

Unix timestamp (seconds) for when the skill was created.

default_version: string

Default version for the skill.

description: string

Description of the skill.

latest_version: string

Latest version for the skill.

name: string

Name of the skill.

object: "skill"

The object type, which is skill.

first_id: string

The ID of the first item in the list.

has_more: boolean

Whether there are more items available.

last_id: string

The ID of the last item in the list.

object: "list"

The type of object returned, must be list.

SkillsContent

Download a skill zip bundle by its ID.

$ openai skills:content retrieve

GET/skills/{skill_id}/content

SkillsVersions

Create a new immutable skill version.

$ openai skills:versions create

POST/skills/{skill_id}/versions

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}

Delete a skill version.

$ openai skills:versions delete

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

ModelsExpand Collapse

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

id: string

deleted: boolean

object: "skill.version.deleted"

version: string

The deleted skill version.

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

id: string

Unique identifier for the skill version.

created_at: number

Unix timestamp (seconds) for when the version was created.

description: string

Description of the skill version.

name: string

Name of the skill version.

object: "skill.version"

The object type, which is skill.version.

skill_id: string

Identifier of the skill for this version.

version: string

Version number for this skill.

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

data: array of SkillVersion { id, created_at, description, 4 more }

A list of items

id: string

Unique identifier for the skill version.

created_at: number

Unix timestamp (seconds) for when the version was created.

description: string

Description of the skill version.

name: string

Name of the skill version.

object: "skill.version"

The object type, which is skill.version.

skill_id: string

Identifier of the skill for this version.

version: string

Version number for this skill.

first_id: string

The ID of the first item in the list.

has_more: boolean

Whether there are more items available.

last_id: string

The ID of the last item in the list.

object: "list"

The type of object returned, must be list.

SkillsVersionsContent

Download a skill version zip bundle.

$ openai skills:versions:content retrieve

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