Skip to main content
GET
/
v1
/
sandboxes
curl "https://api.runtools.ai/v1/sandboxes?status=running&tag=ci&limit=50" \
  -H "X-API-Key: $RUNTOOLS_API_KEY"

{
  "data": [
    {
      "id": "sandbox-abc123",
      "name": "build-runner",
      "status": "running",
      "template": "base-ubuntu",
      "sshReady": true,
      "vncReady": false,
      "createdAt": "2026-05-06T10:00:00Z"
    }
  ],
  "meta": {
    "hasMore": false,
    "nextCursor": null
  }
}

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.

​
Query Parameters

​
status
string
Filter by status.
​
tag
string
Filter by tag. Repeat tag to match multiple tags.
​
template
string
Filter by template, such as base-ubuntu or desktop-ubuntu.
​
exclude_template
string
Exclude a template from results.
​
limit
number
default:"500"
Page size. The SDK caps page size to the public endpoint limit.
​
cursor
string
Cursor from the previous response.
​
all
boolean
Admin-only: include all organization sandboxes instead of only caller-visible rows.

​
Response

​
data
array
Sandbox summaries.
​
meta.hasMore
boolean
Whether another page is available.
​
meta.nextCursor
string
Cursor for the next page.
curl "https://api.runtools.ai/v1/sandboxes?status=running&tag=ci&limit=50" \
  -H "X-API-Key: $RUNTOOLS_API_KEY"

{
  "data": [
    {
      "id": "sandbox-abc123",
      "name": "build-runner",
      "status": "running",
      "template": "base-ubuntu",
      "sshReady": true,
      "vncReady": false,
      "createdAt": "2026-05-06T10:00:00Z"
    }
  ],
  "meta": {
    "hasMore": false,
    "nextCursor": null
  }
}