codai Vault API

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:}}`), 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`.

GitHub OpenAPI

Operations 68

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 #
PUT /v1/vault/vaults/{id}/members/{userId} Add a member (seal the vault key) #
PATCH /v1/vault/vaults/{id}/members/{userId} Change a member role #
DELETE /v1/vault/vaults/{id}/members/{userId} Remove a member #
POST /v1/vault/vaults/{id}/rotate Rotate the vault key #
PUT /v1/vault/vaults/{id}/quorum Set the quorum policy #
POST /v1/vault/approvals/{id}/vote Vote on a quorum approval #
POST /v1/vault/policy/simulate Simulate a draft policy #
GET /v1/vault/receipts/keys Receipt signing keys #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/codai-ro:codai-ro-vault-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

codai-ro-vault-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Codai Ro Vault API
  version: '1'
  description: 'Operations tagged Vault across 2 of this provider''s published API definitions: codai-ro-gateway-openapi.json, codai-ro-gateway-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://ai.codai.ro
  description: Production
security:
- bearerAuth: []
tags:


# --- truncated at 32 KB (139 KB total) ---
# Full source: https://artifacts.apis.io/codai-ro/openapi/codai-ro-vault-api-openapi.yml