Copy

查询 Forward Session 中某个 Thread 的事件历史。

请求头

Header	是否必填	说明
Authorization	是	`Bearer <PAT>`

路径参数

参数	类型	是否必填	说明
`session_id`	string	是	Session ID。
`thread_id`	string	是	Thread ID。

查询参数

参数	类型	是否必填	默认值	说明
`limit`	integer	否	20	分页大小，最大 100。
`after_id`	string	否	-	返回该 Event ID 之后的事件。
`before_id`	string	否	-	返回该 Event ID 之前的事件。
`order`	string	否	asc	排序方向：`asc` 或 `desc`。
`type`	string	否	-	按 Event 类型过滤，支持逗号分隔。
`types[]`	string	否	-	数组形式的 Event 类型过滤。
`include_tool_calls`	boolean	否	true	是否包含工具调用类事件。
`include_thinking`	boolean	否	true	是否包含思考过程事件。

示例请求

curl -s -X GET 'https://api.qoder.com.cn/api/v1/forward/sessions/sess_xxx/threads/sthr_child_xxx/events' \
  -H "Authorization: Bearer $QODER_PAT"

示例响应

HTTP 200 OK

{
  "data": [
    {
      "id": "evt_xxx",
      "type": "agent.message",
      "session_id": "sess_xxx",
      "session_thread_id": "sthr_child_xxx",
      "content": [
        {
          "type": "text",
          "text": "The child task is complete."
        }
      ],
      "processed_at": "2026-06-22T11:05:00Z"
    }
  ],
  "first_id": "evt_xxx",
  "last_id": "evt_xxx",
  "has_more": false
}

响应字段

字段	类型	说明
`data`	array	当前页的 Event 对象。
`first_id`	string\|null	当前页第一条 Event ID。
`last_id`	string\|null	当前页最后一条 Event ID。
`has_more`	boolean	是否还有更多记录。

Thread Event 字段

data[] 中的每一项都使用与 List Session Events 相同的过滤后 Forward Event 对象。Thread 相关事件在公开 payload 中包含 session_thread_id。完整的按 Event type 分发字段矩阵见 List Session Events。

错误

HTTP	Type	Code	触发条件
400	`invalid_request_error`	`invalid_event_cursor`	游标不属于当前 Thread。
400	`invalid_request_error`	`invalid_pagination`	分页参数不合法。
404	`not_found_error`	`session_not_found`	Session 不存在。
404	`not_found_error`	`thread_not_found`	Thread 不存在。
401	`authentication_error`	`authentication_required`	PAT 无效或已过期。

备注

Thread Event 响应使用与 Session Event 相同的稳定 payload 白名单。
Session 级 Event Stream 包含所有 Thread 的事件；本接口仅返回指定 Thread 的事件。

​请求头

​路径参数

​查询参数

​示例请求

​示例响应

​响应字段

​Thread Event 字段

​错误

​备注

​相关

请求头