Sample - OpenAI API
POST/skills/{skill_id}/versions

Create a skill version

Creates a new immutable version of a skill by uploading its files. Supply the required files field as directory files or a single ZIP archive, and optionally set default to make the new version the skill's default. The response identifies the created version and the skill it belongs to.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

1 parameter · 2 body fields
skill_idstringrequired
The identifier of the skill for which you want to create an immutable version.

Skill version upload containing files and an optional default-version setting.

filesarray<string>required
Skill files for a directory upload, with a maximum of 500 files, or one ZIP file containing the new version.
defaultbooleanoptional
Whether to set this version as the default.

2 status codes
200Returns the created skill version with its object type, identifier, skill identifier, version number, creation timestamp, name, and description.
objectstringrequired
The object type, which is `skill.version`.
Allowed:skill.versionDefault:skill.version
idstringrequired
Unique identifier for the skill version.
skill_idstringrequired
Identifier of the skill for this version.
versionstringrequired
Version number for this skill.
created_atintegerrequired
Unix timestamp (seconds) for when the version was created.
namestringrequired
Name of the skill version.
descriptionstringrequired
Description of the skill version.
429Returned when the request is rejected because the rate limit has been exceeded.
errorobjectrequired

Error handling

The files field is required and must contain skill files or a single ZIP file; a directory upload may contain no more than 500 files. default controls whether the new version becomes the default, and a 429 is returned when the request exceeds the rate limit.