Skip to main content
POST
/
agent
/
runs
/
{id}
/
cancel
cURL
curl -s -X POST "https://api.exa.ai/agent/runs/agent_run_01j.../cancel" \
  -H "x-api-key: $EXA_API_KEY" \
  -H "Exa-Beta: agent-2026-05-07"
{
  "id": "agent_run_01j7x9v0m2n4p6q8r0s2t4v6w8",
  "object": "<string>",
  "status": "queued",
  "stopReason": "schema_satisfied",
  "createdAt": "2023-11-07T05:31:56Z",
  "completedAt": "2023-11-07T05:31:56Z",
  "request": {
    "query": "<string>",
    "systemPrompt": "<string>",
    "input": {
      "data": [
        {}
      ],
      "exclusion": [
        {}
      ]
    },
    "outputSchema": {},
    "effort": "auto",
    "previousRunId": "agent_run_01j7x9v0m2n4p6q8r0s2t4v6w8",
    "metadata": {}
  },
  "output": {
    "text": "<string>",
    "structured": true,
    "grounding": [
      {
        "field": "structured.companies[0].sourceUrl",
        "citations": [
          {
            "url": "<string>",
            "title": "<string>"
          }
        ],
        "score": 0.5,
        "confidence": "high"
      }
    ]
  },
  "usage": {
    "agentComputeUnits": 1,
    "searches": 1,
    "emails": 1,
    "phoneNumbers": 1
  },
  "costDollars": {
    "total": 1,
    "agentCompute": 1,
    "search": 1,
    "emails": 1,
    "phoneNumbers": 1
  }
}

Documentation Index

Fetch the complete documentation index at: https://exa.ai/docs/llms.txt

Use this file to discover all available pages before exploring further.

Exa Agent is in beta. It requires Exa-Beta: agent-2026-05-07 on every request.
If the run is still active, it transitions to cancelled. If the run has already completed, failed, or been cancelled, the endpoint returns the existing run.

Get your Exa API key

Authorizations

​
x-api-key
string
header
required

Your Exa API key.

Headers

​
Exa-Beta
enum<string>
required

Required beta token for the Agent.

Available options:
agent-2026-05-07

Path Parameters

​
id
string
required

Agent run ID. Agent run ID. New run IDs are returned with the agent_run_ prefix.

Required string length: 1 - 200
Pattern: ^[A-Za-z0-9_.:-]+$
Example:

"agent_run_01j7x9v0m2n4p6q8r0s2t4v6w8"

Response

Agent run

​
id
string
required

Agent run ID. New run IDs are returned with the agent_run_ prefix.

Required string length: 1 - 200
Pattern: ^[A-Za-z0-9_.:-]+$
Example:

"agent_run_01j7x9v0m2n4p6q8r0s2t4v6w8"

​
object
string
required
Allowed value: "agent_run"
​
status
enum<string>
required
Available options:
queued,
running,
completed,
failed,
cancelled
​
stopReason
enum<string> | null
required

Why the run stopped. null while the run is queued or running.

Available options:
schema_satisfied,
budget_reached,
error,
cancelled
​
createdAt
string<date-time>
required
​
completedAt
string<date-time> | null
required
​
request
object
required

Canonicalized request fields stored with the run.

​
output
object
required
​
usage
object
required
​
costDollars
object
required