OMomnistack-sh
Agents

Retrieve a session subagent

Changed on

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

get/agents/sessions/{session_id}/subagents/{subagent_id}

Request

  • Base URL
    https://api.openai.com/v1
  • URL
    https://api.openai.com/v1/agents/sessions/{session_id}/subagents/{subagent_id}
  • Auth
    HTTP bearer

Path parameters

session_idstring required

The ID of the session.

subagent_idstring required

The ID of the subagent in this session.

Response

The requested subagent.

idstring required

The ID of the subagent.

object'agent.session.subagent' required

The object type for a subagent.

session_idstring required

The ID of the session that owns the subagent.

namestring nullable required

The runner-assigned nickname, or null when unavailable.

parent_agent_idstring required

The ID of the agent that created this subagent.

status'active' | 'closed' required

The current status of a subagent.

opened_atinteger required

The Unix timestamp, in seconds, when the subagent was first opened. Resuming does not change it.

closed_atinteger nullable required

The Unix timestamp, in seconds, when the subagent was closed. Null while active, including after resume.

Changes