# codai Vault API

**Canonical:** https://apis.io/apis/codai-ro/codai-ro-vault-api/  
**Provider:** codai — https://apis.io/providers/codai-ro/  
**Base URL:** https://ai.codai.ro  
**Documentation:** https://docs.codai.ro/docs/api

codai Vault API is one of 35 APIs that [codai](https://apis.io/providers/codai-ro/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Vault. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

codai Vault: a zero-knowledge credentials manager for you and your agents. Clients encrypt everything (XChaCha20-Poly1305, keys wrapped with X-Wing post-quantum hybrid) before upload, so these endpoints store and sync ciphertext only. Agents never receive secret values: they see a catalogue of handles (`{{vault:<slug>}}`), ask for a policy decision (tiers t0-t4, deny), wait for your approval when needed and call brokered HTTPS endpoints whose responses are redacted. Only items you mark cloud-usable can be used without one of your devices online. Keys minted with `scopes` (for example the browser extension key: `vault.read` + `vault.add`) may call only the routes of their scopes; anything else answers 403 `key_scope_forbidden`. Security events are signed receipts (DSSE, ES256) you can verify with `GET /v1/vault/receipts/keys`.

## Operations (60 of 68)

| Method | Path | Summary |
|---|---|---|
| GET | `/v1/vault/account` | Get the vault account |
| PUT | `/v1/vault/account` | Create or update the vault account |
| PATCH | `/v1/vault/settings` | Change the default tier and anomaly guards |
| POST | `/v1/vault/lock` | Panic lock |
| POST | `/v1/vault/unlock/challenge` | Get an unlock challenge |
| POST | `/v1/vault/unlock` | Unlock the vault |
| GET | `/v1/vault/limits` | List per-handle limits |
| PUT | `/v1/vault/items/{id}/limits` | Set per-handle limits |
| GET | `/v1/vault/vaults` | List my vaults |
| POST | `/v1/vault/vaults` | Create a vault |
| GET | `/v1/vault/items` | Sync vault items |
| PUT | `/v1/vault/items/{id}` | Create or update an item |
| DELETE | `/v1/vault/items/{id}` | Delete an item |
| PUT | `/v1/vault/items/{id}/cloud` | Opt an item in or out of cloud use |
| GET | `/v1/vault/rules` | List policy rules |
| POST | `/v1/vault/rules` | Create a policy rule |
| DELETE | `/v1/vault/rules/{id}` | Delete a policy rule |
| GET | `/v1/vault/grants` | List active grants |
| POST | `/v1/vault/grants/revoke-task` | Revoke the grants of a task |
| DELETE | `/v1/vault/grants/{id}` | Revoke a grant |
| GET | `/v1/vault/events` | Vault audit log |
| GET | `/v1/vault/approvals` | Pending approvals |
| GET | `/v1/vault/approvals/{id}` | Approval status |
| POST | `/v1/vault/approvals/{id}/decide` | Approve or deny |
| POST | `/v1/vault/devices/challenge` | Get a device enrolment nonce |
| GET | `/v1/vault/devices` | List device keys |
| POST | `/v1/vault/devices` | Enrol a device key |
| PATCH | `/v1/vault/devices/{id}` | Rename a device key |
| DELETE | `/v1/vault/devices/{id}` | Revoke a device key |
| GET | `/v1/vault/catalog` | Agent catalogue (no values) |
| POST | `/v1/vault/use` | Request a use decision |
| POST | `/v1/vault/http` | Brokered HTTPS call |
| POST | `/v1/vault/resolve/challenge` | Get a resolve challenge |
| POST | `/v1/vault/resolve` | Resolve values for a local broker |
| POST | `/v1/vault/add-requests` | Ask the user to add a secret |
| POST | `/v1/vault/add-requests/lookup` | Look up an add request by link token |
| GET | `/v1/vault/add-requests/{id}` | Add request status |
| DELETE | `/v1/vault/add-requests/{id}` | Cancel an add request |
| POST | `/v1/vault/add-requests/{id}/complete` | Complete an add request |
| GET | `/v1/vault/emergency` | List emergency contacts |
| POST | `/v1/vault/emergency` | Invite an emergency contact |
| POST | `/v1/vault/emergency/accept` | Accept an emergency invitation |
| PUT | `/v1/vault/emergency/{id}/seal` | Seal vault keys to the contact |
| PATCH | `/v1/vault/emergency/{id}` | Change an emergency contact |
| DELETE | `/v1/vault/emergency/{id}` | Revoke or decline |
| POST | `/v1/vault/emergency/{id}/request` | Request emergency access |
| POST | `/v1/vault/emergency/{id}/deny` | Deny an access request |
| POST | `/v1/vault/emergency/{id}/approve` | Approve an access request now |
| GET | `/v1/vault/emergency/{id}/vault-data` | Read the granted vaults |
| GET | `/v1/vault/hibp/range/{prefix}` | Breach check range (k-anonymity) |
| GET | `/v1/vault/rotation` | Rotation queue |
| PUT | `/v1/vault/items/{id}/rotation` | Set the rotation schedule |
| POST | `/v1/vault/items/{id}/rotated` | Mark an item rotated |
| POST | `/v1/vault/rotation/breach-report` | Report breach check results |
| GET | `/v1/vault/derivers` | List credential derivers |
| PUT | `/v1/vault/items/{id}/deriver` | Set a credential deriver |
| DELETE | `/v1/vault/items/{id}/deriver` | Remove a credential deriver |
| POST | `/v1/vault/derive` | Derive a short-lived credential |
| GET | `/v1/vault/vaults/{id}/members` | List vault members |
| GET | `/v1/vault/vaults/{id}/candidates` | List member candidates |

…and 8 more operations. They are listed in full on the page.

## Machine-readable artifacts (2)

- **OpenAPI** — https://artifacts.apis.io/codai-ro/openapi/codai-ro-vault-api-openapi.yml
- **Documentation** — https://docs.codai.ro/docs/gateway

## Other codai APIs (12)

- [codai Account API](https://apis.io/apis/codai-ro/codai-ro-account-api/)
- [codai Agents API](https://apis.io/apis/codai-ro/codai-ro-agents-api/)
- [codai Attestations API](https://apis.io/apis/codai-ro/codai-ro-attestations-api/)
- [codai Authorization API](https://apis.io/apis/codai-ro/codai-ro-authorization-api/)
- [codai Chat & Completions API](https://apis.io/apis/codai-ro/codai-ro-chat-completions-api/)
- [codai Connect API](https://apis.io/apis/codai-ro/codai-ro-connect-api/)
- [codai Devices API](https://apis.io/apis/codai-ro/codai-ro-devices-api/)
- [codai Discovery API](https://apis.io/apis/codai-ro/codai-ro-discovery-api/)
- [codai Embeddings & Audio API](https://apis.io/apis/codai-ro/codai-ro-embeddings-audio-api/)
- [codai Feed API](https://apis.io/apis/codai-ro/codai-ro-feed-api/)
- [codai Guest chat API](https://apis.io/apis/codai-ro/codai-ro-guest-chat-api/)
- [codai Health API](https://apis.io/apis/codai-ro/codai-ro-health-api/)

## Tags

Vault

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/codai-ro/codai-ro-vault-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/codai-ro/.
