Skip to content
For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
Primary navigation
Theme

Update Skill Default Version

$ openai skills update
POST
/skills/{skill_id}

Update the default version pointer for a skill.

Update Skill Default Version

openai skills update \
  --api-key 'My API Key' \
  --skill-id skill_123 \
  --default-version default_version
200 — Example
{
  "id": "id",
  "created_at": 0,
  "default_version": "default_version",
  "description": "description",
  "latest_version": "latest_version",
  "name": "name",
  "object": "skill"
}
Parameters
--skill-id: string

The identifier of the skill.

--default-version: string

The skill version number to set as default.

Returns
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.

Returns Examples
200 — Example
{
  "id": "id",
  "created_at": 0,
  "default_version": "default_version",
  "description": "description",
  "latest_version": "latest_version",
  "name": "name",
  "object": "skill"
}