Create a vault
Creates a vault, for example one per end customer of a reseller. Every Workspace already has a default vault.
Authorizations
workspace API token (sk_akua_...) or OAuth2 JWT. Create tokens at https://akua.dev/developers/api-tokens
Headers
Optional workspace/scope context for the request. Carries a single workspace wire id (ws_…) today. Only needed for broad tokens - a workspace-owned token implies its workspace.
1 - 53"ws_j572abc123def456"
Optional caller-supplied idempotency key. Any non-empty key up to 64 characters is accepted. Endpoint-specific documentation describes how the key is used.
1 - 64"create-prod-2026-05-07"
Body
Response
Vault created
A vault id
^vlt_[^\s/]{1,64}$"vlt_j572abc123def456"
1 - 531 - 100DELETING: deletion was accepted. Nothing in the vault can be used any more, and Akua Connect is erasing its state; the vault disappears when that is done.
ACTIVE, DELETING True for the Workspace's default vault, which cannot be deleted.
The reseller's own id for the end customer this vault represents, if any.
100Unix timestamp (seconds)
x >= 0