---
title: "List Skills"
method: GET
path: "/v1/skills"
tags: ["Skills"]
---

# List Skills

`GET /v1/skills`

List skills for a collection with cursor pagination.

## Query parameters

- `collection` string, required
- `limit` integer
- `page` string, nullable

## Headers

- `anthropic-beta` string[], nullable

## Response `200`

Paginated list of skills.

- ListSkillsResponse — Paginated list response containing skill objects.
  - `data` SkillResponse[] — Skills page data.
    - `id` string, required — Unique skill identifier.
    - `created_at` string, date-time, required — Creation timestamp.
    - `display_title` string, required — Human display title.
    - `latest_version` string, nullable — Latest version token for this skill.
    - `source` 'custom' | 'anthropic' | 'zylon', required — Source of the skill.
    - `type` 'skill' — Object type.
    - `updated_at` string, date-time, required — Update timestamp.
    - `collection` string, required — Tenant identifier (org_id boundary).
    - `loading` 'eager' | 'lazy', required — Instruction loading strategy.
    - `readonly` boolean, required — Readonly flag.
  - `has_more` boolean, required — Whether there is a next page.
  - `next_page` string, nullable — Token for next page.

## Other responses

- `401` — Unauthorized
- `422` — Validation Error

---

[API](https://skmtc.net/zylon-ai/apis/private-gpt-api.md) · [All operations](https://skmtc.net/zylon-ai/apis/private-gpt-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zylon-ai/private-gpt-api/versions/594fa71dfb90/schema)