REST API

Runs

Scenario and routine runs, reports and artifacts.

listRuns

GET /v1/runs

Run history

Parameter	In	Required	Type
`status`	query	no	`queued`, `binding`, `running`, `passed`, `failed`, `errored`, `cancelled`
`limit`	query	no	integer
`cursor`	query	no	string

MCP tools on this operation: list_runs.

POST /v1/runs

Start a scenario run on bound devices

Request body: application/json (RunRequest).

Field	Type	What it is
`scenario`	one of several shapes
`routineId`	string
`bindings`	object	Role name to device id (or to a list for many-users roles). Unbound roles are matched automatically.
`params`	object
`record`	boolean
`tags`	array of string

MCP tools on this operation: run_scenario.

GET /v1/runs/{runId}

Run status, per-role progress, failures

Parameter	In	Required	Type	What it is
`runId`	path	yes	string

MCP tools on this operation: get_run.

DELETE /v1/runs/{runId}

Cancel a running scenario

Parameter	In	Required	Type	What it is
`runId`	path	yes	string

GET /v1/runs/{runId}/report

Run report as HTML, JUnit XML, or JSON

Parameter	In	Required	Type	What it is
`runId`	path	yes	string
`format`	query	no	`html`, `junit`, `json`

MCP tools on this operation: get_report.

GET /v1/runs/{runId}/artifacts

Screenshots, videos, logs and trees produced by a run

Parameter	In	Required	Type	What it is
`runId`	path	yes	string