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