List Suite Runs

List one page of suite runs (test invocations), newest first. A suite run groups every test run dispatched by one Run All, batch, or resubmit call. Paginate by passing cursor from the previous response.

Authentication

AuthorizationBearer

Enter your API key with the Bearer prefix, e.g. ‘Bearer sk_…’.

Query parameters

agent_idstringOptional
Narrow the list to the suite runs of one agent.
cursorstringOptional

Opaque cursor from a prior response’s next_cursor.

limitintegerOptional1-200Defaults to 50

Page size. Defaults to 50; capped at 200.

Response

One page of suite runs.
next_cursorstring or null

Opaque keyset cursor for the next page. Pass back as the cursor request parameter. null when the caller has reached the end of the list (has_more is also false in that case).

has_moreboolean
True when more rows exist beyond this page.
suite_runslist of objects

Errors

400
Bad Request Error
401
Unauthorized Error