---
title: "Get a sandbox"
method: GET
path: "/sandboxes/{id}"
tags: ["Sandboxes"]
---

# Get a sandbox

`GET /sandboxes/{id}`

## Path parameters

- `id` string, required

## Response `200`

Sandbox detail

- SandboxEnvelope
  - `message` string, required
  - `data` Sandbox, required
    - `id` string, required
    - `name` string, required
    - `template` string, required
    - `status` 'starting' | 'ready' | 'pausing' | 'paused' | 'resuming' | 'failed' | 'destroyed', required
    - `region` union, required — Region. Currently the create and list endpoints serialize this as the raw region `_id` string; future work may align it with the `RegionSummary` shape used elsewhere.
      - RegionSummary
        - `id` string, required
        - `name` string, required
        - `country` string, required
        - `continent` string, nullable
        - `provider` string, required
        - `is_paid` boolean, required
      - string
    - `specs` SandboxSpecs, required
      - `cpu` integer — CPU shares in Nomad MHz units.
      - `memory` integer — Memory in MB.
      - `disk` integer — Ephemeral scratch disk in GB. Separate from persistent storage.
    - `team` string, nullable
    - `project_environment` string, nullable
    - `auto_destroy` boolean
    - `destroy_timeout` '30m' | '1h' | '3h' | '6h' | '12h' | '18h' | 'null', nullable
    - `one_shot` boolean
    - `block_outbound` boolean
    - `persistent` boolean
    - `persistent_disk_gb` integer, nullable
    - `paused_at` string, date-time, nullable
    - `from_snapshot` string, nullable
    - `snapshot_mode` 'manual' | 'automatic'
    - `snapshot_frequency` string, nullable
    - `created_at` string, date-time, required
    - `last_activity_at` string, date-time, required
    - `expires_at` string, date-time, required
    - `destroyed_at` string, date-time, nullable
    - `destroy_reason` 'user' | 'idle_ttl' | 'max_lifetime' | 'one_shot_stopped' | 'failed' | 'paused_too_long'

## Other responses

- `400` — Validation error / invalid state transition
- `404` — Sandbox or related resource not found (also returned when owned by another user)

---

[API](https://skmtc.dev/brimblehq/apis/brimble-sandbox-api.md) · [All operations](https://skmtc.dev/brimblehq/apis/brimble-sandbox-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/brimblehq/brimble-sandbox-api/revisions/9d08392d0981/schema)