Sample - OpenAI API
GET/agents/sessions/{session_id}/subagents/{subagent_id}/turns/{turn_id}

Retrieve a subagent turn

Retrieves a turn belonging to this subagent. See subagent workflows.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

3 parameters
session_idstringrequired
The ID of the session.
subagent_idstringrequired
The ID of the subagent in this session.
turn_idstringrequired
The ID of a turn belonging to this subagent.

8 status codes
200The requested subagent history.
idstringrequired
The ID of the turn.
objectstringrequired
The object type. Always `agent.session.turn`.
Allowed:agent.session.turnDefault:agent.session.turn
session_idstringrequired
The ID of the session that owns the turn.
agent_idstringrequired
The ID of the agent that ran the turn.
subagent_idstringrequired
The ID of the subagent that ran the turn, if applicable.
statusstringrequired
The current status of the turn.
Allowed:queuedin_progresswaitingcompletedfailedcancelled
created_atintegerrequired
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_atintegerrequired
The Unix timestamp, in seconds, when the turn started.
completed_atintegerrequired
The Unix timestamp, in seconds, when the turn reached a terminal state.
errorobjectrequired
A customer-safe error. Non-null only for a failed turn.
usageobjectrequired
Best-effort token usage for the turn, or null if unknown. Recorded usage may change.
400The request was invalid.
errorobjectrequired
The error returned by the API.
401Authentication or project context was missing.
errorobjectrequired
The error returned by the API.
403The API key lacks the required Responses permission.
errorobjectrequired
The error returned by the API.
404The requested session or event was not found.
errorobjectrequired
The error returned by the API.
409The request conflicted with the current session state.
errorobjectrequired
The error returned by the API.
500An internal error occurred.
errorobjectrequired
The error returned by the API.
503The service is temporarily unavailable.
errorobjectrequired
The error returned by the API.

Error handling

A 400 is returned: The request was invalid. A 401 is returned: Authentication or project context was missing. A 403 is returned: The API key lacks the required Responses permission. A 404 is returned: The requested session or event was not found. A 409 is returned: The request conflicted with the current session state. A 500 is returned: An internal error occurred. A 503 is returned: The service is temporarily unavailable.