Get sandbox by ID
Authorizations
Path Parameters
Sandbox ID
Response
Sandbox details, including a runtime session token
Current sandbox lifecycle status. GPU sandboxes begin in provisioning with no runtime or token. Poll until active, or stop on a terminal status and inspect closeReason. macOS can report stopping while disk changes are saved.
provisioning, active, stopping, closed, close-error, error Region to run the session in. The asia-south region is only available on Enterprise and Select plans. Get in touch at https://calendly.com/shri-hyperbrowser/demo.
us, us-central, us-west, us-east, asia-south, europe-west Runtime API connection details. Null while a GPU sandbox is provisioning, or if it ended before acquiring a runtime. Wait for status active before using these URLs.
Runtime selected for this sandbox.
firecracker, gvisor-cpu, macos Persistent disk ID, present for macOS sandboxes. Reuse it after the disk is ready and detached.
Present for macOS. True when the sandbox is active and its runtime is ready for commands. If false, fetch the sandbox again and check status before retrying.
Start timestamp in epoch milliseconds, serialized as a number or numeric string. May be null.
End timestamp in epoch milliseconds, serialized as a number or numeric string. May be null.
Effective outbound network policy for a sandbox.
Dashboard URL for this sandbox.
Total runtime in milliseconds (0 while running).
Sandbox runtime session token (24h TTL). Send as Authorization: Bearer for runtime API calls. Null during GPU provisioning and when the sandbox is unavailable.
Allocated GPU product, present for GPU sandboxes. Corresponds to the gpu creation parameter.
Number of allocated GPUs, present for GPU sandboxes.
Capabilities reported for GPU and macOS sandboxes. Inspect these fields before using runtime-specific features. Fields depend on the runtime.