---
title: "Create Skill Collection"
method: POST
path: "/api/public/v2/skill-collections"
tags: ["skill-collections"]
---

# Create Skill Collection

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

## Request body

- CreateSkillCollectionRequest
  - `name` string, required
  - `folder_id` integer, nullable
  - `provider` string, nullable
  - `files` InitialFileUpdate[]
    - `path` string, required
    - `content` string
  - `commit_message` string, nullable
  - `external_ids` ExternalId[] — Identifiers from other systems.
    - `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.

## Response `201`

Skill collection created successfully.

- CreateSkillCollectionResponse
  - `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.
  - `external_ids` ExternalId[], required — External ID mappings for the 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

- `400` — Validation or business rule error.
- `401` — Authentication failed.
- `403` — Invalid workspace_id or plan limit reached.
- `409` — External ID conflict
- `415` — Unsupported content type.
- `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)