Managed Agents - Deployment

列出 Deployment Run

Changed on

分页查询 Deployment 的运行记录,支持按任务、触发方式、时间和错误筛选。

<Accordion title="使用说明">

分页列出当前身份可读取的 Deployment Run,支持按 Deployment、是否有错误、触发方式和创建时间过滤。已归档 Deployment 的历史 Run 仍可查询;Run 是否成功通过 error 是否为 null 判断,响应中不包含 status 字段。

</Accordion>
get/agent/managed/v1/deployment_runs

Request

  • Base URL
    https://agent-api.bigmodel.cn/api
  • Auth
    HTTP bearer

Query parameters

deployment_idstring

按 Deployment ID 过滤。

has_errorboolean

按是否包含错误过滤。

trigger_type'schedule' | 'manual'

按触发方式过滤。

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 创建时间边界。

limitinteger

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

order'asc' | 'desc'

排序方向。

pagestring

opaque cursor。

Headers

zai-version'2026-05-26' required
Example:2026-05-26

Managed Agents API 入口要求的基础协议标识,当前只接受 2026-05-26;响应兼容形态由 zai-beta 选择。两个头均需携带。

zai-betastring required
Example:managed-agents-2026-09-22

声明 Managed Agents Beta 协议并选择响应字段与兼容行为。新接入使用 managed-agents-2026-09-22;旧客户端仍可使用 managed-agents-2026-05-26。必须同时携带 zai-version: 2026-05-26。字段差异见 /cn/managed-agents/protocol-versions。

Response

请求成功。

next_pagestring nullable required

Changes