Create sandbox from a template

Creates a new sandbox pre-configured from a named template Served by the live controller (answers 401 unauthenticated) but absent from its published…

POST /api/v1/sandbox/create-from-template

cURL

curl --request POST \
  --url 'https://api.sandbox.stateset.app/api/v1/sandbox/create-from-template' \
  --header "Authorization: Bearer $STATESET_SANDBOX_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "template_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "timeout_seconds": 250,
  "env": {},
  "override_cpus": "string",
  "override_memory": "string"
}'

200

{
  "sandbox_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "session_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "status": "creating",
  "expires_at": "2026-08-31T14:22:05Z"
}

Creates a new sandbox pre-configured from a named template

Served by the live controller (answers 401 unauthenticated) but absent from its published /openapi.json — verified 2026-08-31.

Request body

CreateFromTemplateRequest

template_id · string · required

Identifier of the template to use

timeout_seconds · integer

Timeout in seconds (30-3600)

env · object

Environment variables to inject

override_cpus · string

Override template CPU limit (e.g., ‘2’, ‘500m’)

override_memory · string

Override template memory limit (e.g., ‘2Gi’, ‘512Mi’)

Response

CreateSandboxResponse

sandbox_id · string (uuid)

session_id · string

status · SandboxStatusEnum

expires_at · string (date-time)

Status codes

Code	Meaning
200	Sandbox created from template
400	—
401	—
404	—
500	—

cURL

curl --request POST \
  --url 'https://api.sandbox.stateset.app/api/v1/sandbox/create-from-template' \
  --header "Authorization: Bearer $STATESET_SANDBOX_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "template_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "timeout_seconds": 250,
  "env": {},
  "override_cpus": "string",
  "override_memory": "string"
}'

200

{
  "sandbox_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "session_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "status": "creating",
  "expires_at": "2026-08-31T14:22:05Z"
}