Skip to main content
GET
List runs

Updated 23 Oct 2026 15:20 · page e8b6cbb

Authorizations

Authorization
string
header
required

Mint a token from the portal at Settings → API tokens. Send it as Authorization: Bearer avb_... on every request. Query-string tokens are NOT accepted — the URL ends up in access logs.

Query Parameters

room_id
string<uuid>

Restrict results to one room.

kind
enum<string>

power or readiness. Both when omitted.

Available options:
power,
readiness
tag
string

Only runs for rooms with this room tag (its name, ignoring case). Tags are set on the Room tags page.

status
string

One or more statuses, comma-separated, e.g. failed or succeeded,failed.

since
string<date-time>

Runs scheduled at or after this time (RFC 3339).

until
string<date-time>

Runs scheduled before this time (RFC 3339).

limit
integer
default:100

Rows per page. Default 100, maximum 500.

Required range: 1 <= x <= 500
cursor
string

Opaque pagination cursor from a previous response's next_cursor. Omit on the first call. Treat this as an opaque string — its shape may change.

Response

Page of runs.

data
object[]
required
next_cursor
string | null
required

Pass this back as ?cursor= on the next call. null means this page is the last one.