Sample - OpenAI API
POST/skills

Create a skill

Creates a new skill by uploading its files as a directory or a single ZIP archive. Supply the required files field using multipart form data or the supported JSON upload representation. The response identifies the created skill and its default and latest versions.

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

1 body field

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

filesarray<string>required
Skill files for a directory upload, with a maximum of 500 files, or one ZIP file containing the skill.

2 status codes
200Returns the created skill object with 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.
429Returned when the request is rejected because the rate limit has been exceeded.
errorobjectrequired

Error handling

The files field is required and must contain either skill files or a single ZIP file. A 429 is returned when the request exceeds the rate limit, and a directory upload may contain no more than 500 files.