Query vaults - Prudra

Query vaults

Read vault contents using the vault ID. All read operations work on active, sealed, and persisted vaults. Expired vaults return 404.

Get vault metadata

SDK
cURL

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_..."

Response:

{
  "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
}

When using 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

Create a vault — vault creation
Access control — share read access with clients
Files — file download details