List run events

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

cURL

cURL

curl -X GET https://api.exa.ai/agent/runs/<id>/events \
  -H "x-api-key: $EXA_API_KEY"

200

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

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

Create a key in the dashboard. New accounts start with free credits.

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

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_.:-]+$

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