---
title: "List Skill Collections"
method: GET
path: "/api/public/v2/skill-collections"
tags: ["skill-collections"]
---

# List Skill Collections

`GET /api/public/v2/skill-collections`

## Query parameters

- `created_by_email` string
- `created_after` string, date-time
- `created_before` string, date-time
- `updated_after` string, date-time
- `updated_before` string, date-time
- `external_source` string
- `external_id` string
- `sort_by` 'created_at' | 'updated_at' | 'name' | 'id'
- `sort_order` 'asc' | 'desc'

## Response `200`

List of skill collections.

- ListSkillCollectionsResponse
  - `success` true, required
  - `skill_collections` SkillCollection[], required
    - `id` string, uuid
    - `workspace_id` integer
    - `folder_id` integer, nullable
    - `root_path` string
    - `name` string
    - `provider` string, nullable
    - `is_deleted` boolean
    - `created_by` integer, nullable
    - `created_at` string, date-time
    - `updated_by` integer, nullable
    - `updated_at` string, date-time
    - `external_ids` ExternalId[] — External ID mappings attached to this skill collection.
      - `source` string, required — The external system or namespace that owns the ID.
      - `external_id` string, required — The identifier for this entity in the external system.

## Other responses

- `401` — Authentication failed.
- `403` — Invalid workspace_id.
- `422` — Validation error - request parameters or body are invalid.

---

[API](https://skmtc.dev/promptlayer/apis/promptlayer-api.md) · [All operations](https://skmtc.dev/promptlayer/apis/promptlayer-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/promptlayer/promptlayer-api/revisions/a23093a0a506/schema)