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: rt_live_xxx"

{
  "data": {
    "id": "sandbox-abc123",
    "status": "paused",
    "pausedAt": "2025-01-21T10:30:00Z"
  }
}

​
Path Parameters

​
id
string
required
Sandbox ID

​
Response

​
id
string
Sandbox ID
​
status
string
New status: paused
​
pausedAt
string
ISO 8601 timestamp when paused
curl -X POST https://api.runtools.ai/v1/sandboxes/sandbox-abc123/pause \
  -H "X-API-Key: rt_live_xxx"

{
  "data": {
    "id": "sandbox-abc123",
    "status": "paused",
    "pausedAt": "2025-01-21T10:30:00Z"
  }
}

​
Notes

  • Pausing snapshots the entire VM state to disk
  • Billing stops while paused (storage costs still apply)
  • Resume restores in under 1 second
  • Running processes continue from where they left off