---
title: "Start a sandbox"
method: POST
path: "/sandboxes/start"
tags: ["Sandboxes"]
---

# Start a sandbox

`POST /sandboxes/start`

## Request body

- union
  - object
  - ThundertypesSandboxStartRequest
    - `env` object
    - `lifetime` ThundertypesSandboxLifetime, required
      - `enforce_ttl` boolean
      - `max_grace_seconds` integer
      - `max_ttl_seconds` integer
    - `name` string — Name is an optional label. It must be free of any other live sandbox in the organization and defaults to the assigned ID. It never addresses a sandbox: requests are made by ID.
    - `network_policy` ThundertypesSandboxNetworkPolicy, required
      - `cidr_allowlist` string[]
      - `domain_allowlist` string[]
      - `internet_access` 'closed' | 'open' | 'restricted', required
    - `spec` ThundertypesSandboxResourceSpec, required
      - `cpu_count` integer, required
      - `gpu_count` integer
      - `gpu_type` 'A6000' | 'A100' | 'H100' | 'A6000' | 'A100' | 'H100'
      - `memory_gib` integer, required
      - `storage_gib` integer, required

## Response `202`

Accepted

- ThundertypesSandboxStartResponse
  - `id` string, required
  - `name` string, required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden

---

[API](https://skmtc.dev/thundercompute/apis/thunder-compute-api.md) · [All operations](https://skmtc.dev/thundercompute/apis/thunder-compute-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/thundercompute/thunder-compute-api/revisions/122382e24d26/schema)