Home / Servers / OpenAI API / retrieve_agent_session_turn
Retrieve an agent session turn
An MCP tool from the OpenAI API server, hosted on mcp.hjlabs.in.
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}]
Name on the gateway: openai_api__retrieve_agent_session_turn · read-only.
Parameters
| Name | Type | Description |
|---|---|---|
session_id required | string | The ID of the session that owns the turn. |
turn_id required | string | The ID of the turn. |
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:
{
"name": "openai_api__retrieve_agent_session_turn",
"arguments": {
"session_id": "…",
"turn_id": "…"
}
}Or connect the OpenAI API server directly, which lists 371 tools including this one:
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 an agent session turn tool with session_id set to ….