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
Theme

Suggested
Overview Models Agents Tools Audio & voice Production API reference

Create Skill Version

POST
/skills/{skill_id}/versions

Create a new immutable skill version.

Path Parameters
skill_id: string

The identifier of the skill to version.

Body Parameters
JSON
files: array of string or string

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

One of the following:
array of string

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

maxItems500
string

Skill zip file to upload.

default: optional boolean

Whether to set this version as the default.

Returns
SkillVersion object { 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" (default: "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

curl https://api.openai.com/v1/skills/$SKILL_ID/versions \
    -H 'Content-Type: application/json' \
    -H "Authorization: Bearer $OPENAI_API_KEY" \
    -d '{
          "files": [
            "string"
          ]
        }'
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"
}