# Vault API (/docs/api/native/vault)



（待译）

Vault stores write-only credentials through `/vault/v1`, with a compatibility face at `/anthropic/v1/vaults`. Concepts and behavior follow Anthropic vaults (credential collections, write-only values, rotation and archival), so Anthropic experience applies. Differences: native secrets use names and static/oauth kinds; native OAuth uses authorizations, while compatible mcp\_oauth creation and updates return 501; explicit allowed\_hosts are required, with no unrestricted mode; Agent sessions reject nonempty vault\_ids, so vault-backed MCP authentication is unavailable; application vault references return 501, including praxis\_vault\_ref bindings and secret writes with a vault source. Metadata labels do not attach credentials to either resource. Start with `praxis.vault.vaults.create` to create the containing vault.

用 API Key 作为 Bearer 凭据，通过以下地址管理库与 Secret。Secret 的值只写，任何接口都不会返回。

`https://api.deepraxis.ai/vault/v1`

[指南 →](/docs/cloud/services/vault/quickstart)

| 资源 | 路径 |
| --- | --- |
| [库](/docs/api/native/vault/vaults) | /vault/v1/vaults |
| [Secret](/docs/api/native/vault/secrets) | /vault/v1/vaults/{vault_id}/secrets |
| [模板](/docs/api/native/vault/templates) | /vault/v1/templates |
| [一键授权](/docs/api/native/vault/authorizations) | /vault/v1/authorizations |

Secret 可以用名字或 vsec\_ 开头的 ID 寻址。列表用 cursor 与 limit 翻页（limit 默认 50，最大 200），返回的 next\_cursor 为 null 表示没有后续页。

同一批库也可以通过 Claude 托管智能体的凭据库接口访问：[Claude 托管智能体](/docs/api/compatible/anthropic/managed-agents)

[错误码](/docs/api/native/vault/errors)