Skip to main content
GET
/
agent
/
runs
/
{id}
/
events
curl -s "https://api.exa.ai/agent/runs/agent_run_01j.../events?limit=20" \
  -H "x-api-key: $EXA_API_KEY" \
  -H "Exa-Beta: agent-2026-05-07"
{
  "object": "<string>",
  "data": [
    {
      "id": "<string>",
      "event": "agent_run.created",
      "data": true,
      "createdAt": "2023-11-07T05:31:56Z"
    }
  ],
  "hasMore": true,
  "nextCursor": "<string>"
}

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.
By default, this endpoint returns a paginated JSON list of stored events. Set Accept: text/event-stream to replay stored events as SSE. For JSON pagination, use cursor. For SSE replay, use Last-Event-ID.

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
​
Accept
enum<string>

Set to text/event-stream to receive server-sent events.

Available options:
application/json,
text/event-stream
​
Last-Event-ID
string

For SSE replay, return only events after this event ID.

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"

Query Parameters

​
limit
integer
default:20

Number of items to return. Defaults to 20.

Required range: 1 <= x <= 100
​
cursor
string

Cursor for pagination. Use the nextCursor value from the previous event list response.

Response

Agent run events

​
object
string
required
Allowed value: "list"
​
data
object[]
required
​
hasMore
boolean
required
​
nextCursor
string | null
required