Skip to main content
GET
List retrieval agent runs

Notes

  • Returns the authenticated caller’s Retrieval Agent runs, newest first, as a list envelope: { "object": "list", "data": [ … ], "has_more": bool, "next_cursor": string | null }.
  • Each item is a trimmed RetrievalAgentRunSummary (run_id, status, created_at, completed_at, thread_id, usage) — fetch full detail via Poll a Retrieval Agent run.
  • Paginate with cursor (a prior response’s next_cursor) and limit (default 20, max 100).

Authorizations

X-API-Key
string
header
required

Query Parameters

cursor
string

Opaque pagination cursor from a previous response's next_cursor.

limit
integer

Max runs to return (default 20, max 100).

Required range: 1 <= x <= 100

Response

A page of the caller's retrieval agent runs, newest first.

List envelope for GET /v1/agent/retrieval/runs. The shape follows the OpenAI and Exa list convention.

data
RetrievalAgentRunSummary · object[]
required
object
string
default:list
Allowed value: "list"
has_more
boolean
default:false
next_cursor
string | null