Skip to main content
POST /v1/agents/runtime Pass snapshot (name or ID) instead of template. The new sandbox is a new ID. It is not a resume of the original. Do not set template in the same request.
You can start many sandboxes from the same snapshot. Each one is independent: stop, files, and timeout on one child do not affect the others or the original sandbox.

Parameters

Use the same create body as Create Runtime (the sandbox create API), with these rules: Timeout, env vars, secrets, and network policies work the same as a template create.

Cold vs hot restore

Hot restore is typically ready in tens of milliseconds. Cold restore waits until the sandbox has booted (up to about 90 seconds).

Notes

  • The snapshot must be active. Deactivated snapshots cannot create new sandboxes.
  • The new sandbox starts in the snapshot’s region. If that region has no capacity, the request fails.
  • Deleting the snapshot later does not stop sandboxes that already started from it.