List the raw events of one turn of a session's trace, without deltas; small payloads are inlined.

GET

/v1/sessions/{session_id}/trace/turns/{turn}/events

const url = 'https://app.everruns.com/api/v1/sessions/example/trace/turns/example/events';
const options = {method: 'GET'};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://app.everruns.com/api/v1/sessions/example/trace/turns/example/events

Parameters

Path Parameters

session_id

required

string

Prefixed public identifier

turn

required

string

Prefixed public identifier

Query Parameters

after_sequence

integer format: int32

Only events after this sequence.

limit

integer format: int32

Events per page, 1 to 500. Defaults to 500.

Responses

200

Success

application/json

Events of a turn, for the lifecycle rows.

object

events

required

Events in sequence order.

Array<object>

An event in the session log.

object

data

Payload, when small enough to inline.

required

Event identifier.

string

sequence

required

Sequence in the session event log.

integer format: int32

size_bytes

required

Size of the serialized payload.

integer format: int32

required

When the event happened.

string format: date-time

type

required

Event type, such as tool.call_completed.

string

next_after_sequence

Sequence to continue after, when more remain.

integer | null format: int32

Example

{
  "events": [
    {
      "id": "event_01a124cd8a1b7f02a5c4e6d1b2f3a4c5",
      "sequence": 14,
      "size_bytes": 512,
      "type": "tool.started"
    }
  ],
  "next_after_sequence": 31
}