OpenAI API (unofficial showcase)
POST/skills

Create a skill

Creates a new skill from uploaded files or a ZIP archive. Include files with the skill contents, either as a directory upload or a single ZIP file. The response includes the created skill and its version identifiers.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

1 body field

Skill upload containing either directory files or a single ZIP archive.

filesarray<string>required
Skill files to upload as a directory or a single ZIP file. Directory uploads can contain at most 500 files.

4 status codes
200Returns the created skill object, including its identifier, name, description, creation timestamp, default version, and latest version.
idstringrequired
Unique identifier for the skill.
objectstringrequired
The object type, which is `skill`.
Allowed:skillDefault:skill
namestringrequired
Name of the skill.
descriptionstringrequired
Description of the skill.
created_atintegerrequired
Unix timestamp (seconds) for when the skill was created.
default_versionstringrequired
Default version for the skill.
latest_versionstringrequired
Latest version for the skill.
400Returned when the uploaded skill files or archive are invalid.
errorobjectrequired
429Returned when the request is rejected because a rate limit was exceeded.
errorobjectrequired
500Returned when the skill could not be saved.
errorobjectrequired

Error handling

A 400 is returned when the uploaded skill files or archive are invalid. A 429 is returned when the request exceeds the rate limit, and a 500 is returned if the skill cannot be saved. Include files in the request body; directory uploads can contain at most 500 files.