Sign in

v1

latestOpenAPI 3.0.02026-07-17112116167.8 KB
Sandboxes

Create a sandbox in a workspace

Validates type / CPU / memory / idle_timeout / quota / budget. Returns 201 immediately with status="provisioning"; container starts asynchronously.

post/api/workspaces/{wid}/sandboxes

Path parameters

widstring required

Workspace id

Request body

cpuinteger

optional; millicores, e.g. 500 or 2000

idle_timeoutinteger

optional; seconds

memoryinteger

optional; bytes, e.g. 536870912 (512Mi)

metadataobject

optional; arbitrary key-value metadata

namestring required
typestring

optional; default "opencode"

Example request

{
  "name": "my-sandbox",
  "type": "opencode"
}

Response

Created

claudecode_urlstring
cpuinteger
created_atstring required
custom_urlstring
idstring required
idle_timeoutinteger
is_localboolean required
jupyter_urlstring
last_activity_atstring nullable
last_heartbeat_atstring
memoryinteger
metadataobject
namestring required
openclaw_urlstring
opencode_urlstring
paused_atstring nullable
short_idstring
statusstring required
typestring required
workspace_idstring required