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

Create Skill Version

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

Create a new immutable skill version.

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

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

formatunixtime
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

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