列出技能版本

VersionListPage Skills.Versions.List(parameters, cancellationToken = default)

GET/v1/skills/{skill_id}/versions

列出技能版本

Parameters

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 results to return per page.

Ranges from 1 to 1000. Defaults to 20.

minimum1

maximum1000

string? page

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

string workspaceID

Header param: Optional header to select the Workspace for this request. The value is a Workspace ID (for example, wrkspc_011CZkZaBF1tNoB5wlCeusgy).

Only needed for credentials that can act on more than one Workspace. A credential that belongs to a specific Workspace may omit it; if sent, it must match that Workspace.

Returns

class SkillVersion { Type = "skill_version"; ID; CreatedAt; /* 3 more */ }

JsonElement Type = "skill_version"

Object type.

For Skill Versions, this is always "skill_version".

required string ID

Unique identifier for this Skill Version. The id addresses the version in paths and pins it in references.

required DateTimeOffset CreatedAt

ISO 8601 timestamp of when the skill was created.

formatdate-time

required string Description

Description of the skill version.

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

required string Name

The Skill's immutable kebab-case slug, set at creation from the first upload's SKILL.md frontmatter name (or its enclosing directory). Every later upload must resolve to the same value. Also the top-level directory of the Skill's mounted files and the base name of a downloaded archive.

required string SkillID

Unique identifier for the skill.

The format and length of IDs may change over time.

列出技能版本

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

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

Response 200

{
  "data": [
    {
      "id": "id",
      "created_at": "2024-10-30T23:58:27.427722Z",
      "description": "description",
      "name": "name",
      "skill_id": "skill_01JAbcdefghijklmnopqrstuvw",
      "type": "skill_version"
    }
  ],
  "next_page": "next_page"
}

Returns Examples

Response 200

{
  "data": [
    {
      "id": "id",
      "created_at": "2024-10-30T23:58:27.427722Z",
      "description": "description",
      "name": "name",
      "skill_id": "skill_01JAbcdefghijklmnopqrstuvw",
      "type": "skill_version"
    }
  ],
  "next_page": "next_page"
}