Skip to main content
GET
列出 Session

Authorizations

Authorization
string
header
required

标准的 HTTP Bearer 认证方式,在 API Keys 页面获取密钥。

Headers

zai-version
enum<string>
default:2026-05-26
required

Managed Agents API 协议版本,固定为 2026-05-26。

Available options:
2026-05-26
Example:

"2026-05-26"

zai-beta
string
default:managed-agents-2026-05-26
required

必须包含 managed-agents-2026-05-26;可与其他 beta 标识用逗号分隔。

Example:

"managed-agents-2026-05-26"

Query Parameters

beta
enum<string>

提供时必须为 true。

Available options:
true
agent_id
string

按 Agent ID 过滤。

agent_version
integer

配合 agent_id 过滤版本。

Required range: x >= 1
memory_store_id
string

按挂载的 Memory Store 过滤。

statuses[]
enum<string>[]

可重复传入的 Session 状态。

Available options:
idle,
running,
rescheduling,
terminated
created_at[gt]
string<date-time>

RFC 3339 创建时间边界。

created_at[gte]
string<date-time>

RFC 3339 创建时间边界。

created_at[lt]
string<date-time>

RFC 3339 创建时间边界。

created_at[lte]
string<date-time>

RFC 3339 创建时间边界。

include_archived
boolean
default:false

是否包含已归档 Session。

limit
integer
default:20

每页数量;大于 100 时服务端截断为 100。

Required range: x >= 1
order
enum<string>
default:desc

排序方向。

Available options:
asc,
desc
page
string

双向 opaque cursor。

Response

请求成功。

data
object[]
required
next_page
string | null
required
prev_page
string