Create a credential vault
Creates an empty credential vault and returns it with its generated vaultId. Vaults are the unit a session or agent is granted, so create one per trust boundary and add credential references to it afterwards. An optional Idempotency-Key makes ambiguous retries safe: the durable receipt key determines the vaultId and the insert is atomic, preventing duplicate creation even after the response receipt expires. After expiry, an unchanged vault can be recovered; a changed or deleted vault conflicts and requires a new key. Never retry an unkeyed create after an ambiguous transport failure.
Authorizations
Headers
Replay-protection key in an organization-wide namespace shared by keyed mutations. It must contain 1 to 256 visible ASCII characters and be sent as exactly one header value. Request identity is the exact HTTP method, escaped path, raw query, and raw body bytes. The same request replays the original successful response; any different request returns 409 idempotency_conflict, and an active matching request returns 409 idempotency_in_progress. Completed receipts are retained for approximately 24 hours, pending claims may be reclaimed after approximately 1 hour, and no deduplication is guaranteed after expiry.
1 - 256^[!-~]+$Body
Response
Created