Skip to main content
GET
/
sandboxes
/
{sandbox_id}
/
status
Get Sandbox Status
curl --request GET \
  --url https://api.declaw.ai/sandboxes/{sandbox_id}/status \
  --header 'X-API-Key: <api-key>'
{
  "is_running": true
}
Returns a single boolean is_running field. Use this endpoint for lightweight polling when you only need to know if the sandbox is alive, without fetching the full sandbox object. is_running is true only when the sandbox state is running. It is false for creating, paused, and killed states.

​
Path Parameters

​
sandbox_id
string
required
The sandbox identifier. Format: sbx-<8 chars>.

​
Response

​
is_running
boolean
true if the sandbox is in the running state, false otherwise.

​
Example

curl https://api.declaw.ai/sandboxes/sbx-a1b2c3d4/status \
  -H "X-API-Key: YOUR_API_KEY"
Response (running)
{
  "is_running": true
}
Response (paused or killed)
{
  "is_running": false
}

​
Error Responses

StatusCause
401Missing or invalid API key
404Sandbox not found