更新凭据

POST /anthropic/v1/vaults/{vault_id}/credentials/{credential_id}◐ 部分支持

请求参数

vault_idstring必填
path: 保险库 ID（路径或查询参数）。
credential_idstring必填
path: 路径参数：凭据 ID。
vault_idstring必填
query: 保险库 ID（路径或查询参数）。
authobject可选
Updated authentication details for a credential.
▸ 展开子字段（8）
- typestring必填
  取值 environment_variable
- access_tokenstring可选
  Updated OAuth access token.
- expires_atstring可选
  A timestamp in RFC 3339 format
- refreshobject可选
  Parameters for updating OAuth refresh token configuration.
- tokenstring可选
  Updated static bearer token value.
- injection_locationobject可选
  Updated injection location.
- networkingobject可选
  Updated networking scope. Full replacement.
- secret_valuestring可选
  Updated secret value.
display_namestring可选
Updated human-readable name for the credential. 1-255 characters.
metadataobject可选
Metadata patch. Set a key to a string to upsert it, or to null to delete it. Omitted keys are preserved.

200

支持 environment_variable 与 static_bearer。environment_variable 的 networking 只支持 limited，传 unrestricted 返回 400；secret_name 只能使用大写字母、数字和下划线，且不能以数字开头；injection_location 的默认值与官方一致。static_bearer 的令牌只在 mcp_server_url 所在主机上可用。创建或更新 mcp_oauth 返回 501（not_implemented_error），不产生副作用，官方 SDK 不会重试；需要 OAuth 令牌时请使用 /vault/v1/authorizations 一键授权。每个库最多 20 个有效凭据。以 anthropic. 开头的 metadata 键由平台保留，不能写入。

错误按 Claude Managed Agents 格式返回，参见错误码

响应

HTTP 200

Successful response

application/json

名称	类型	说明
id	string	Unique identifier for the credential.
archived_at	null \| string	A timestamp in RFC 3339 format
auth	object	Authentication details for a credential.
auth.mcp_server_url	string	URL of the MCP server this credential authenticates against.
auth.type	string
auth.expires_at	null \| string	A timestamp in RFC 3339 format
auth.refresh	null \| object	OAuth refresh token configuration returned in credential responses.
auth.injection_location	object	Where in the outbound request the secret value is substituted.
auth.networking	object	Outbound hosts the secret value is substituted on.
auth.secret_name	string	Name of the environment variable.
created_at	string	A timestamp in RFC 3339 format
metadata	object	Arbitrary key-value metadata attached to the credential.
type	string
updated_at	string	A timestamp in RFC 3339 format
vault_id	string	Identifier of the vault this credential belongs to.
display_name	null \| string	Human-readable name for the credential.