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