---
title: "POST /v2/namespaces/{namespace}/async?stainless_overload=startCopyFrom"
method: POST
path: "/v2/namespaces/{namespace}/async?stainless_overload=startCopyFrom"
---

# POST /v2/namespaces/{namespace}/async?stainless_overload=startCopyFrom

`POST /v2/namespaces/{namespace}/async?stainless_overload=startCopyFrom`

## Request

- Base URL: `https://{region}.turbopuffer.com`
- URL: `https://{region}.turbopuffer.com/v2/namespaces/{namespace}/async?stainless_overload=startCopyFrom`
- Auth: HTTP bearer

Start copying all documents from another namespace into this one. Returns an operation token without waiting for the copy to finish. Use the token to poll for progress and the result.

## Path parameters

- `namespace` string, required

## Request body

- CopyFromNamespaceRequest: Configuration for copying documents from another namespace.
  - `source_namespace` string, required: The namespace to copy documents from.
  - `source_api_key` string: (Optional) An API key for the organization containing the source namespace
  - `source_region` string: (Optional) The region of the source namespace.
  - `dest_encryption` union: The encryption configuration for a namespace.
    - object: Encrypt the namespace with a customer-managed encryption key (CMEK).
      - `mode` 'customer-managed', required
      - `key_name` string, required: The identifier of the CMEK key to use for encryption. For GCP, the fully-qualified resource name of the key. For AWS, the ARN of the key.
      - `encryption_context` object: The AWS KMS encryption context to send with every request that uses the key. Only supported on AWS, and must be enabled for your organization. Keys may not start with `tpuf:` or `aws:`.
    - object: Use the default server-side encryption (SSE).
      - `mode` 'default', required

## Response `202`

The copy was accepted for asynchronous execution.

- object: The response to a successful request to start a copy.
  - `token` string, required: The token identifying the copy operation.

## Other responses

- `default`: An error response.

## Changes

- **2026-10-28** `328394035cba`: 1 info
  - added the new optional request property `allOf[subschema #2]/dest_encryption/oneOf[subschema #1: customer-managed]/encryption_context`
- **2026-09-17** `ac76e8da9620`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/turbopuffer/apis/turbopuffer-api/changes/v2/namespaces/:namespace/async%3Fstainless_overload=startCopyFrom/post.md)

---

[API](https://skmtc.dev/turbopuffer/apis/turbopuffer-api.md) - [All operations](https://skmtc.dev/turbopuffer/apis/turbopuffer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/turbopuffer/apis/turbopuffer-api/revisions/1db3a23efec4?raw)