Resume restores hibernated paused state back into the same machine ID while preserving compatible VM state from the paused snapshot. Reusable snapshots use Machine.create(snapshot_id=...) instead.

What state changes

  • Paused state becomes running again under the same machine ID.
  • Runtime routing and access leases are refreshed before the machine is ready.
  • Incompatible kernel, architecture, or runtime-host restores fail explicitly.

Usage

from nullspace import Machine

machine_id = "mch_..."
resumed = Machine.resume(machine_id)
try:
    print(resumed.files.read("/workspace/state.txt"))
finally:
    resumed.kill()
nullspace machine resume mch_...
curl -fsS -X POST \
  -H "Authorization: Bearer ${NULLSPACE_API_KEY}" \
  "${NULLSPACE_API_URL}/v1/machines/${MACHINE_ID}/resume"
API reference: resumeMachine (POST /v1/machines/{id}/resume). Reusable snapshot API: Snapshots. Guide: Monitor and snapshots. Example: Examples.