列出 Work

列出 self-hosted Environment 下的 work items。

GET /api/v1/cloud/environments/{environment_id}/work

列出 self_hosted Environment 下的 work items。结果使用游标分页，并按 ID 升序返回；该顺序等同于队列创建顺序。

​

路径参数

参数	类型	说明
environment_id	string	Environment ID，前缀为 env_

​

请求头

头部	必选	说明
Authorization	是	Bearer $QODER_PAT

​

查询参数

参数	类型	必选	默认值	说明
limit	integer	否	20	每页返回数量，范围 1-100；超过 100 返回 400 invalid_request_error
page	string	否	-	上一次响应 next_page 返回的游标
before_id	string	否	-	返回该 work item ID 之前的记录
after_id	string	否	-	返回该 work item ID 之后的记录

page、before_id 和 after_id 不能同时使用。完整分页规范详见 分页。

​

示例请求

curl -X GET "https://api.qoder.com/api/v1/cloud/environments/env_019e64e01a137caf953ac2ac7b42ec5c/work?limit=2" \
  -H "Authorization: Bearer $QODER_PAT"

​

示例响应

HTTP 200 OK

{
  "data": [
    {
      "id": "work_019f3be4fd2475d9a784bf2c739e1194",
      "type": "work",
      "environment_id": "env_019e64e01a137caf953ac2ac7b42ec5c",
      "data": {
        "type": "session",
        "id": "sess_019f3be3fa66750bb9a1fbcde85b5fe1"
      },
      "state": "queued",
      "created_at": "2026-07-01T08:15:01Z",
      "acknowledged_at": null,
      "started_at": null,
      "latest_heartbeat_at": null,
      "stop_requested_at": null,
      "stopped_at": null,
      "metadata": {
        "job": "daily-report"
      }
    }
  ],
  "first_id": "work_019f3be4fd2475d9a784bf2c739e1194",
  "last_id": "work_019f3be4fd2475d9a784bf2c739e1194",
  "has_more": false,
  "next_page": null
}

​

响应字段

字段	类型	说明
data	Work item 对象数组	当前页的 work items
first_id	string|null	当前页第一条记录的 ID
last_id	string|null	当前页最后一条记录的 ID
has_more	boolean	是否还有更多数据
next_page	string|null	下一页游标。has_more 为 true 时等于 last_id，否则为 null

​

错误码

HTTP	type	触发条件
400	invalid_request_error	limit 不是正整数
400	invalid_request_error	同时传入了 page、before_id、after_id 中的多个参数
400	invalid_request_error	Environment 不是 self_hosted
401	authentication_error	PAT 无效或过期
403	permission_error	无权限执行此操作
404	not_found_error	Environment 不存在

完整错误信封格式见 错误参考。

​

相关

云端环境

选择 Agent 运行的容器、网络与依赖。