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.
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.