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

# Pause Sandbox

> Pause an existing sandbox

## Path Parameters

<ParamField path="id" type="string" required>
  Sandbox ID.
</ParamField>

## Response

<ResponseField name="id" type="string">
  Sandbox ID.
</ResponseField>

<ResponseField name="status" type="string">
  `pausing` for an accepted transition, or `paused` if the sandbox was already paused.
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST https://api.runtools.ai/v1/sandboxes/sandbox-abc123/pause \
    -H "X-API-Key: $RUNTOOLS_API_KEY"
  ```

  ```typescript SDK theme={null}
  await sandbox.pause();
  ```
</RequestExample>

<ResponseExample>
  ```json 202 Accepted theme={null}
  {
    "data": {
      "id": "sandbox-abc123",
      "status": "pausing"
    }
  }
  ```

  ```json 200 OK theme={null}
  {
    "data": {
      "id": "sandbox-abc123",
      "status": "paused"
    }
  }
  ```
</ResponseExample>

## Notes

* Pause/resume is the public lifecycle preservation flow.
* Named checkpoint, restore, and clone APIs are not publicly supported.
* Poll `GET /v1/sandboxes/{id}` or subscribe with the SDK to observe the final status.