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

POST
/skills/{skill_id}/versions

Create a new immutable skill version.

Path Parameters
skill_id: string
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.

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: number

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

curl https://api.tpg-oai.studydeckedu.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"
}