---
title: "Create Collection"
method: PUT
path: "/v2/collections/{collection_name}"
tags: ["collections"]
---

# Create Collection

`PUT /v2/collections/{collection_name}`

Create a collection by name. The request is idempotent for an existing collection.

## Path parameters

- `collection_name` string, required

## Request body

- CollectionCreateRequest
  - `description` string, nullable
  - `metadata` CollectionCreateRequestMetadata

## Response `201`

Successful Response

- CollectionResponse
  - `collection_id` string, required
  - `collection_name` string, required
  - `created_at` string, nullable
  - `description` string, nullable
  - `metadata` CollectionResponseMetadata
  - `organization_id` string, required

---

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