---
title: "POST /v1/sandboxes/{id}/clone"
method: POST
path: "/v1/sandboxes/{id}/clone"
---

# POST /v1/sandboxes/{id}/clone

`POST /v1/sandboxes/{id}/clone`

## Path parameters

- `id` string, required — Source sandbox ID

## Request body

- CloneSandboxRequest
  - `name` string — Name for the cloned sandbox (auto-generated as {source-sandbox-name}-clone-{timestamp} if not provided)
  - `snapshot_name` string — Custom name for intermediate snapshot (auto-generated if not provided)
  - `resources` object — Resource overrides for cloned sandbox (storage inherited from source)
    - `cpus` integer — Number of CPUs (minimum: 1)
    - `memory` integer — Memory size in MiB
  - `image` string — Docker image override
  - `wait_for_ready` boolean — Wait for sandbox to be ready

## Response `201`

Sandbox cloned successfully

- CloneSandboxResponse
  - `sandbox` ClonedSandbox, required
    - `id` string, required — Sandbox ID
    - `name` string, required — Sandbox name
    - `created_at` string, required — Creation timestamp
    - `cpu` number, required — CPU count (API units)
    - `memory` number, required — Memory size in MiB
    - `storage` number, required — Storage size in GB
    - `status` string, required — Sandbox status
  - `snapshot` IntermediateSnapshot, required
    - `id` string, required — Snapshot ID (Kubernetes UID)
    - `name` string, required — Snapshot name
    - `source_sandbox_id` string, required — Source sandbox ID
    - `source_sandbox_name` string, required — Source sandbox name
    - `status` 'creating' | 'ready' | 'error', required — Snapshot status
    - `created_at` string, required — Creation timestamp
    - `consistency` 'application' | 'crash', required — Snapshot consistency level

## Other responses

- `400` — Bad request - sandbox not running or has no storage
- `403` — Forbidden - Sandbox does not belong to user
- `404` — Sandbox not found
- `409` — Conflict - sandbox or snapshot name already exists
- `500` — Internal server error

## Changes

- **2026-01-26** `260daed67193` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/avm-codes/apis/avm-sandbox-platform-api/changes/v1/sandboxes/:id/clone/post.md)

---

[API](https://skmtc.dev/avm-codes/apis/avm-sandbox-platform-api.md) · [All operations](https://skmtc.dev/avm-codes/apis/avm-sandbox-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/avm-codes/avm-sandbox-platform-api/revisions/260daed67193/schema)