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

查询参数

order
enum<string>

列表排序。默认为 updated_at_desc。 列出会话时使用的排序:updated_at_desc(默认)、updated_atcreated_at_desccreated_at

可用选项:
created_at,
created_at_desc,
updated_at,
updated_at_desc
agent_id
string

将列表限定为运行该智能体的会话。

agent_version
string

将列表限定为固定到该智能体版本的会话(按资源递增的数字版本号,例如 "2")。通常与 agent_id 组合使用。

statuses
enum<string>[]

将列表限定为这些生命周期状态。省略表示不过滤状态。

会话或线程的当前生命周期状态。

  • idle:未在执行。接受新输入。
  • running:正在执行一个轮次。
  • terminated:归档后的最终状态。
可用选项:
idle,
running,
terminated
include_archived
boolean

包含已归档的会话。省略时不包含。

page_size
integer<int32>
默认值:50

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

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

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

响应

一页会话,按请求的排序返回。列表项省略 resources

一页会话。列表项省略 resources 绑定。

items
object[]
必填

本页的会话。

next_page_token
string

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