---
title: "Stream agent session events"
method: GET
path: "/agents/sessions/{session_id}/events"
tags: ["Agents"]
---

# Stream agent session events

`GET /agents/sessions/{session_id}/events`

## Request

- Base URL: `https://api.openai.com/v1`
- URL: `https://api.openai.com/v1/agents/sessions/{session_id}/events`
- Auth: HTTP bearer

Streams live events for an agent session. See [session events](https://developers.openai.com/api/docs/guides/agents-api/sessions/events).

## Path parameters

- `session_id` string, required

## Response `200`

A live stream of session events.

## Other responses

- `400`: The request was invalid.
- `401`: Authentication or project context was missing.
- `403`: The API key lacks the required permission.
- `404`: The requested session or event was not found.
- `409`: The request conflicted with the current session state.
- `500`: An internal error occurred.
- `503`: The service is temporarily unavailable.

## Changes

- **2026-10-29** `0a26f104d35f`: 5 info
  - added the optional property `oneOf[#/components/schemas/SessionEventAgentSessionCreated]/session/agent/experimental` to the response with the `200` status
  - added the optional property `oneOf[#/components/schemas/SessionEventAgentSessionFailed]/session/agent/experimental` to the response with the `200` status
  - added the optional property `oneOf[#/components/schemas/SessionEventAgentSessionIdle]/session/agent/experimental` to the response with the `200` status
  - added the optional property `oneOf[#/components/schemas/SessionEventAgentSessionInProgress]/session/agent/experimental` to the response with the `200` status
  - …1 more
- **2026-10-28** `81bec64c97ee`: 5 info
  - added the optional property `oneOf[#/components/schemas/SessionEventAgentSessionCreated]/session/agent/compaction` to the response with the `200` status
  - added the optional property `oneOf[#/components/schemas/SessionEventAgentSessionFailed]/session/agent/compaction` to the response with the `200` status
  - added the optional property `oneOf[#/components/schemas/SessionEventAgentSessionIdle]/session/agent/compaction` to the response with the `200` status
  - added the optional property `oneOf[#/components/schemas/SessionEventAgentSessionInProgress]/session/agent/compaction` to the response with the `200` status
  - …1 more
- …earlier changes not shown

[Operation history](https://skmtc.dev/omnistack-sh/apis/openai-api/changes/agents/sessions/:session_id/events/get.md)

---

[API](https://skmtc.dev/omnistack-sh/apis/openai-api.md) - [All operations](https://skmtc.dev/omnistack-sh/apis/openai-api/llms.txt) - [OpenAPI document](https://skmtc.dev/omnistack-sh/apis/openai-api/revisions/0a26f104d35f?raw)