Agent
Cancel a run
Cancel a queued or running Agent run.
cURL
If the run is still active, it transitions to
cancelled immediately and terminates without returning any results. The run ends with status cancelled and stopReason: cancelled. You are billed for usage accrued before cancellation. If the run has already reached a terminal status (completed, failed, or cancelled), the endpoint returns the existing run unchanged.
Get your Exa API key
Create a key in the dashboard. New accounts start with free credits.
Authorizations
Pass your Exa API key in the x-api-key header. You can also authenticate with Authorization: Bearer .
Path Parameters
Agent run ID.
Required string length:
1 - 200Pattern:
^[A-Za-z0-9_.:-]+$Response
Agent run
Agent run ID. New run IDs are returned with the agent_run_ prefix.
Required string length:
1 - 200Pattern:
^[A-Za-z0-9_.:-]+$Allowed value:
"agent_run"Available options:
queued, running, completed, failed, cancelled Why the run stopped. null while the run is queued or running.
Available options:
schema_satisfied, budget_reached, time_limit_reached, stopped, error, cancelled When the run was created
Canonicalized request fields stored with the run.