Skip to content
GitmoapAPIBeta
Schema

AiTurn

One model call within a session, and the tool calls it asked for.

Shape

  • 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

Example

Synthesized example
{
"attempt": 3,
"cost_micros": 81,
"started_at": "2026-10-15T21:59:05Z",
"state": "reserved",
"tool_calls": [
{
"call_no": 29,
"state": "planned",
"tool": "tool-6d5b"
}
],
"turn_no": 10,
"cache_read_tokens": 8,
"cache_write_tokens": 11,
"ended_at": "2026-10-13T19:56:20Z",
"input_tokens": 78,
"latency_ms": 28,
"model_id": "5ed4674a-9a00-49ec-8255-aa19cd4e7705",
"output_tokens": 34,
"provider": "provider-cf5e",
"reasoning_summary": "reasoning-summary-1dca",
"region": "region-fe13",
"stop_reason": "end_turn"
}

Graph

Used inside
Contains

Used by

Sent by 0 operations

No operation takes it as a request body.

Returned by 1 operation