Stream Session Thread Events

Stream Session Thread Events through the OMA API.

GET /v1/sessions/{session_id}/threads/{thread_id}/stream

Stream Session Thread Events

cURL

curl --request GET \
  --url http://localhost:38080/v1/sessions/{session_id}/threads/{thread_id}/stream \
  --header 'X-Api-Key: <api-key>'

200

{
  "type": "user.message",
  "id": "sevt_011CZkZGOp0iBcp4kaQSihUmy",
  "content": [
    {
      "type": "text",
      "text": "Where is my order #1234?"
    }
  ],
  "processed_at": "2026-03-15T10:00:00Z"
}

Every request requires ?beta=true.

The response uses text/event-stream. Reconnect after disconnects and treat event deltas as best-effort previews until the final event arrives.

Authorizations

omaApiKeyomaBearer

X-Api-Key · string · header · default: sk-ant-local-default · required

OMA workspace API key.

Headers

anthropic-version · string

anthropic-beta · string

Path Parameters

session_id · string · required

Path parameter session_id

thread_id · string · required

Path parameter thread_id

Query Parameters

beta · enum<boolean> · required

Selects the beta API contract for this endpoint. Must be true.

Available options: true

event_deltas[] · enum<string>[]

When set, this connection also receives streaming deltas (event_start, event_delta) while an event is being produced, before the event itself arrives. Deltas are best-effort; when the final event is produced it carries the complete content. A model request that ends early (an error or interrupt) produces no final event — its terminal span.model_request_end closes the preview. Accepts one or more event types to preview and may be repeated: agent.message streams content_delta fragments; agent.thinking is start-only — a signal that the agent has begun extended thinking, concluded by the agent.thinking event itself. Only previews of the requested event types are sent.

EventDeltaType enum

Available options: agent.message, agent.thinking

Response

200

application/json

Successful response (OK)

Option 1

Option 2

Option 3

Option 4

Option 5

Option 6

Option 7

Option 8

Option 9

Option 10

Option 11

Option 12

Option 13

Option 14

Option 15

Option 16

Option 17

Option 18

Option 19

Option 20

Option 21

Option 22

Option 23

Option 24

Option 25

Option 26

Option 27

Option 28

Option 29

Option 30

Option 31

Option 32

Option 33

Option 34

Option 35

Option 36

Option 37

A user message event in the session conversation.

type · enum<string> · required

Available options: user.message

Example:

"user.message"

id · string · required

Unique identifier for this event.

Example:

"sevt_011CZkZGOp0iBcp4kaQSihUmy"

content · object[] · required

Array of content blocks comprising the user message.

Regular text content.

Option 1

Option 2

Option 3

Option 4

Show child attributes

Example:

{
  "type": "text",
  "text": "Where is my order #1234?"
}

Example:

[
  {
    "type": "text",
    "text": "Where is my order #1234?"
  }
]

processed_at · string<date-time> | null

Timestamp when the agent finished processing this message.

Example:

"2026-03-15T10:00:00Z"