Get Session Runs
Retrieve all runs (executions) for a specific session with optional timestamp filtering. Runs represent individual interactions or executions within a session. Response schema varies based on session type.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Session ID to get runs from
Query Parameters
Session type (agent, team, or workflow). If not provided, auto-detected from session data.
agent, team, workflow User ID to query runs from
Filter runs created after this Unix timestamp (epoch time in seconds)
Filter runs created before this Unix timestamp (epoch time in seconds)
Database ID to query runs from
Table to query runs from
Response
Session runs retrieved successfully
- RunSchema
- TeamRunSchema
- WorkflowRunSchema
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)