Skip to main content
GET
List runs for an agent (cursor-paginated)

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id
string<uuid>
required

Query Parameters

cursor
string

Opaque pagination cursor. Pass the nextCursor from the previous page to fetch the next one; omit for the first page.

limit
integer
default:50

Max objects to return per page. Default 50, max 100 (the rows endpoint allows up to 200 and documents its own limit).

Required range: 1 <= x <= 100

Response

A page of run summaries in the canonical list envelope.

The canonical v2 list envelope. Every list endpoint returns this shape; per-endpoint items element types (and documented extras like total) are declared on each operation.

object
string
required
Allowed value: "list"
items
object[]
required

The page of objects. Element type is per-endpoint.

nextCursor
string | null
required

Cursor for the next page; null means this is the last page.

url
string
required

The path this list was fetched from (query string excluded).