Home / Servers / OpenAI API / retrieve_agent_session_subagent_turn

Retrieve a subagent turn

An MCP tool from the OpenAI API server, hosted on mcp.hjlabs.in.

Retrieve a subagent turn Retrieves a turn belonging to this subagent. See subagent workflows. [GET /agents/sessions/{session_id}/subagents/{subagent_id}/turns/{turn_id}]

Name on the gateway: openai_api__retrieve_agent_session_subagent_turn · read-only.

Parameters

NameTypeDescription
session_id requiredstringThe ID of the session.
subagent_id requiredstringThe ID of the subagent in this session.
turn_id requiredstringThe ID of a turn belonging to this subagent.

How to call it

Through the Smart Gateway, any client can run it by name with call_tool, or let the gateway find it with search_tools:

call_tool arguments
{
  "name": "openai_api__retrieve_agent_session_subagent_turn",
  "arguments": {
    "session_id": "…",
    "subagent_id": "…",
    "turn_id": "…"
  }
}

Or connect the OpenAI API server directly, which lists 371 tools including this one:

Run in your terminal
claude mcp add --transport http hj-openai-api https://mcp.hjlabs.in/mcp/openai-api \
  --header "Authorization: Bearer YOUR_API_KEY"

Try asking

Use the retrieve a subagent turn tool with session_id set to ….

More from OpenAI API