Sign in

v106

OpenAPI 3.1.0raw.githubusercontent.com2026-08-02160524464.6 KB
Human-in-the-Loop

Retrieve Run Sandbox Details

Returns provider-neutral details about the sandbox owned by this run, including identity, normalized state, image/snapshot, resources, labels, and timestamps.

get/api/v1/runs/{id}/sandbox

Path parameters

idstring required

Unique run identifier (ULID).

Response

Sandbox details

state'unknown' | 'provisioning' | 'starting' | 'running' | 'stopping' | 'stopped' | 'paused' | 'deleting' | 'deleted' | 'archived' | 'restoring' | 'resizing' | 'error' required

Normalized sandbox lifecycle state used by the control plane and UI. The original provider-specific state string is preserved in native_state.

native_statestring nullable

Original provider state string before normalization. Display/debugging only; UI behavior keys off state.

regionstring nullable

Provider region or target. Null for local-style providers.

web_urlstring nullable

Provider dashboard URL for this sandbox when available.

labelsobject required

Provider-reported labels.