---
title: "Create a collection"
method: POST
path: "/api/v1/collections"
---

# Create a collection

`POST /api/v1/collections`

## Request

- Base URL: `https://api.vectorpanda.com`
- URL: `https://api.vectorpanda.com/api/v1/collections`
- Auth: HTTP bearer

## Request body

- object
  - `collection` string, required: Collection name (letters, numbers, underscores, hyphens)
  - `tier` 'hot' | 'warm' | 'paused'

## Response `201`

Collection created

- object
  - `status` string
  - `client_id` string
  - `collection` string

## Other responses

- `409`: Collection already exists

---

[API](https://skmtc.dev/vectorpanda/apis/vector-panda-api.md) · [All operations](https://skmtc.dev/vectorpanda/apis/vector-panda-api/llms.txt) · [OpenAPI document](https://skmtc.dev/vectorpanda/apis/vector-panda-api/revisions/f5fc74e883d4?raw)