List Skill Versions

VersionListPageResponse Beta.Skills.Versions.List(, )

GET/v1/skills/{skill_id}/versions

List Skill Versions

ParametersExpand Collapse

VersionListParams parameters

required string skillID

Path param: Unique identifier for the skill.

The format and length of IDs may change over time.

Long? limit

Query param: Number of items to return per page.

Defaults to 20. Ranges from 1 to 1000.

string? page

Query param: Optionally set to the next_page token from the previous response.

IReadOnlyList<AnthropicBeta> betas

Header param: Optional header to specify the beta version(s) you want to use.

ReturnsExpand Collapse

class VersionListPageResponse:

required IReadOnlyList<VersionListResponse> Data

List of skill versions.

required string ID

Unique identifier for the skill version.

The format and length of IDs may change over time.

required string CreatedAt

ISO 8601 timestamp of when the skill version was created.

required string Description

Description of the skill version.

This is extracted from the SKILL.md file in the skill upload.

required string Directory

Directory name of the skill version.

This is the top-level directory name that was extracted from the uploaded files.

required string Name

Human-readable name of the skill version.

This is extracted from the SKILL.md file in the skill upload.

required string SkillID

Identifier for the skill that this version belongs to.

required string Type

Object type.

For Skill Versions, this is always "skill_version".

required string Version

Version identifier for the skill.

Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129").

required Boolean HasMore

Indicates if there are more results in the requested page direction.

required string? NextPage

Token to provide in as page in the subsequent request to retrieve the next page of data.

List Skill Versions

VersionListParams parameters = new() { SkillID = "skill_id" };

var page = await client.Beta.Skills.Versions.List(parameters);
await foreach (var item in page.Paginate())
{
    Console.WriteLine(item);
}

Response 200

{
  "data": [
    {
      "id": "skillver_01JAbcdefghijklmnopqrstuvw",
      "created_at": "2024-10-30T23:58:27.427722Z",
      "description": "A custom skill for doing something useful",
      "directory": "my-skill",
      "name": "my-skill",
      "skill_id": "skill_01JAbcdefghijklmnopqrstuvw",
      "type": "type",
      "version": "1759178010641129"
    }
  ],
  "has_more": true,
  "next_page": "page_MjAyNS0wNS0xNFQwMDowMDowMFo="
}

Returns Examples

Response 200

{
  "data": [
    {
      "id": "skillver_01JAbcdefghijklmnopqrstuvw",
      "created_at": "2024-10-30T23:58:27.427722Z",
      "description": "A custom skill for doing something useful",
      "directory": "my-skill",
      "name": "my-skill",
      "skill_id": "skill_01JAbcdefghijklmnopqrstuvw",
      "type": "type",
      "version": "1759178010641129"
    }
  ],
  "has_more": true,
  "next_page": "page_MjAyNS0wNS0xNFQwMDowMDowMFo="
}

VersionListParams parameters = new() { SkillID = "skill_id" }; var page = await client.Beta.Skills.Versions.List(parameters); await foreach (var item in page.Paginate()) { Console.WriteLine(item); }

{ "data": [ { "id": "skillver_01JAbcdefghijklmnopqrstuvw", "created_at": "2024-10-30T23:58:27.427722Z", "description": "A custom skill for doing something useful", "directory": "my-skill", "name": "my-skill", "skill_id": "skill_01JAbcdefghijklmnopqrstuvw", "type": "type", "version": "1759178010641129" } ], "has_more": true, "next_page": "page_MjAyNS0wNS0xNFQwMDowMDowMFo=" }