Vault 对象
创建、查询、列表和归档接口都会返回该结构。| 字段 | 类型 | 说明 |
|---|---|---|
id | string | Vault ID，前缀为 vault_ |
type | string | 固定值 "vault" |
display_name | string | Vault 展示名称，最长 255 字符 |
status | string | 可选值：active、archived |
metadata | object | Metadata 对象 |
credentials | Vault credential 数组 | 仅在创建 Vault 且同时创建 credential 的响应中返回 |
archived_at | string | 已归档时返回 |
created_at | string | 创建时间 |
updated_at | string | 最后更新时间 |
Vault credential
创建 credential、列表 credential、归档 credential，以及创建 Vault 的嵌套响应会返回该结构。| 字段 | 类型 | 说明 |
|---|---|---|
id | string | Credential ID，前缀为 vcred_ |
vault_id | string | 所属 Vault ID |
mcp_server_url | string | MCP server URL，最长 2048 字符 |
protocol | string | 支持值：streamable_http |
type | string | 支持值：static_bearer |
status | string | 可选值：active、archived |
archived_at | string | 已归档时返回 |
created_at | string | 创建时间 |
updated_at | string | 最后更新时间 |
access_token）只在创建请求中接收，永远不会在响应中返回。
创建 credential 请求
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
mcp_server_url | string | 是 | MCP server URL，最长 2048 字符 |
protocol | string | 是 | 使用 streamable_http |
type | string | 是 | 使用 static_bearer |
access_token | string | 是 | 安全存储在 Vault 中的 Bearer token |
相关
Vaults
安全地存储凭据并注入到 Agent Session。