---
title: "POST /v1/sandboxes/create"
method: POST
path: "/v1/sandboxes/create"
---

# POST /v1/sandboxes/create

`POST /v1/sandboxes/create`

## Request body

- CreateSandboxRequest
  - `image` string — Docker image name (e.g., avmcodes/avm-default-sandbox)
  - `name` string — Custom sandbox name (auto-generated as sandbox-{user_id}-{timestamp} if not provided)
  - `resources` object
    - `cpus` integer — Number of CPUs (minimum: 1, 1 CPU = 0.25 Kubernetes vCPU)
    - `memory` integer — Memory size in MiB
    - `storage` integer — Storage size in GB
  - `env_vars` object — Environment variables
  - `wait_for_ready` boolean — Wait for sandbox to be ready before returning

## Response `201`

Sandbox created

- object
  - `id` string, required — Sandbox ID
  - `name` string, required — Sandbox name
  - `created_at` string, required — Creation timestamp
  - `cpu` number, required — CPU count (API units, minimum 1)
  - `memory` number, required — Memory size in MiB
  - `disk_size` number, required — Disk size in GB
  - `status` string, required — Sandbox status
  - `storage` number, required — Storage size in GB

## Other responses

- `400` — Bad request
- `409` — Conflict - Sandbox name already exists
- `500` — Internal server error

## Changes

- **2026-01-26** `260daed67193` — 2 breaking, 2 warning, 14 info
  - the `resources/cpus` request property's min was increased to `1.00`
  - the `resources/cpus` request property type/format changed from `number`/`` to `integer`/``
  - removed the request property `volumes`
  - removed the optional property `allOf[#/components/schemas/Sandbox]/volumes` from the response with the `201` status
  - …14 more
- **2025-12-01** `1ab4d88d5e0d` — 5 info
  - the `cpus` request property default value changed from `2` to `0.25`
  - the `resources` request property default value changed from `{"cpus":2,"memory":512}` to `{"cpus":0.25,"memory":512}`
  - the `resources/cpus` request property's min was decreased from `1.00` to `0.10`
  - the `resources/cpus` request property type/format was generalized from `integer`/`` to `number`/``
  - …1 more

[Change history](https://skmtc.dev/avm-codes/apis/avm-sandbox-platform-api/changes/v1/sandboxes/create/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)