---
title: "Copy Collection"
method: POST
path: "/v2/collections/{collection_name}/copy"
tags: ["collections"]
---

# Copy Collection

`POST /v2/collections/{collection_name}/copy`

Clone metadata, documents, and vectors under a new name. Instant regardless of size.

## Path parameters

- `collection_name` string, required

## Request body

- CollectionCopyRequest
  - `target_name` string, required — Name for the copy. Must be unique within the organization and environment. Same rules as creating a collection: 3-63 characters, alphanumeric start and end, letters, numbers, hyphens and underscores only.

## Response `200`

Successful Response

- CollectionCopyResponse
  - `success` boolean, required
  - `message` string, required
  - `source_collection` string, required — Name of the collection copied from.
  - `collection_name` string, required — Name of the new copy.
  - `database_id` string, required — ID of the new copy.
  - `documents_copied` integer, required — Number of documents cloned.
  - `namespaces_copied` integer, required — Number of Turbopuffer namespaces copied (text plus any media).

## Other responses

- `404` — Source collection not found
- `409` — target_name is already in use
- `422` — target_name is missing or fails the name rules

---

[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)