AgentRuns
Retrieve Exa agent runs and their details, including status, query, effort, output, usage, and cost breakdown. Supports launching new agent runs via INSERT and removing stored agent runs via DELETE.
Columns
| Name | Type | ReadOnly | References | Description |
| Id [KEY] | String | True |
Unique identifier of the agent run. | |
| Status | String | True |
Current execution status of the agent run. The allowed values are queued, running, completed, failed, cancelled. | |
| StopReason | String | True |
Reason the agent run stopped. Null while the run is still in progress. The allowed values are schema_satisfied, budget_reached, stopped, error, cancelled. | |
| RequestQuery | String | False |
Natural-language question or instructions for the agent run. | |
| RequestSystemPrompt | String | False |
Additional instructions that guide generated output or agent behavior. | |
| RequestEffort | String | False |
Cost and reasoning preference for the agent run. The allowed values are minimal, low, medium, high, xhigh, auto, max. | |
| RequestPreviousRunId | String | False |
Agent run ID to chain with a previous run. | |
| RequestInput | String | False |
Input data records and exclusions passed to the agent run. | |
| RequestOutputSchema | String | False |
JSON Schema for validated structured output from the agent run. | |
| RequestMetadata | String | False |
Caller-provided key-value metadata for tracking. | |
| RequestDataSources | String | False |
Exa Connect data providers configured for the agent run. | |
| RequestBudget | String | False |
Optional spending limit for the agent run, specified as a JSON object with maxCostDollars. | |
| Output | String | True |
Output object containing the natural-language answer, structured output, and grounding citations produced by the agent run. | |
| CreatedAt | Datetime | True |
Date and time the agent run was created. | |
| CompletedAt | Datetime | True |
Date and time the agent run finished. Null while the run is still in progress. | |
| Usage | String | True |
Detailed usage breakdown object for the agent run. | |
| CostDollars | String | True |
Detailed cost breakdown object for the agent run. | |
| Object | String | True |
Type identifier for the agent run object. |