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
  }
}