POST
/skills/{skill_id}/versionsCreate a skill version
Creates a new immutable version of a skill from uploaded files or a ZIP archive. Include files with the version contents and optionally set default to make the new version the default. The response contains the created version details.
- IdempotentThe SDK sends
Idempotency-Key, so a retried request is only applied once.
skill_idstringrequired
The identifier of the skill to create a version for.
Skill version upload containing files or a ZIP archive, with an optional setting to make the version the default.
filesarray<string>required
Skill files to upload as a directory or a single ZIP file. Directory uploads can contain at most 500 files.
defaultbooleanoptional
Whether to set this version as the default.
200Returns the created skill version, including its identifier, associated skill, version number, creation timestamp, name, and description.
objectstringrequired
The object type, which is `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.
400Returned when the uploaded skill files or archive are invalid.
errorobjectrequired
404Returned when the skill is not found.
errorobjectrequired
429Returned when the request is rejected because a rate limit was exceeded.
errorobjectrequired
500Returned when the skill version could not be saved.
errorobjectrequired
Error handling
A 400 is returned when the uploaded skill files or archive are invalid. A 404 is returned when the skill identified by the skill_id path parameter is not found. A 429 is returned when the request exceeds the rate limit, and a 500 is returned if the version cannot be saved. Include files in the request body; directory uploads can contain at most 500 files.