Skip to content

List Skill Versions

VersionListPage skills().versions().list(, )

GET/skills/{skill_id}/versions

List Skill Versions

ParametersExpand Collapse

VersionListParams params

Optional<String> skillId

Optional<String> after

The skill version ID to start after.

Optional<Long> limit

Number of versions to retrieve.

minimum0

maximum100

Optional<Order> order

Sort order of results by version number.

ASC("asc")

DESC("desc")

ReturnsExpand Collapse

class SkillVersion:

String id

Unique identifier for the skill version.

long createdAt

Unix timestamp (seconds) for when the version was created.

String description

Description of the skill version.

String name

Name of the skill version.

JsonValue; object_

The object type, which is skill.version.

String skillId

Identifier of the skill for this version.

String version

Version number for this skill.

List Skill Versions

package com.openai.example;

import com.openai.client.OpenAIClient;
import com.openai.client.okhttp.OpenAIOkHttpClient;
import com.openai.models.skills.versions.VersionListPage;
import com.openai.models.skills.versions.VersionListParams;

public final class Main {
    private Main() {}

    public static void main(String[] args) {
        OpenAIClient client = OpenAIOkHttpClient.fromEnv();

        VersionListPage page = client.skills().versions().list("skill_123");
    }
}

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

Returns Examples

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