OpenAI API (unofficial showcase)
POST/skills/{skill_id}

Update a skill's default version

Updates the default version pointer for a skill. Provide default_version to select the version that should be the skill's default. The response contains the updated skill details.

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

1 parameter · 1 body field
skill_idstringrequired
The identifier of the skill to update.

Skill update containing the version to set as the default.

default_versionstringrequired
The skill version number to set as default.

4 status codes
200Returns the updated 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 requested version is invalid.
errorobjectrequired
404Returned when the skill or requested skill version is not found.
errorobjectrequired
429Returned when the request is rejected because a rate limit was exceeded.
errorobjectrequired

Error handling

A 400 is returned when the requested version is invalid. A 404 is returned when the skill or requested version is not found, and a 429 is returned when the request exceeds the rate limit. The skill_id path parameter must identify the skill, and the body must include default_version.