Skip to main content
POST
更新 Credential

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"

Path Parameters

vaultId
string
required

vaultId 资源标识。

credentialId
string
required

credentialId 资源标识。

Body

application/json
display_name
string | null

替换显示名称;null 表示清为空字符串,省略时保持不变。

Required string length: 1 - 255
metadata
object | null

元数据补丁;整个字段为 null 时清空,省略时保持不变。

auth
mcp_oauth · object

轮换 secret 或可变认证参数;auth type、host、mcp_server_url、secret_name、token_endpoint、client_id 与 resource 均不可修改。

Response

请求成功。

type
enum<string>
required
Available options:
vault_credential
id
string
required
display_name
string
required
vault_id
string
required
metadata
object
required

客户端自定义元数据;省略时默认为空对象。最多 16 个键,键名长度不超过 64 字符,值必须是长度不超过 512 字符的字符串。

auth
mcp_oauth · object
required
created_at
string<date-time>
required

创建时间。

updated_at
string<date-time>
required

更新时间。

archived_at
string | null
required

归档时间。