跳转到主要内容
GET /api/v1/forward/sessions 返回当前账号下的 Session 列表；归档 Session 默认不返回。

​
请求头

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

​
查询参数

参数类型是否必填默认值说明
identity_idsstring或array否-按一个或多个 Identity ID 过滤，支持逗号分隔。
template_idstring否-按 Forward Template ID 过滤。
source_typestring否-按 api、im 或 schedule 过滤。
created_at[gt]string否-创建时间严格大于该 RFC 3339 时间。
created_at[gte]string否-创建时间大于等于该 RFC 3339 时间。
created_at[lt]string否-创建时间严格小于该 RFC 3339 时间。
created_at[lte]string否-创建时间小于等于该 RFC 3339 时间。
updated_at[gt]string否-更新时间严格大于该 RFC 3339 时间。
updated_at[gte]string否-更新时间大于等于该 RFC 3339 时间。
updated_at[lt]string否-更新时间严格小于该 RFC 3339 时间。
updated_at[lte]string否-更新时间小于等于该 RFC 3339 时间。
limitinteger否20分页大小，最大 100。
after_idstring否-向后翻页游标。
before_idstring否-向前翻页游标。
orderstring否desc排序方向：desc 或 asc。
include_archivedboolean否false是否包含已归档 Session。

​
示例请求

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

​
示例响应

HTTP 200 OK 
{
  "data": [
    {
      "id": "sess_xxx",
      "type": "session",
      "identity_id": "idn_xxx",
      "template": {
        "id": "tmpl_support",
        "type": "template",
        "name": "Support assistant",
        "model": "ultimate",
        "version": 3
      },
      "source_type": "im",
      "status": "idle",
      "title": "Customer support session",
      "incremental_streaming_enabled": true,
      "metadata": {
        "source": "dingtalk"
      },
      "config": {
        "environment_variables": {
          "API_KEY": "sk-xxx"
        }
      },
      "stats": {
        "active_seconds": 30,
        "duration_seconds": 3600
      },
      "usage": {
        "credits": 12.5
      },
      "created_at": "2026-06-22T10:00:00Z",
      "updated_at": "2026-06-22T11:00:00Z"
    }
  ],
  "first_id": "sess_xxx",
  "last_id": "sess_xxx",
  "has_more": false
}

​
响应字段

字段类型说明
dataarray当前页的 Session 对象。
first_idstring | null当前页第一条记录 ID。
last_idstring | null当前页最后一条记录 ID。
has_moreboolean是否还有更多记录。

​
错误

HTTPTypeCode触发条件
400invalid_request_errorinvalid_time_range时间筛选范围不合法。
400invalid_request_errorinvalid_pagination分页参数不合法。
401authentication_errorauthentication_requiredPAT 无效或已过期。

​
注意事项

  • after_id 和 before_id 不能同时传入。
  • 当前设计不支持按 status 筛选。
  • Credits 模块未启用时可省略 usage.credits。

​
相关

创建 Session

获取 Session