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

Suggested
Overview Models Agents Tools Audio & voice Production API reference

Update Skill Default Version

client.skills.update(stringskillID, SkillUpdateParams { default_version } body, RequestOptionsoptions?): Skill { id, created_at, default_version, 4 more }
POST/skills/{skill_id}

Update the default version pointer for a skill.

ParametersExpand Collapse
skillID: string
body: SkillUpdateParams { default_version }
ReturnsExpand Collapse
Skill { 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.

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

Update Skill Default Version

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: process.env['OPENAI_API_KEY'], // This is the default and can be omitted
});

const skill = await client.skills.update('skill_123', { default_version: 'default_version' });

console.log(skill.id);
{
  "id": "id",
  "created_at": 0,
  "default_version": "default_version",
  "description": "description",
  "latest_version": "latest_version",
  "name": "name",
  "object": "skill"
}
Returns Examples
{
  "id": "id",
  "created_at": 0,
  "default_version": "default_version",
  "description": "description",
  "latest_version": "latest_version",
  "name": "name",
  "object": "skill"
}