> Source: https://vitna.ai/docs/api/v1/engine/audit-pack
> Raw Markdown: https://vitna.ai/docs/api/v1/engine/audit-pack.md
> Corpus index: https://vitna.ai/llms.txt
# 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-pack
```
```bash
curl -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:
1. **Verify mode** (`verify`, default when `pack` or a direct `vitna.audit-pack.v1` body is
posted): runs [`verifyAuditPack`](../../../routing/audit-packs.md) across
canonical SHA-256 `digest` integrity, verbatim `claims.citationBoundary`
preservation, outer Ed25519 `packSignature` verification, `stackfileDigest` +
signed `policy.json` + `vitna.lock.json` lock 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`).
2. **Assemble mode** (`assemble`, when `stackfile` is posted): validates an inline
`vitna.stackfile.v1` alongside optional `policyText`, `policyLock`,
`ledgerRows`, `evidence`, `terms`, `monthlyRuns`, and `discoverPeers`,
evaluates rollout watchdog and compound pipeline BOMs against Witness rates,
and returns an unsigned `vitna.audit-pack.v1` stamped with its canonical
SHA-256 `digest`.
Payloads and pinned keys are never persisted. Also exposed to MCP clients as
`vitna_verify_audit_pack` on [`POST /api/v1/mcp`](mcp.md).
## Verification response shape
```json
{
"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"
}
}
```