one-shot debug summary

GET

/v1/sessions/{session_id}/events/summary

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

• Production API

Parameters

Path Parameters

session_id

required

string

Session ID (prefixed, e.g., sess_…)

Responses

200

Per-type counts and time span for the session

Media type application/json

Aggregate result of the events summary query — total count, per-type breakdown, and a few convenience rollups (turn count, failure count).

object

by_type

required

Per-type count, sorted by event_type asc.

Array<object>

One row of EventsSummaryResult.by_type — the per-event-type count produced by the events summary query.

object

count

required

Count of items matching the query.

integer format: int64

event_type

required

Event-type discriminator (e.g. turn.started, tool.completed).

string

error_count

required

Convenience: count of failure-shaped event types (turn.failed, tool.failed, *.error, subagent.failed).

integer format: int64

first_ts

Earliest event timestamp, if any.

string | null format: date-time

last_ts

Latest event timestamp, if any.

string | null format: date-time

total

required

Total event count across all types.

integer format: int64

turn_count

required

Convenience: count of turn.started events.

integer format: int64

Example ^generated

{
  "by_type": [
    {
      "count": 1,
      "event_type": "example"
    }
  ],
  "error_count": 1,
  "first_ts": "2026-04-15T12:00:00Z",
  "last_ts": "2026-04-15T12:00:00Z",
  "total": 1,
  "turn_count": 1
}

400

Invalid session ID

404

Session not found

500

Internal server error