Skip to main content
POST
Start a sandbox

Authorizations

Authorization
string
header
required

API token created in the Thunder console.

Body

application/json

Resources, lifetime, network policy, and environment.

spec
object
required

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

lifetime
object
required
network_policy
object
required
name
string

Optional display label. It must be unique among live sandboxes and requests address sandboxes by ID. It must be printable, omit leading or trailing whitespace and slashes, differ from . and .., and avoid surrounding double underscores.

Maximum string length: 64
env
object

Environment variables installed for SSH sessions.

Response

Startup accepted.

id
string
required

Permanent identifier for every later request.

Example:

"sbx-0123456789abcdef"

name
string
required

Display label, or the ID when no name was supplied.

Example:

"training-run"