API Reference

Skills

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Update the default version pointer for a skill.

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.

ParametersExpand Collapse

skill_id: String

default_version: String

The skill version number to set as default.

ReturnsExpand Collapse

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 the default version pointer for a skill.

Ruby

HTTP

Python

TypeScript

Go

Ruby

Java

CLI Tool

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"
}