OPopenai
Agents

List agent session items

Changed on

Lists items produced by the session's root agent, including its interactions with subagents. Each subagent has its own item history. See inspecting agent output.

get/agents/sessions/{session_id}/items

Request

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

Path parameters

session_idstring required

The ID of the 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

A page of session items.

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

  • 1c3e85fd629dRevision changes
    • breaking

      added to the / response property oneOf list for the response status

    • info

      added computer_use_call computer_use_approval_request computer_use_approval_request_result discriminator mapping keys to the / response property for the response status

  • f2dae1a9acedRevision changes
    • info

      endpoint added