v7

latestOpenAPI 3.0.0Apache 2.0raw.githubusercontent.com2026-01-26163065.1 KB

post/v1/sandboxes/{id}/clone

Path parameters

idstring required

Source sandbox ID

Source sandbox ID

Request body

namestring

Name for the cloned sandbox (auto-generated as {source-sandbox-name}-clone-{timestamp} if not provided)

snapshot_namestring

Custom name for intermediate snapshot (auto-generated if not provided)

imagestring

Docker image override

wait_for_readyboolean

Wait for sandbox to be ready

Example request

{
  "name": "my-cloned-sandbox",
  "snapshot_name": "clone-backup-1",
  "resources": {
    "cpus": 2,
    "memory": 1024
  }
}

Response

Sandbox cloned successfully

Example response

{
  "sandbox": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "name": "my-cloned-sandbox",
    "created_at": "2024-01-17T20:00:00Z",
    "cpu": 2,
    "memory": 1024,
    "storage": 10,
    "status": "creating"
  },
  "snapshot": {
    "id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
    "name": "clone-backup-1",
    "source_sandbox_id": "d4e5f6a7-b8c9-0123-def0-234567890123",
    "source_sandbox_name": "source-sandbox",
    "status": "ready",
    "created_at": "2024-01-17T19:59:50Z",
    "consistency": "application"
  }
}