Home / Servers / OpenAI API / list_agent_session_subagent_turn_items

List subagent turn items

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

List subagent turn items Lists items belonging to one turn of this subagent. See subagent workflows. [GET /agents/sessions/{session_id}/subagents/{subagent_id}/turns/{turn_id}/items]

Name on the gateway: openai_api__list_agent_session_subagent_turn_items · 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.
limitintegerThe maximum number of resources to return, between 1 and 100. Defaults to 20.
orderasc | descThe order in which resources are returned. Defaults to desc.
afterstringReturn resources after this resource ID in the selected order.

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__list_agent_session_subagent_turn_items",
  "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 list subagent turn items tool with session_id set to ….

More from OpenAI API