Sign in

v7

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

post/v1/sandboxes/create

Request body

imagestring

Docker image name (e.g., avmcodes/avm-default-sandbox)

namestring

Custom sandbox name (auto-generated as sandbox-{user_id}-{timestamp} if not provided)

env_varsobject

Environment variables

wait_for_readyboolean

Wait for sandbox to be ready before returning

Example request

{
  "image": "avmcodes/avm-default-sandbox",
  "name": "my-project",
  "resources": {
    "cpus": 1,
    "memory": 512,
    "storage": 10
  }
}

Response

Sandbox created

idstring required

Sandbox ID

namestring required

Sandbox name

created_atstring required

Creation timestamp

cpunumber required

CPU count (API units, minimum 1)

memorynumber required

Memory size in MiB

disk_sizenumber required

Disk size in GB

statusstring required

Sandbox status

storagenumber required

Storage size in GB

Example response

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "name": "my-project",
  "created_at": "2024-01-17T20:00:00Z",
  "cpu": 1,
  "memory": 512,
  "storage": 10,
  "status": "creating"
}