List Agent Runs
List runs for an agent within a session, optionally filtered by status.
Useful for monitoring background runs and viewing run history.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Query Parameters
Session ID to list runs for
Filter by run status: PENDING, RUNNING, COMPLETED, PAUSED, CANCELLED, ERROR, or REGENERATED
Response
List of runs retrieved successfully
Unique identifier for the run
Parent run ID if this is a nested run
Agent ID that executed this run
User ID associated with the run
Run status (PENDING, RUNNING, COMPLETED, ERROR, etc.)
Input provided to the run
Output content from the run
Format of the response (text/json)
Reasoning content if reasoning was enabled
List of reasoning steps
Performance and usage metrics
Message history for the run
Tools used in the run
Events generated during the run
Run creation timestamp
References cited in the run
Citations from the model (e.g., from Gemini grounding/search)
Reasoning process messages
Session state at the end of the run
Images included in the run
Videos included in the run
Audio files included in the run
Files included in the run
Audio response if generated
Input media attachments
Followup suggestions generated after the run
If this run was forked from another run, the source run's ID
If this run was forked, the message index at which the source was truncated
If this run was created via session branch, the source session's ID
If this run was produced via regenerate=true, the source run's ID
Message index of the most recent mid-run checkpoint (checkpoint='tool-batch' runs)