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