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>",
  "createdAt": "2023-11-07T05:31:56Z",
  "completedAt": "2023-11-07T05:31:56Z",
  "request": {
    "query": "What are the most important AI infrastructure funding rounds announced this week?",
    "systemPrompt": "Prefer official sources and avoid duplicate results.",
    "input": {
      "data": [
        {}
      ],
      "exclusion": [
        {}
      ]
    },
    "outputSchema": {},
    "effort": "auto",
    "previousRunId": "agent_run_01j7x9v0m2n4p6q8r0s2t4v6w8",
    "metadata": {
      "slack_channel_id": "C123ABC",
      "slack_thread_id": "1745444400.123456",
      "user_id": "U123ABC"
    }
  },
  "output": {
    "text": "<string>",
    "structured": true,
    "grounding": [
      {
        "field": "structured.companies[0].sourceUrl",
        "citations": [
          {
            "url": "<string>",
            "title": "<string>"
          }
        ],
        "score": 0.5
      }
    ]
  },
  "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

Pass your Exa API key in the x-api-key header. You can also authenticate with Authorization: Bearer .

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.

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

When the run was created

​
completedAt
string<date-time>
required
​
request
object
required

Canonicalized request fields stored with the run.

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