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.
Query vaults
Read vault contents using the vault ID. All read operations work on active, sealed, and persisted vaults. Expired vaults return 404.
import { initialise } from '@prudra/core';
import { getVault } from '@prudra/vault';
initialise({ apiKey: process.env.PRUDRA_API_KEY! });
const vault = await getVault({ vaultId: 'vlt_clx1abc123' });
console.log(vault.id); // 'vlt_clx1abc123'
console.log(vault.status); // 'sealed'
console.log(vault.summary); // 'Analysis complete'
console.log(vault.expiresAt); // ISO timestamp
curl https://api.prudra.dev/vaults/vlt_clx1abc123 \
-H "Authorization: Bearer prv_test_sk_..."
{
"id": "vlt_clx1abc123",
"status": "sealed",
"label": "CSV analysis job",
"summary": "Analysed 1,234 rows",
"sealedAt": "2026-04-30T09:05:00.000Z",
"expiresAt": "2026-05-01T09:00:00.000Z",
"createdAt": "2026-04-30T09:00:00.000Z",
"documents": [
{ "id": "doc_clx1abc123", "label": "Analysis result", "createdAt": "..." }
],
"files": [
{ "id": "fil_clx1abc123", "name": "data.csv", "url": "https://assets.prudra.dev/...", "createdAt": "..." }
]
}
Get the full manifest
The manifest includes all documents with their data and all files with their CDN URLs:
import { getVaultManifest } from '@prudra/vault';
const manifest = await getVaultManifest({ vaultId: 'vlt_clx1abc123' });
for (const doc of manifest.documents) {
console.log(doc.label, doc.data);
}
for (const file of manifest.files) {
console.log(file.name, file.url); // CDN URL for download
}
vaultMiddleware, req.vault.getManifest() returns the same data:
const manifest = await req.vault!.getManifest();
res.json({
documents: manifest.documents,
files: manifest.files,
});
Response fields
| Field | Type | Description |
|---|
id | string | Vault ID (vlt_...) |
status | string | active, sealed, persisted, or expired |
label | string | Human-readable label from creation |
summary | string | Summary provided when sealing |
sealedAt | string | ISO timestamp of sealing, null if still active |
expiresAt | string | ISO timestamp of expiry, null if persisted |
createdAt | string | ISO timestamp of creation |
documents | array | List of document stubs (full data in manifest) |
files | array | List of file stubs with CDN URLs |
