更新凭据
重命名凭据或轮换其秘密设置。
字段按字段合并(见 UpdateVaultCredentialRequest):秘密值不能清空为空,凭据类型及其标识字段不可变更。刷新出现终态失败后,轮换 access_token 或 refresh_token 可恢复托管刷新。更新已归档的凭据返回 404。
请求头
本次请求使用的 API 版本,格式为 YYYY-MM-DD。发送 2026-09-01-beta 即使用本文档所述版本。/v1/files* 之外必传:未携带请求头将被拒绝并返回 400 invalid_request_error;在 /v1/files* 上缺省时选择兼容行为。所有端点对未知取值均返回 400 invalid_request_error。
平台当前支持的 API 版本。新的日期版本发布时加入;版本在公告的 Sunset 日期后移除。
2026-09-01-beta 请求体
轮换或重命名凭据的部分更新请求体。字段按字段合并:提供的值替换已存储的值,省略、null 或空值保留原值——秘密值无法通过更新清空。对于 environment_variable 凭据,networking 为整体替换、injection_location 按字段合并。对于 mcp_oauth,refresh 块按字段合并。认证类型及其标识字段(secret_name、mcp_server_url、token_endpoint、client_id)不可变。
响应
更新后的凭据,秘密值不返回。
凭据库(Vault)中存储的一条凭据。唯一键——mcp_oauth/static_bearer 为规范化后的 mcp_server_url,environment_variable 为 secret_name——在同一凭据库的活跃凭据中不可重复。