查询 Thread 列表

分页列出 Forward Session 的 coordinator 和 child threads。

请求头

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

路径参数

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

查询参数

参数	类型	是否必填	默认值	说明
`limit`	integer	否	20	分页大小，最大 100。
`order`	string	否	asc	排序方向：`asc` 或 `desc`。
`before_id`	string	否	-	返回该 Thread ID 之前的记录。
`after_id`	string	否	-	返回该 Thread ID 之后的记录。
`statuses[]`	string	否	-	可重复传入的状态过滤。
`include_archived`	boolean	否	false	是否包含已归档 Thread。

示例请求

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

示例响应

HTTP 200 OK

{
  "data": [
    {
      "id": "sthr_xxx",
      "type": "session_thread",
      "session_id": "sess_xxx",
      "template_id": "tmpl_support",
      "name": "",
      "role": "coordinator",
      "status": "idle",
      "stop_reason": {
        "type": "end_turn"
      },
      "created_at": "2026-06-22T10:00:00Z",
      "updated_at": "2026-06-22T10:05:00Z"
    }
  ],
  "first_id": "sthr_xxx",
  "last_id": "sthr_xxx",
  "has_more": false
}

响应字段

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

错误

HTTP	Type	Code	触发条件
400	`invalid_request_error`	`invalid_pagination`	分页参数不合法。
404	`not_found_error`	`session_not_found`	Session 不存在。
401	`authentication_error`	`authentication_required`	PAT 无效或已过期。

备注

Thread 响应不暴露运行时私有的 agent ID 或原始 agent version。
仅当 Forward 能可靠映射时才返回 template_id。

​请求头

​路径参数

​查询参数

​示例请求

​示例响应

​响应字段

​错误

​备注

​相关

请求头

路径参数

查询参数

示例请求

示例响应

响应字段

错误

备注

相关