创建凭证空间
更新时间：2026-11-13
POST
https://api.dumate.cn/api/dma/v1/vaults
本接口用于创建凭证空间（Vault）。凭证空间是凭证的容器，凭证保存智能体（Agent）访问 MCP 服务或外部系统所需的 token、密钥。
创建成功后返回凭证空间对象，其中 id 为凭证空间标识。创建会话时通过 vault_ids 关联凭证空间。
权限说明
使用 API Key 鉴权调用 API 流程，具体调用流程，请查看认证鉴权。
请求参数
Headers 参数
除公共头域外，无其它特殊头域
Body 参数
display_name
string
显示名称。
长度：1–255 个字符；不传时返回 400。
必选
metadata
object
自定义键值，最多 16 对。
可选
显示子属性
隐藏子属性
请求结构
POST /api/dma/v1/vaults 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" \
--header 'Authorization: Bearer <YOUR_API_KEY>' \
--header 'Content-Type: application/json' \
--data '{
"display_name": "doc-test-vault",
"metadata": {
"ticket": "doc"
}
}'返回响应
Headers 参数
除公共头域外，无其它特殊头域
返回参数
type
string
资源类型标识，固定为 vault。
可选
id
string
凭证空间（Vault）标识，vault_ 前缀。
可选
display_name
string
显示名称。
可选
metadata
object
自定义键值。
可选
显示子属性
隐藏子属性
created_at
string
创建时间，RFC 3339 格式，UTC。
可选
updated_at
string
最近更新时间，RFC 3339 格式，UTC。
可选
archived_at
string
归档时间，RFC 3339 格式，UTC；未归档时为 null。
可选
响应示例
{
"type": "vault",
"id": "vault_23312a16793d4477",
"display_name": "doc-test-vault",
"metadata": {
"ticket": "doc"
},
"created_at": "2026-11-11T03:47:43Z",
"updated_at": "2026-11-11T03:47:43Z",
"archived_at": null
}评价此篇文章