更新凭证
本接口用于更新凭证（Credential）的显示名称、自定义键值和认证配置。
所有字段均可选，只需传入要修改的字段。传入 auth 时 auth.type 必须与原凭证一致，只能修改同类型下的字段；修改 auth.type 返回 400。更新成功后返回更新后的凭证对象。
更新不会重新探测 MCP 服务。auth.mcp_server_url、auth.secret_name、auth.refresh.client_id 创建后不可修改，传入与当前值不同的取值返回 400。
权限说明
使用 API Key 鉴权调用 API 流程，具体调用流程，请查看认证鉴权。
请求参数
凭证空间（Vault）标识。
凭证空间不存在时返回 404。
凭证（Credential）标识。
凭证不存在时返回 404。
显示名称。
自定义键值，按键合并。
传入的键覆盖原值，值为 null 的键删除，未传的键保留。
显示子属性
隐藏子属性
认证配置，结构同创建凭证接口。
auth.type 必填且必须与原凭证一致，修改时返回 400；其余字段只需传入要修改的部分。
显示子属性
隐藏子属性
认证类型。
可选值：mcp_oauth（MCP 服务的 OAuth 凭证）、static_bearer（固定 Bearer token）、environment_variable（以环境变量注入沙箱）。
MCP 服务地址，与智能体的 mcp_servers[].url 对应。选填，省略时保留当前值；创建后不可修改，传入不同值返回 400。
访问令牌。仅 auth.type 为 mcp_oauth 时使用；选填，省略时保留当前值。
访问令牌的过期时间，RFC 3339 格式。
仅 auth.type 为 mcp_oauth 时使用。
访问令牌的自动刷新配置。
显示子属性
隐藏子属性
OAuth 客户端标识。选填，省略时保留当前值；创建后不可修改，传入不同值返回 400。
刷新令牌。
令牌端点地址。
令牌端点的客户端认证配置。
显示子属性
隐藏子属性
客户端认证方式。
可选值：none（不带客户端认证）、client_secret_basic（通过 HTTP Basic 传 client secret）、client_secret_post（通过表单字段传 client secret）。
客户端密钥。
type 为 client_secret_basic、client_secret_post 时填写。
资源标识。
Bearer token。仅 auth.type 为 static_bearer 时使用；选填，省略时保留当前值。
环境变量名，建议使用大写字母、数字和下划线，且不以数字开头。仅 auth.type 为 environment_variable 时使用；选填，省略时保留当前值；创建后不可修改，传入不同值返回 400。
环境变量值。仅 auth.type 为 environment_variable 时使用；选填，省略时保留当前值。
当前仅保存，不影响运行；运行时按环境变量注入，不区分 body、header。仅 auth.type 为 environment_variable 时使用；省略时保留当前值。
显示子属性
隐藏子属性
兼容字段，当前仅保存，不影响运行时注入。
兼容字段，当前仅保存，不影响运行时注入。
沙箱的网络策略。仅 auth.type 为 environment_variable 时使用；选填，省略时保留当前值。
显示子属性
隐藏子属性
网络策略类型，固定为 unrestricted。
传入 limited 时返回 400。
POST /api/dma/v1/vaults/{vault_id}/credentials/{credential_id} HTTP/1.1
Host: api.dumate.cn
Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json示例代码
curl --location --request POST "https://api.dumate.cn/api/dma/v1/vaults/vault_23312a16793d4477/credentials/cred_0dabd8629ed74ba5" \
--header 'Authorization: Bearer <YOUR_API_KEY>' \
--header 'Content-Type: application/json' \
--data '{
"display_name": "doc-test-env-renamed",
"auth": {
"type": "environment_variable",
"secret_value": "<NEW_SECRET_VALUE>"
},
"metadata": {
"kind": "env"
}
}'返回响应
资源类型标识，固定为 vault_credential。
凭证（Credential）标识，cred_ 前缀。
所属凭证空间（Vault）标识。
显示名称；未设置时不返回该字段。
认证配置。
不返回 access_token、token、secret_value、refresh_token 等敏感字段。
显示子属性
隐藏子属性
认证类型。
可选值：mcp_oauth、static_bearer、environment_variable。
MCP 服务地址。
auth.type 为 mcp_oauth、static_bearer 时返回。
访问令牌的过期时间，RFC 3339 格式。
auth.type 为 mcp_oauth 且设置了该字段时返回。
环境变量名。
auth.type 为 environment_variable 时返回。
当前仅保存；运行时按环境变量注入，不区分 body、header。auth.type 为 environment_variable 时返回。
显示子属性
隐藏子属性
兼容字段，当前仅保存，不影响运行时注入。
兼容字段，当前仅保存，不影响运行时注入。
沙箱的网络策略。
auth.type 为 environment_variable 时返回。
显示子属性
隐藏子属性
网络策略类型。
自定义键值。
显示子属性
隐藏子属性
创建时间，RFC 3339 格式，UTC。
最近更新时间，RFC 3339 格式，UTC。
归档时间，RFC 3339 格式，UTC；未归档时为 null。
{
"type": "vault_credential",
"id": "cred_0dabd8629ed74ba5",
"vault_id": "vault_23312a16793d4477",
"display_name": "doc-test-env-renamed",
"auth": {
"type": "environment_variable",
"secret_name": "DOC_TEST_TOKEN",
"injection_location": {
"body": true,
"header": true
},
"networking": {
"type": "unrestricted"
}
},
"metadata": {
"kind": "env"
},
"created_at": "2026-11-11T03:48:04Z",
"updated_at": "2026-11-11T03:48:22Z",
"archived_at": null
}评价此篇文章