Managed Agents - Vault

分页列出当前身份拥有的 Vault。Vault 用于集中管理 Session、Deployment 和 MCP 访问所需的凭据。

get/agent/managed/v1/vaults

Request

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

Query parameters

limitinteger

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

pagestring

opaque cursor。

include_archivedboolean

是否包含已归档 Vault。

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

Example response

{
  "data": [
    {
      "id": "vlt_01J..."
    }
  ]
}

Changes