DocumentationAPI v1
Stateless audit attestation pack
Verify a vitna.audit-pack.v1 document across all six cryptographic and governance layers, or assemble an inline audit pack from a vitna.stackfile.v1 payload in memory with no API key and zero retention.
POST /api/v1/audit-packcurl -X POST https://vitna.ai/api/v1/audit-pack \
-H "content-type: application/json" \
-d '{
"mode": "verify",
"pack": { ... },
"trustedRecordPublicKey": "MCowBQYDK2VwAyEA...",
"requirePackSignature": false,
"failOnRollback": true,
"maxMonthlyCostUsd": 5000
}'Modes
POST /api/v1/audit-pack operates in memory (Cache-Control: no-store) with two modes:
- Verify mode (
verify, default whenpackor a directvitna.audit-pack.v1body is posted): runs `verifyAuditPack` across canonical SHA-256digestintegrity, verbatimclaims.citationBoundarypreservation, outer Ed25519packSignatureverification,stackfileDigest+ signedpolicy.json+vitna.lock.jsonlock invariants, RFC 6962 Witness observation Merkle proofs and signed daily roots, provider compliance term and evaluation digests, and optional CI governance gates (requirePackSignature,requireAttestedPrices,failOnRollback,maxMonthlyCostUsd). - Assemble mode (
assemble, whenstackfileis posted): validates an inlinevitna.stackfile.v1alongside optionalpolicyText,policyLock,ledgerRows,evidence,terms,monthlyRuns, anddiscoverPeers, evaluates rollout watchdog and compound pipeline BOMs against Witness rates, and returns an unsignedvitna.audit-pack.v1stamped with its canonical SHA-256digest.
Payloads and pinned keys are never persisted. Also exposed to MCP clients as vitna_verify_audit_pack on `POST /api/v1/mcp`.
Verification response shape
{
"mode": "verify",
"ok": true,
"verdict": "verified",
"orgId": "convexity",
"generatedAt": "2026-11-06T00:00:00.000Z",
"digest": "4f3b9a8e01c2d3e4f5a6b7c8d9e0f1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8",
"checks": {
"envelope": {
"schemaValid": true,
"digestMatch": true,
"citationBoundaryIntact": true
},
"packSignature": {
"present": true,
"verified": true,
"signerPublicKey": "MCowBQYDK2VwAyEA...",
"pinnedKeyMatched": true
},
"stackfileAndPolicy": {
"stackfilePresent": true,
"stackfileDigestMatch": true,
"policyPresent": true,
"policyVerified": true,
"lockPresent": true,
"lockVerified": true
},
"witnessPriceAttestations": {
"totalProofs": 4,
"attestedProofs": 4,
"unattestedProofs": 0,
"verifiedProofIds": ["101", "102", "103", "104"],
"pinnedRecordKeyUsed": true
},
"evidenceAndTerms": {
"providerTermCount": 4,
"customerEvidenceCount": 2
},
"governanceGates": {
"watchdogVerdict": "healthy",
"totalEstimatedMonthlySpendUsd": 1220
}
},
"failures": [],
"warnings": [],
"privacy": "Evaluated in memory with zero retention; audit attestation packs, inline Stackfiles, policy envelopes, ledger rows, and pinned public keys are never stored.",
"meta": {
"generatedAt": "2026-11-06T00:00:00.000Z",
"mode": "verify",
"verdict": "verified"
}
}