curl -X GET 'https://api.openai.com/v1/skills/skill_123/versions?limit=10&order=asc&after=skillver_123' \
  -H "Authorization: Bearer $OPENAI_API_KEY"

# GET /skills/{skill_id}/versions (OpenAI API)
Base URL: https://api.openai.com/v1
Auth: Authorization; OpenAI API key; required.
Last verified: 2026-10-20

> List Skill Versions

## Critical Gotchas
* The Responses API is the primary interface for new text and tool workflows; Chat Completions remains a separate compatibility API.
* Audio transcription uploads use multipart form data rather than a JSON request body.

## cURL
curl -X GET 'https://api.openai.com/v1/skills/skill_123/versions?limit=10&order=asc&after=skillver_123' \
  -H "Authorization: Bearer $OPENAI_API_KEY"

## Parameters
| Name | In | Type | Required | Description |
| :--- | :--- | :--- | :--- | :--- |
| skill_id | path | string | Yes | The identifier of the skill. |
| limit | query | integer | No | Number of versions to retrieve. |
| order | query | string | No | Sort order of results by version number. |
| after | query | string | No | The skill version ID to start after. |

## Response example
{"object":"list","data":[{}]}

---
Need an API key? Get one at https://platform.openai.com/api-keys

GET

GET /skills/{skill_id}/versions — OpenAI API

OpenAI API key (required); https://api.openai.com/v1

OpenAI API

List Skill Versions

Base URL: https://api.openai.com/v1
Auth: Authorization: Bearer <OPENAI_API_KEY>
Last verified: 2026-10-20 · upstream hash matched

Actions Try in browser→

Agents: curl -H "Accept: text/markdown" this URL
→ 223 tokens · Vary: Accept

Critical gotchas

The Responses API is the primary interface for new text and tool workflows; Chat Completions remains a separate compatibility API.

Audio transcription uploads use multipart form data rather than a JSON request body.

cURL

curl -X GET 'https://api.openai.com/v1/skills/skill_123/versions?limit=10&order=asc&after=skillver_123' \  -H "Authorization: Bearer $OPENAI_API_KEY"

Parameters

Name	In	Type	Required	Description
skill_id	path	string	Yes	The identifier of the skill.
limit	query	integer	No	Number of versions to retrieve.
order	query	string	No	Sort order of results by version number.
after	query	string	No	The skill version ID to start after.

Response 200 OK

{
  "object": "list",
  "data": [
    {
      "object": "skill.version",
      "id": "string",
      "skill_id": "string",
      "version": "string",
      "created_at": 0,
      "name": "string",
      "description": "string"
    }
  ],
  "first_id": "string",
  "last_id": "string",
  "has_more": true
}

Get a free OpenAI API key → sponsored

Affiliate link - we may earn a commission, at no extra cost to you.