Skip to main content
GET
列出工作行

请求头

kimi-api-version
enum<string>

本次请求使用的 API 版本,格式为 YYYY-MM-DD。发送 2026-09-01-beta 即使用本文档所述版本。/v1/files* 之外必传:未携带请求头将被拒绝并返回 400 invalid_request_error;在 /v1/files* 上缺省时选择兼容行为。所有端点对未知取值均返回 400 invalid_request_error。 平台当前支持的 API 版本。新的日期版本发布时加入;版本在公告的 Sunset 日期后移除。

可用选项:
2026-09-01-beta

路径参数

environment_id
string
必填

要列出工作行的环境。

查询参数

status
enum<string>

按生命周期状态筛选。省略时返回全部状态。 工作行(WorkItem)的生命周期状态:queued 覆盖未投递与已投递未确认(等待 ack 的投递仍属队列事务);ack 后进入 starting;首个心跳激活为 active;停止请求进入 stopping,worker 确认收尾后记为 completed。空闲 worker 可直接完成。历史 failed 和 cancelled 行仍可读取。

可用选项:
queued,
starting,
active,
stopping,
completed,
failed,
cancelled
page_size
integer<int32>
默认值:50

返回的条目数,1 到 1000(默认 50)。

必填范围: 1 <= x <= 1000
page_token
string

来自上一次响应 next_page_token 的不透明分页令牌。

响应

一页工作行,最新在前。

一页工作行,最新在前。

items
object[]
必填

本页中的工作行。

next_page_token
string

下一页的分页令牌。列表耗尽时缺省。