Sign in

v106

OpenAPI 3.1.0raw.githubusercontent.com2026-08-02160524464.6 KB
Sandboxes

Retrieve Sandbox

Retrieves a Fabro-managed sandbox by provider-native id by searching all configured sandbox providers.

get/api/v1/sandboxes/{id}

Path parameters

idstring required

Response

Sandbox found

provider'local' | 'docker' | 'daytona' required

Sandbox provider discriminator.

idstring required

Provider-native sandbox id.

display_namestring nullable

Provider display name when distinct from the native id.

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.

imagestring nullable

Provider image when surfaced by the sandbox provider.

snapshotstring nullable

Provider snapshot when surfaced by the sandbox provider.

regionstring nullable

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

web_urlstring nullable

Provider dashboard URL for this sandbox when available.

working_directorystring nullable

Provider-reported or Fabro-default working directory when available.

labelsobject required

Provider-reported labels.