Stream session events

​

Headers

​

Path parameters

​

Query parameters

​

Example request

curl -s -X GET 'https://api.qoder.com/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/api/v1/forward/sessions/sess_xxx/events/stream' \
  -H "Authorization: Bearer $QODER_ACCESS_TOKEN" \
  -H "Accept: text/event-stream" \
  --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, replay starts from the first Event in the Session. No Events are missed, but already consumed Events are delivered again. Use the Event ID for idempotent processing.

​

Errors

​

Notes

• event_deltas[] is the recommended way to enable streaming; when this parameter is not provided, only standard public events are returned.
• 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