跳转到主要内容
GET /api/v1/forward/sessions/{session_id}/events/stream 以 Server-Sent Events 形式实时返回 Session 事件；data payload 与历史查询使用相同的 Forward 字段过滤模型。

​
请求头

Header是否必填说明
Authorization是Bearer <PAT>
Accept是text/event-stream
Last-Event-ID否从该 Event ID 之后恢复订阅。

​
路径参数

参数类型是否必填说明
session_idstring是Session ID。

​
查询参数

参数类型是否必填默认值说明
typestring否-按 Event 类型过滤，支持逗号分隔。
types[]string否-数组形式的 Event 类型过滤。
include_tool_callsboolean否true是否包含工具调用类事件。
include_thinkingboolean否true是否包含思考过程事件。

​
示例请求

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

​
示例响应

HTTP 200 OK 
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"}

​
响应字段

字段类型说明
idstringSSE event ID，等于 Event ID。
eventstringEvent 类型。
dataobject过滤后的 Forward Event JSON；payload 字段遵循 List Session Events 中按 Event type 分发的字段矩阵。

​
错误

HTTPTypeCode触发条件
400invalid_request_errorinvalid_event_cursorLast-Event-ID 不属于当前 Session。
404not_found_errorsession_not_foundSession 不存在。
401authentication_errorauthentication_requiredPAT 无效或已过期。

​
注意事项

  • 增量流式由创建 Session 时的 incremental_streaming_enabled 控制，不能通过本接口临时开启。
  • 未知 Event 类型可用时会作为 envelope-only 事件转发。
  • include_thinking=false 会过滤 thinking 事件和可识别的 thinking delta。
  • include_tool_calls=false 会过滤工具调用事件和可识别的工具输入/输出 delta。

​
相关

创建 Session

列出 Session Events