> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ns.rocks/llms.txt
> Use this file to discover all available pages before exploring further.

# Resume

> Restore hibernated paused state into a running machine.

Resume starts a new running machine from hibernated paused state. The resumed
machine gets a new 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 attached to a new running machine.
* The resumed machine receives fresh runtime routing and access state.
* Incompatible kernel, architecture, or runtime-host restores fail explicitly.

## Usage

<CodeGroup>
  ```python Python SDK theme={"theme":{"light":"one-light","dark":"one-dark-pro"}}
  from nullspace import Machine

  snapshot_id = "snap_..."
  resumed = Machine.resume(snapshot_id)
  try:
      print(resumed.files.read("/workspace/state.txt"))
  finally:
      resumed.kill()
  ```

  ```bash CLI theme={"theme":{"light":"one-light","dark":"one-dark-pro"}}
  nullspace machine resume snap_...
  ```

  ```bash HTTP API theme={"theme":{"light":"one-light","dark":"one-dark-pro"}}
  curl -fsS -X POST \
    -H "Authorization: Bearer ${NULLSPACE_API_KEY}" \
    "${NULLSPACE_API_URL}/v1/machines/${SNAPSHOT_ID}/resume"
  ```
</CodeGroup>

API reference: [resumeMachine](../api-reference)
(`POST /v1/machines/{snapshot_id}/resume`). Reusable snapshot API:
[Snapshots](../machines/snapshots).

Guide: [Monitor and snapshots](../guides/python-sdk/monitor-snapshots). Example:
[Examples](../examples).