Skip to main content
GET
Get a sandbox

Authorizations

Authorization
string
header
required

Personal access token (msb_pat_…) or session JWT - the credential an agent acts with on a user's behalf.

Path Parameters

slug
string
required

Organization slug

sandbox_id
string<uuid>
required

Sandbox ID

Response

Sandbox details

Sandbox details and resolved configuration.

created_at
string<date-time>
required
ephemeral
boolean
required
id
string<uuid>
required
name
string
required
org_id
string<uuid>
required
slug
string
required
status
enum<string>
required

Sandbox lifecycle status.

Available options:
created,
starting,
running,
temporarily_unavailable,
recovery_decision_required,
stopping,
stopped,
failed
automatic_recovery_ends_at
string<date-time> | null

When an explicit recovery choice becomes necessary.

last_failure_message
string | null

Human-readable reason for the last failure.

spec
null | object

Curated projection of the resolved spec; absent until resolved.

started_at
string<date-time> | null

Latest run's start time; null if the sandbox has never run.

status_reason
null | enum<string>

Scheduler condition while status is starting.

Available options:
scheduling,
insufficient_capacity
stopped_at
string<date-time> | null

Latest run's stop time; null while open or never run.

temporarily_unavailable_since
string<date-time> | null

When the current worker outage became user-visible.