List run events

List stored Agent run events or replay them as server-sent events.

GET /agent/runs/{id}/events

cURL

List run 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"

200

{
  "object": "<string>",
  "data": [
    {
      "id": "<string>",
      "data": true,
      "createdAt": "2023-11-07T05:31:56Z"
    }
  ],
  "hasMore": true,
  "nextCursor": "<string>"
}

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

apiKeybearer

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

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.

Required string length: 1 - 200

Pattern: ^[A-Za-z0-9_.:-]+$

Example:

"agent_run_01j7x9v0m2n4p6q8r0s2t4v6w8"

Query Parameters

limit · integer · default: 20

Number of results per page

Required range: 1 <= x <= 100

cursor · string

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

Response

200

application/json

Agent run events

object · string · required

Allowed value: "list"

data · object[] · required

Show child attributes

hasMore · boolean · required

Whether there are more results

nextCursor · string | null · required