Delete a vault
Delete a vault and everything it separates from the rest.
This is the most destructive call here, short of deleting your account, and there is no second step: making the call is the confirmation. Read what follows before you make it.
The contacts the vault holds go with it, and so do the records of the kinds you invented. Every private link onto the vault, or onto the contacts in it, stops opening. That revocation is permanent, and bringing the vault back would not reopen them: you would decide again who may read it.
If this was the vault records land in by default, the first vault left takes that over. If no vault is left, your account has no default and holds nothing, which is the state every account starts in. The last vault of an account may be deleted.
The deletion is soft, so nothing is destroyed, but no endpoint here brings a vault back today. Treat it as final.
While you have turned off the list of vaults (shows_vault_list is false on GET /me), your default vault cannot be deleted. The call answers 422 on vault with: You cannot delete your default vault while the list of vaults is turned off. Turn the list back on in Preferences first. Nothing is deleted. Your other vaults can still be deleted.
Path parameters
Sent as JSON. Anything not listed here is ignored.
The vault, named either by the readable name it reports as slug or by its id. Both answer, whichever the account builds its own addresses from. A readable name is rebuilt whenever the record is renamed, and the previous one stops answering, so a client that stores a reference stores the id. A name a record has released is never given to another.
Returns
Nothing at all. A vault belonging to somebody else answers 404, and is not deleted. So does a vault you have already deleted, so calling this twice does not report a second deletion.
Rate limit
Sixty requests per minute, per user, shared by every key and device. Every answer carries the budget left in X-RateLimit-Remaining.
No content.
Keys act as you, with exactly the access you have. Make one per integration so you can revoke it alone.