Skip to main content
Resume starts a new running sandbox from hibernated paused state. The resumed sandbox gets a new sandbox ID while preserving compatible VM state from the paused snapshot. Reusable snapshots use Sandbox.create(snapshot_id=...) instead.

​
What state changes

  • Paused state becomes attached to a new running sandbox.
  • The resumed sandbox receives fresh runtime routing and access state.
  • Incompatible kernel, architecture, or runtime-host restores fail explicitly.

​
Usage

from nullspace import Sandbox

snapshot_id = "snap_..."
resumed = Sandbox.resume(snapshot_id)
try:
    print(resumed.files.read("/workspace/state.txt"))
finally:
    resumed.kill()
API reference: resumeSandbox (POST /v1/sandboxes/{snapshot_id}/resume). Reusable snapshot API: Snapshots. Guide: Monitor and snapshots. Example: Examples.