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

skills.update(skill_id, **kwargs) -> Skill { id, created_at, default_version, 4 more }
POST
/skills/{skill_id}

Update the default version pointer for a skill.

Parameters
skill_id: String
default_version: String

The skill version number to set as default.

Returns
class Skill { id, created_at, default_version, 4 more }
id: String

Unique identifier for the skill.

created_at: Integer

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

require "openai"

openai = OpenAI::Client.new(api_key: "My API Key")

skill = openai.skills.update("skill_123", default_version: "default_version")

puts(skill)
200 example
{
  "id": "id",
  "created_at": 0,
  "default_version": "default_version",
  "description": "description",
  "latest_version": "latest_version",
  "name": "name",
  "object": "skill"
}
Returns Examples
200 example
{
  "id": "id",
  "created_at": 0,
  "default_version": "default_version",
  "description": "description",
  "latest_version": "latest_version",
  "name": "name",
  "object": "skill"
}