Agents

List subagent turns

Changed on

Lists all turns of this subagent, including turns after a resume. See subagent workflows.

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

Request

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

Path parameters

session_idstring required

The ID of the session.

subagent_idstring required

The ID of the subagent in this session.

Query parameters

limitinteger

The maximum number of resources to return, between 1 and 100. Defaults to 20.

order'asc' | 'desc'

The order in which paginated resources are returned.

The order in which resources are returned. Defaults to desc.

afterstring

Return resources after this resource ID in the selected order.

Response

The requested subagent history.

object'list' required

The object type, which is always list.

first_idstring nullable required

The ID of the first resource in data, or null if the page is empty.

last_idstring nullable required

The ID of the last resource in data, or null if the page is empty. Pass this as after with the same order and filters.

has_moreboolean required

Whether there are more resources to retrieve after this page.

Changes