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

List skill versions

Lists the immutable versions associated with a skill. Use limit, order, and after to control the number, ordering, and starting point of the returned versions. The response includes version records and pagination cursors.

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

4 parameters
skill_idstringrequired
The identifier of the skill whose versions you want to list.
limitintegeroptional
Number of skill versions to retrieve. Must be between 0 and 100 when provided.
orderstringoptional
Sort order by version number: `asc` or `desc`.
Allowed:ascdesc
afterstringoptional
Skill version ID after which the results should begin.

2 status codes
200Returns a list object containing skill version records in `data`, the `first_id` and `last_id` cursors, and a `has_more` flag.
objectstringrequired
The type of object returned, must be `list`.
Allowed:listDefault:list
dataarray<object>required
A list of items
first_idstringrequired
The ID of the first item in the list.
last_idstringrequired
The ID of the last item in the list.
has_morebooleanrequired
Whether there are more items available.
429Returned when the request is rejected because the rate limit has been exceeded.
errorobjectrequired

Error handling

A 429 is returned when the request exceeds the rate limit. skill_id must identify the skill, limit must be between 0 and 100, and order must be asc or desc when provided.