Persist a vault

Documentation Index

Fetch the complete documentation index at: https://docs.prudra.dev/llms.txt

Use this file to discover all available pages before exploring further.

​

Persist a vault

​

When to persist

• The caller needs to download results after the TTL expires
• You want to archive payment results for compliance
• A long-running job produces results that should outlive the default TTL

​

Persist a vault

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

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

await persistVault({ vaultId: 'vlt_clx1abc123' });

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

{
  "id":          "vlt_clx1abc123",
  "status":      "persisted",
  "persistedAt": "2026-04-30T09:05:00.000Z"
}

​

Persist from within your handler

app.post('/generate', walletMiddleware(...), payMiddleware(...), vaultMiddleware(), async (req, res) => {
  const vault = req.vault!;

  const report = await generateReport();
  await vault.addDocument(report, 'Report');
  await vault.seal('Report generated');

  // Persist so caller can download even if they return hours later
  await vault.persist();

  res.json({ vaultId: vault.id });
});

​

Persisted vault quota

​

Extending TTL without persisting

import { extendVaultTtl } from '@prudra/vault';

await extendVaultTtl({
  vaultId:  'vlt_clx1abc123',
  ttlHours: 48,  // new TTL from now
});

​

Error handling

​

Related

• TTL and expiry — how TTL works
• Delete a vault — free persisted vault quota
• Vault quota — check current usage