列出 Sessions - Qoder CN

获取当前账号下所有 Session 的列表，支持分页。 GET /api/v1/cloud/sessions

请求头

头部	必选	说明
`Authorization`	是	`Bearer`

查询参数

参数	类型	必选	说明
`limit`	integer	否	最大返回数量。默认 20，范围 1-100。超过 100 返回 `400 invalid_request_error`
`page`	string	否	上一次响应 `next_page` 返回的不透明游标
`order`	string	否	排序方向：`desc`（默认）或 `asc`
`include_archived`	boolean	否	是否包含已归档 Sessions
`statuses`	string 或 array	否	按 Session 生命周期状态过滤。允许值：`running`、`idle`、`rescheduling`、`terminated`。归档 Session 通过 `include_archived` 单独过滤
`agent_id`	string	否	按 Agent ID 过滤
`agent_version`	integer	否	按 Agent 版本过滤
`deployment_id`	string	否	按 Deployment ID 过滤
`memory_store_id`	string	否	筛选挂载了指定 Memory Store 的 Sessions
`created_at[gt]`	string	否	返回创建时间晚于该 RFC 3339 时间的 Sessions
`created_at[gte]`	string	否	返回创建时间不早于该 RFC 3339 时间的 Sessions
`created_at[lt]`	string	否	返回创建时间早于该 RFC 3339 时间的 Sessions
`created_at[lte]`	string	否	返回创建时间不晚于该 RFC 3339 时间的 Sessions

完整分页规范详见分页。

示例请求

curl -X GET "https://api.qoder.com.cn/api/v1/cloud/sessions?limit=3&include_archived=true" \
  -H "Authorization: Bearer $QODER_PAT"

示例响应

HTTP 200 OK

{
  "data": [
    {
      "id": "sess_019e3bb1e8c171fd9abbb1477ffb84cc",
      "type": "session",
      "agent": {
        "id": "agent_019e390add9f7bac9b6cc806db46fcbd",
        "type": "agent",
        "version": 2,
        "name": "doc-verification-agent",
        "description": "",
        "model": {"id": "ultimate", "effective_context_window": 200000},
        "system": "You are an expert software engineer.",
        "tools": [{"enabled_tools": ["Bash", "Read", "Write", "Edit", "Glob", "Grep"], "type": "agent_toolset_20260401"}],
        "skills": [],
        "mcp_servers": []
      },
      "environment_id": "env_019e2590d33f711fabf42f2857cecd8a",
      "title": "API-doc-verification-session",
      "status": "idle",
      "metadata": {},
      "resources": [],
      "vault_ids": [],
      "deployment_id": null,
      "outcome_evaluations": [],
      "stats": {"active_seconds": 0, "duration_seconds": 0},
      "environment_variables": {},
      "archived_at": null,
      "created_at": "2026-05-18T15:26:15.747298Z",
      "updated_at": "2026-05-18T15:26:15.747298Z"
    }
  ],
  "first_id": "sess_019e3bb1e8c171fd9abbb1477ffb84cc",
  "has_more": false,
  "last_id": "sess_019e3bb1e8c171fd9abbb1477ffb84cc",
  "next_page": null
}

响应字段

字段	类型	说明
`data`	array	Session 对象列表
`first_id`	string	当前页第一条记录的 ID
`last_id`	string	当前页最后一条记录的 ID
`has_more`	boolean	当前结果集之后还有更多页时为 `true`
`next_page`	string \| null	下一页的不透明游标，无更多结果时为 `null`

将响应中的 next_page 作为下一次请求的 page 参数实现翻页。

错误码

HTTP	type	触发条件
400	`invalid_request_error`	分页或过滤参数无效
401	`authentication_error`	PAT 无效或过期

完整错误信封说明详见错误参考。

​请求头

​查询参数

​示例请求

​示例响应

​响应字段

​错误码

请求头

查询参数

示例请求

示例响应

响应字段

错误码