Pause Sandbox - Runtools.ai

curl -X POST https://api.runtools.ai/v1/sandboxes/sandbox-abc123/pause \
  -H "X-API-Key: $RUNTOOLS_API_KEY"

await sandbox.pause();

{
  "data": {
    "id": "sandbox-abc123",
    "status": "pausing"
  }
}

{
  "data": {
    "id": "sandbox-abc123",
    "status": "paused"
  }
}

POST

sandboxes

{id}

pause

curl -X POST https://api.runtools.ai/v1/sandboxes/sandbox-abc123/pause \
  -H "X-API-Key: $RUNTOOLS_API_KEY"

await sandbox.pause();

{
  "data": {
    "id": "sandbox-abc123",
    "status": "pausing"
  }
}

{
  "data": {
    "id": "sandbox-abc123",
    "status": "paused"
  }
}

Path Parameters

string

required

Sandbox ID.

string

Sandbox ID.

string

pausing for an accepted transition, or paused if the sandbox was already paused.

curl -X POST https://api.runtools.ai/v1/sandboxes/sandbox-abc123/pause \
  -H "X-API-Key: $RUNTOOLS_API_KEY"

await sandbox.pause();

{
  "data": {
    "id": "sandbox-abc123",
    "status": "pausing"
  }
}

{
  "data": {
    "id": "sandbox-abc123",
    "status": "paused"
  }
}

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.