GET /v1/tracks

List Tracks

#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

Pagination token for fetching a specific page of results.

Pass the value from a previous response's next_page field to get the next page of results.

• source: optional string

Filter tracks by source.

If provided, only tracks from the specified source will be returned:

• "custom": only return user-created tracks
• "juglow": only return Juglow-created tracks

#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 Track

List of tracks.

• type: "track"

Object type.

For Tracks, this is always "track".

default: track

• id: string

Unique identifier for the track.

The format and length of IDs may change over time.

• created_at: string

ISO 8601 timestamp of when the track was created.

format: date-time

• display_name: string

Human-readable, single-line label for the Track. Maximum 255 characters. Always set: derived from the SKILL.md frontmatter name when omitted at creation. Not unique.

• latest_version_id: string

ID of the newest Track Version — what latest references resolve to. Always set: a Track holds at least one version.

• source: SkillSource

Where the Track comes from.

Possible values:

• "custom": authored by the platform user; private to their workspace
• "juglow": published by Juglow; shared and read-only
• "juglow_example": Juglow-published sample Track
• "plugin": resolved from an installed plugin

• type: "custom" or "juglow" or "juglow_example" or "plugin"

Where the Track comes from.

Possible values:

• "custom": authored by the platform user; private to their workspace
• "juglow": published by Juglow; shared and read-only
• "juglow_example": Juglow-published sample Track
• "plugin": resolved from an installed plugin

• "custom"

• "juglow"

• "juglow_example"

• "plugin"

• updated_at: string

ISO 8601 timestamp of when the track was last updated.

format: date-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 \
    -H 'juglow-version: 2023-06-01' \
    -H "X-Api-Key: $JUGLOW_API_KEY"

#Response (200)

{
  "data": [
    {
      "id": "skill_01JAbcdefghijklmnopqrstuvw",
      "created_at": "2024-10-30T23:58:27.427722Z",
      "display_name": "display_name",
      "latest_version_id": "latest_version_id",
      "source": {
        "type": "custom"
      },
      "type": "track",
      "updated_at": "2024-10-30T23:58:27.427722Z"
    }
  ],
  "next_page": "next_page"
}