Get Run by ID
Retrieve a specific run by its ID from a session. Response schema varies based on the run type (agent run, team run, or workflow run).
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Session ID to get run from
Run ID to retrieve
Query Parameters
Session type (agent, team, or workflow). If not provided, the run type is inferred from the run's own fields.
agent, team, workflow User ID to query run from
Database ID to query run from
Table to query run from
Response
Run 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)