GET /v1/tracks/{skill_id}/versions

List Track Versions

#Path parameters

• skill_id: string

Unique identifier for the track.

The format and length of IDs may change over time.

#Query parameters

• limit: optional number

Number of results to return per page.

Ranges from 1 to 1000. Defaults to 20.

default: 20, minimum: 1, maximum: 1000

• page: optional string

Optionally set to the next_page token from the previous response.

#Headers

• "juglow-workspace-id": optional string

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

• data: array of SkillVersion

List of tracks.

• type: "skill_version"

Object type.

For Track Versions, this is always "skill_version".

default: skill_version

• id: string

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

• created_at: string

ISO 8601 timestamp of when the track was created.

format: date-time

• description: string

Description of the track version.

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

• name: string

The Track'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 Track's mounted files and the base name of a downloaded archive.

• skill_id: string

Unique identifier for the track.

The format and length of IDs may change over time.

• next_page: string or null

Token for fetching the next page of results.

If null, there are no more results available. Pass this value to the page parameter in the next request to get the next page.

#Example

curl https://haijun.my.id/v1/tracks/$SKILL_ID/versions \
    -H 'juglow-version: 2023-06-01' \
    -H "X-Api-Key: $JUGLOW_API_KEY"

#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"
}