Sign in
Agents

Retrieve an agent session turn

Retrieves a turn's current status, timestamps, usage, and error. Returns 404 if the turn does not belong to the session. See session turns.

get/agents/sessions/{session_id}/turns/{turn_id}

Path parameters

session_idstring required

The ID of the session that owns the turn.

turn_idstring required

The ID of the turn.

Response

The requested turn.

idstring required

The ID of the turn.

object'agent.session.turn' required

The object type for a turn.

session_idstring required

The ID of the session that owns the turn.

agent_idstring required

The ID of the agent that ran the turn.

subagent_idstring nullable required

The ID of the subagent that ran the turn, if applicable.

status'queued' | 'in_progress' | 'waiting' | 'completed' | 'failed' | 'cancelled' required

The current status of a turn.

created_atinteger required

The Unix timestamp, in seconds, used to order the turn by creation time. Subagent turns use their start time, falling back to completion time or the subagent opening time when the preceding timestamps are unavailable.

started_atinteger nullable required

The Unix timestamp, in seconds, when the turn started.

completed_atinteger nullable required

The Unix timestamp, in seconds, when the turn reached a terminal state.

Changes

Changed in 5 of the 163 revisions of this API.32

  • 4b75527da17b1See the full diff
    • ●

      added the new flex_unavailable enum value to the ///// response property for the response status

      response-property-enum-value-added

  • d86203de41ae1See the full diff
    • ○

      added the non-success response with the status

      response-non-success-status-added

  • e0550bdbb5451See the full diff
    • ●

      added the new misalignment_policy_violation enum value to the ///// response property for the response status

      response-property-enum-value-added

  • 8c3c08961f621See the full diff
    • ●

      added the new credit_balance_exhausted enum value to the ///// response property for the response status

      response-property-enum-value-added

  • f2dae1a9aced1See the full diff
    • ○

      endpoint added

      endpoint-added