Skip to main content
POST
/
v1
/
sandboxes
/
{id}
/
pause
curl -X POST https://api.runtools.ai/v1/sandboxes/sandbox-abc123/pause \
  -H "X-API-Key: $RUNTOOLS_API_KEY"

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

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.

​
Path Parameters

​
id
string
required
Sandbox ID.

​
Response

​
id
string
Sandbox ID.
​
status
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"

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

​
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.