---
title: "Get Skill Collection"
method: GET
path: "/api/public/v2/skill-collections/{identifier}"
tags: ["skill-collections"]
---

# Get Skill Collection

`GET /api/public/v2/skill-collections/{identifier}`

## Path parameters

- `identifier` string, required

## Query parameters

- `format` 'zip'
- `label` string
- `version` integer

## Response `200`

JSON payload or ZIP archive.

- GetSkillCollectionResponse
  - `success` true, required
  - `skill_collection` SkillCollection, required — A skill collection container in the public API.
    - `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.
  - `files` object, required
  - `version` SkillCollectionVersion, required — A saved version of a skill collection.
    - `id` string, uuid
    - `skill_collection_id` string, uuid
    - `workspace_id` integer
    - `number` integer
    - `root_path_at_version` string
    - `provider` string, nullable
    - `file_paths` string[]
    - `commit_message` string, nullable
    - `release_label` string, nullable
    - `archived` boolean
    - `created_by` integer, nullable
    - `user_email` string, nullable
    - `created_at` string, date-time

## Other responses

- `400` — Invalid query parameters.
- `401` — Unauthorized - missing or invalid API key.
- `403` — Forbidden - API key does not have access to the requested resource.
- `404` — Not found - requested resource does not exist or is not accessible.
- `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)