归档凭据 - Qoder CN

POST /api/v1/cloud/vaults/{vault_id}/credentials/{credential_id}/archive 将指定 Vault 中的某个凭据设为归档状态。归档后的凭据默认不再出现在凭据列表中，但可通过 include_archived=true 参数包含。

请求头

头部	必选	说明
`Authorization`	是	`Bearer $QODER_PAT`

路径参数

参数	类型	必选	说明
`vault_id`	string	是	Vault 的唯一标识符，带 `vault_` 前缀
`credential_id`	string	是	凭据的唯一标识符，带 `vcred_` 前缀

示例请求

curl -X POST "https://api.qoder.com.cn/api/v1/cloud/vaults/vault_019e3bb940277f0db05ab74291acf6ef/credentials/vcred_019e3bb98877759e862750b495c1fce8/archive" \
  -H "Authorization: Bearer $QODER_PAT"

示例响应

HTTP 200 OK 返回已归档的凭据对象。响应中不包含 access_token 字段。

{
  "id": "vcred_019e3bb98877759e862750b495c1fce8",
  "vault_id": "vault_019e3bb940277f0db05ab74291acf6ef",
  "mcp_server_url": "https://example.com/mcp-stream",
  "protocol": "streamable_http",
  "type": "static_bearer",
  "status": "archived",
  "archived_at": "2026-05-18T15:45:35.387093Z",
  "created_at": "2026-05-18T15:34:35.387093Z",
  "updated_at": "2026-05-18T15:45:35.387093Z"
}

响应字段

字段	类型	说明
`id`	string	凭据唯一标识符，带 `vcred_` 前缀
`vault_id`	string	所属 Vault 的 ID
`mcp_server_url`	string	MCP 服务器 URL
`protocol`	string	协议类型：`streamable_http`
`type`	string	凭据类型：`static_bearer`
`status`	string	归档后为 `"archived"`
`archived_at`	string	归档时间（ISO 8601）
`created_at`	string	创建时间（ISO 8601）
`updated_at`	string	最后更新时间（ISO 8601）

错误码

HTTP	type	触发条件
401	`TOKEN_INVALID`	缺少或无效的认证令牌
404	`not_found_error`	Vault 或凭据不存在
409	`conflict_error`	凭据已处于归档状态

完整错误信封说明详见错误参考。

​请求头

​路径参数

​示例请求

​示例响应

​响应字段

​错误码

请求头

路径参数

示例请求

示例响应

响应字段

错误码