Summarize a session's trace
PreviewSummarize a session’s trace: turn, step and error totals, a minimap of turn buckets, and the turns that failed.
/v1/sessions/{session_id}/traceSee authentication for credentials and permissions.
Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”Prefixed public identifier
Query Parameters
Section titled “Query Parameters”Minimap buckets wanted, 1 to 500. Defaults to 120.
Responses
200Success
Success
Session-wide trace summary and minimap.
object
Turns per minimap bucket.
Minimap buckets in turn order.
A range of turns on the minimap.
object
Summed turn durations.
Failed steps and turns in the bucket.
First turn in the bucket.
Steps across the bucket’s turns.
Last turn in the bucket.
Steps and turns that failed, across the session.
Turns with errors, newest first, at most 500.
Start of the first turn.
Prompt tokens across all model calls.
Latest start or end of any turn.
Completion tokens across all model calls.
Steps across all turns.
Turns in the session.
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}