Skip to main content
GET
Get a sandbox

Authorizations

Authorization
string
header
required

API token created in the Thunder console.

Path Parameters

id
string
required

Permanent API-assigned sandbox ID.

Pattern: ^sbx-[a-f0-9]{16}$

Response

Current sandbox state.

id
string
required
Example:

"sbx-0123456789abcdef"

name
string
required
Example:

"training-run"

status
enum<string>
required
Available options:
pending,
starting,
running,
stopping,
stopped,
failed
spec
object
required

GPU type and count must be supplied together. Supported types and ranges depend on the organization's sandbox configuration.

network_policy
object
required
lifetime
object
required
created_at
string<date-time>
required
expires_at
string<date-time>

Present only when a positive TTL is enforced.

ssh
object

Present only while the sandbox is running.

failure_code
string

Machine-readable reason, present only for failures.

failure
string

Human-readable reason, present only for failures.