Delete a vault

Deleting a vault immediately purges all its documents, files, and events and frees the vault slot from your quota. Use deletion to explicitly clean up vaults you no longer need, or to free persisted vault quota.

SDK
cURL

import { initialise } from '@prudra/core';
import { deleteVault } from '@prudra/vault';

initialise({ apiKey: process.env.PRUDRA_API_KEY! });

await deleteVault({ vaultId: 'vlt_clx1abc123' });
console.log('Vault deleted — all contents purged');

curl -X DELETE https://api.prudra.dev/vaults/vlt_clx1abc123 \
  -H "Authorization: Bearer prv_test_sk_..."

Response:

{
  "id":        "vlt_clx1abc123",
  "deleted":   true,
  "deletedAt": "2026-04-30T09:10:00.000Z"
}

What deletion removes

Content	Removed
Vault metadata record	Yes
Documents	Yes
File GCS objects	Yes
CDN cache entries	Yes (within minutes)
Vault events	Yes
Webhook delivery logs	No (kept for audit)

Deletion is permanent and irreversible. There is no soft-delete or recycle bin.

When to delete

You have processed results and no longer need the vault
You’ve hit persisted vault quota and need to free a slot
Cleaning up test vaults in development

Active vaults delete automatically

Active vaults expire automatically at the end of their TTL — you don’t need to delete them. Explicit deletion is most useful for persisted vaults where you want to free the persisted quota slot.

Deleting an active vault

You can delete a vault in any state, including active. This is destructive — if work is in progress, it is cancelled and the vault’s contents are lost.

Error handling

Error	Status	Cause	Resolution
`vault-not-found`	404	Vault ID doesn’t exist or already deleted	No action needed

Vault quota — monitor your quota
Persist a vault — prevent auto-expiry instead of deleting
TTL and expiry — automatic expiry behaviour

Get Started

Payments

Wallets

Storage

Webhooks

Discovery

Platform

Delete a vault

Delete a vault

What deletion removes

When to delete

Active vaults delete automatically

Deleting an active vault

Error handling

​Delete a vault

​What deletion removes

​When to delete

​Active vaults delete automatically

​Deleting an active vault

​Error handling

​Related

Delete a vault

What deletion removes

When to delete

Active vaults delete automatically

Deleting an active vault

Error handling

Related