Stream session events

​

Headers

​

Path parameters

​

Query parameters

​

Example request

curl -s -X GET 'https://api.qoder.com.cn/api/v1/forward/sessions/sess_xxx/events/stream' \
  -H "Authorization: Bearer $QODER_ACCESS_TOKEN" \
  -H "Accept: text/event-stream"

curl -s -G 'https://api.qoder.com.cn/api/v1/forward/sessions/sess_xxx/events/stream' \
  -H "Authorization: Bearer $QODER_ACCESS_TOKEN" \
  -H "Accept: text/event-stream" \
  -H "X-Qoder-Beta: thinking-event-stream-delta-2026-07-20" \
  --data-urlencode 'event_deltas[]=agent.message' \
  --data-urlencode 'event_deltas[]=agent.thinking'

​

Example response

id: evt_xxx
event: agent.message
data: {"id":"evt_xxx","type":"agent.message","session_id":"sess_xxx","content":[{"type":"text","text":"Here is the analysis result."}],"processed_at":"2026-06-22T11:00:03Z"}

​

Event delta streaming example

id: evt_xxx
event: event_start
data: {"id":"evt_xxx","type":"event_start","session_id":"sess_xxx","event":{"id":"evt_xxx","type":"agent.message"}}

id: evt_xxx
event: event_delta
data: {"id":"evt_xxx","type":"event_delta","session_id":"sess_xxx","event_id":"evt_xxx","delta":{"type":"content_delta","index":0,"content":{"type":"text","text":"Here"}}}

id: evt_xxx
event: span.model_request_end
data: {"id":"evt_xxx","type":"span.model_request_end","is_error":false,"model_request_start_id":"evt_yyy","model_usage":{"credits":0.42},"processed_at":"2026-06-22T11:00:01Z"}

​

Response fields

​

Connection interruptions and reconnection

• Continuously record the id of the last SSE frame received. This is the Event ID.
• After a disconnect, reconnect with that ID in the Last-Event-ID header to resume from the last received Event and avoid missing Events.
• If a reconnect request omits Last-Event-ID, delivery starts at the tail of the event stream at connection time. Only Events created after the connection is established are delivered; historical Events are not replayed. To retrieve Events created while disconnected, first query history through List Session Events, and then establish the SSE connection to continue streaming.
• Starting August 24, 2026, when a connection is established without Last-Event-ID, the server starts delivering from the tail of the event stream at connection time and does not replay historical Events. Recommended integration: retrieve historical Events through paginated List Events requests, receive real-time Events through SSE, reconnect with the last received Event ID in Last-Event-ID, and process Events idempotently by Event ID.

​

Errors

​

Notes

• event_deltas[] is the recommended way to enable streaming; when this parameter is not provided, only standard public events are returned.
• Incremental agent.thinking streaming is a Beta feature. Requests subscribing to it must include X-Qoder-Beta: thinking-event-stream-delta-2026-07-20; behavior may change during the Beta period.
• After each model call completes, the stream emits a span.model_request_end model usage event. model_usage.credits is the incremental usage for that call. Read usage.total_credits from Get Session for the cumulative Session usage; see Model usage events in the data structure documentation.
• Unknown Event types are forwarded as envelope-only events when available.
• include_thinking=false filters thinking events, legacy thinking deltas, and new stream agent.thinking event start signals and delta.content.type=thinking fragments.
• include_tool_calls=false filters tool-use events and legacy tool input/output deltas.

​

Related