List retrieval agent runs
Agents
List Retrieval Agent runs
List the caller’s Retrieval Agent runs, newest first
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’snext_cursor) andlimit(default 20, max 100).
Authorizations
Query Parameters
Opaque pagination cursor from a previous response's next_cursor.
Max runs to return (default 20, max 100).
Required range:
1 <= x <= 100Response
A page of the caller's retrieval agent runs, newest first.