Voxli Voxli

Runs

List runs

Retrieve a paginated list of all runs. Supports filtering by scenario, agent, personality, createdBy user, and runGroup IDs, by trigger via scheduled=true|false (scheduled vs manual runs), by demo=true|false (runs on the built-in demo agent vs every other agent), and by status via a comma-separated set (status=failed,canceled). For polling, changedSince=<ISO timestamp> returns what has changed since that moment: runs started after it, plus runs of any age that have not finished. Filters combine with AND.

GET /runs/

Authorization

HeaderTypeDescription
Authorizationrequired
string
Header with your API key as a Bearer token: Bearer <api-key>. See Authentication.

Query parameters

NameTypeDescription
page
integer
Page number
Default: 1
limit
integer
Items per page
Default: 10
sortBy
string
First-level field to sort by
sortOrder
string
Sort order: asc or desc
Default: "desc"
archived
boolean
When true, list only archived items; default lists only non-archived items. No-op for models without an isArchived field.
Default: false
output
enum<string>
Response shape: 'full' (default) returns complete documents; 'minimal' returns lean rows for list views, omitting heavy embedded fields while keeping linked display fields resolved.
Allowed values: full, minimalDefault: "full"

Response

  • 200Successful Response
PropertyTypeDescription
datarequired
object[]
idrequired
string
createdAt
string (date-time)
updatedAt
string (date-time)
statusrequired
enum<string>
Allowed values: new, pending, running, completed, failed, canceled
scenario
object
id
string
name
string
agent
object
id
string
name
string
personality
object
id
string
name
string
repetitions
integer
How many times each test runs
Default: 1
createdBy
object
Who started the run; empty for runs started by a schedule
id
string
name
string
runGroup
object
The launch this run was started in
id
string
scheduledRun
object
The schedule that started this run, if any
id
string
isArchived
boolean
Default: false
totalrequired
integer
pagerequired
integer
limitrequired
integer

Runs

Get run