API Reference

Skills

Versions

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Create Skill Version

skills.versions.create(skill_id, **kwargs) -> SkillVersion { id, created_at, description, 4 more }

POST/skills/{skill_id}/versions

Create Skill Version

ParametersExpand Collapse

skill_id: String

default: bool

Whether to set this version as the default.

files: Array[String] | String

Skill files to upload (directory upload) or a single zip file.

Accepts one of the following:

Array[String]

Skill files to upload (directory upload) or a single zip file.

String

Skill zip file to upload.

ReturnsExpand Collapse

class SkillVersion { id, created_at, description, 4 more }

id: String

Unique identifier for the skill version.

created_at: Integer

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.

Create Skill Version

Ruby

HTTP

TypeScript

Python

Java

Go

Ruby

require "openai"

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

skill_version = openai.skills.versions.create("skill_123")

puts(skill_version)

200 example

{
  "id": "id",
  "created_at": 0,
  "description": "description",
  "name": "name",
  "object": "skill.version",
  "skill_id": "skill_id",
  "version": "version"
}

Returns Examples

200 example

{
  "id": "id",
  "created_at": 0,
  "description": "description",
  "name": "name",
  "object": "skill.version",
  "skill_id": "skill_id",
  "version": "version"
}