ListAiSessionTurnsResponse
A session's turns, oldest first.
Shape
itemsarray of AiTurn
- The AiTurn schema
- attemptinteger · int32
- cost_microsinteger · int64The settled charge, fee included, in micro-dollars.
- started_atstring · date-time
- stateAiTurnStatereservedsentrespondedexecutingcompletedHow far a turn has got: its cost reserved, its request sent to the model, the model's response recorded, its tool calls running, or complete.
tool_callsarray of AiToolCall
- The AiToolCall schema
- call_nointeger · int32
- stateAiToolCallStateplannedstartedcompletedgated
- toolstring
- duration_msinteger · int32 or nulloptional
- outcomeAiToolOutcomeokerrorrefusedgatedhaltedor nulloptional
- request_idstring or nulloptionalThe request id its audit records carry.
- summarystring or nulloptional
- targetobject or nulloptionalThe address acted on, as the tool named it.
- turn_nointeger · int32
- cache_read_tokensinteger · int32 or nulloptional
- cache_write_tokensinteger · int32 or nulloptional
- ended_atstring · date-time or nulloptional
- input_tokensinteger · int32 or nulloptional
- latency_msinteger · int32 or nulloptional
- model_idstring or nulloptional
- output_tokensinteger · int32 or nulloptional
- providerstring or nulloptional
- reasoning_summarystring or nulloptionalThe provider's summarized reasoning. Absent for a turn that was pure tool calls — the model's raw reasoning is never shown, because no provider returns it.
- regionstring or nulloptional
- stop_reasonAiStopReasonend_turntool_usemax_tokensrefusalpause_turnerroror nulloptional
- next_tokenstring or nulloptional
Example
Synthesized example{
"items": [
{
"attempt": 4,
"cost_micros": 30,
"started_at": "2026-10-13T06:37:23Z",
"state": "reserved",
"tool_calls": [],
"turn_no": 85
}
],
"next_token": "next-token-cb68"
}
Graph
Used inside
No schema contains this one.
Contains
Used by
Sent by 0 operations
No operation takes it as a request body.
Returned by 1 operation