Summarize a session's trace: turn, step and error totals, a minimap of turn buckets, and the turns that failed.
GET
/v1/sessions/{session_id}/trace
const url = 'https://app.everruns.com/api/v1/sessions/example/trace';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/traceParameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters”session_id
required
string
Prefixed public identifier
Query Parameters
Section titled “Query Parameters”buckets
integer format: int32
Minimap buckets wanted, 1 to 500. Defaults to 120.
Responses
Section titled “ Responses ”Success
Media typeapplication/json
Session-wide trace summary and minimap.
object
bucket_size
required
Turns per minimap bucket.
integer format: int32
buckets
required
Minimap buckets in turn order.
Array<object>
A range of turns on the minimap.
object
duration_ms
required
Summed turn durations.
integer format: int64
errors
required
Failed steps and turns in the bucket.
integer format: int64
from_turn
required
First turn in the bucket.
integer format: int32
steps
required
Steps across the bucket’s turns.
integer format: int64
to_turn
required
Last turn in the bucket.
integer format: int32
error_count
required
Steps and turns that failed, across the session.
integer format: int64
error_turns
required
Turns with errors, newest first, at most 500.
Array<integer>
first_started_at
Start of the first turn.
string | null format: date-time
input_tokens
required
Prompt tokens across all model calls.
integer format: int64
last_activity_at
Latest start or end of any turn.
string | null format: date-time
output_tokens
required
Completion tokens across all model calls.
integer format: int64
step_count
required
Steps across all turns.
integer format: int64
turn_count
required
Turns in the session.
integer format: int64
Example
{ "bucket_size": 10, "buckets": [ { "duration_ms": 421000, "errors": 2, "from_turn": 1, "steps": 142, "to_turn": 10 } ], "error_count": 27, "input_tokens": 4812330, "output_tokens": 91204, "step_count": 18311, "turn_count": 1240}