Vector Integrity API

Base path: /v1/audit/assurance/integrity Auth: Session token or API key — see Authentication. Entitlement: entitlement.vector_integrity_assurance · Feature flag: audit.vector_integrity Permissions: audit:read (reads), audit:write (rebuild / sweep / release).

The corpus-integrity control. Trinitite builds a compliance manifold — labelled clusters (safe / caution / forbidden) derived from the platform's own deterministic governance verdicts — then scores every stored and incoming embedding against it. Vectors that fall into a forbidden region are quarantined so retrieval can never surface them into a Guardian prompt. See the Vector Integrity product page.

Rebuild manifold (+ auto-sweep)

POST /v1/audit/assurance/integrity/rebuild — audit:write

Rebuild the compliance manifold from the latest verdict-labelled corpus, then auto-sweep both scored stores:

store value	Backing table	Source surface
policy_store	policy_store_chunks	Policy retrieval
rag_store	rag_chunks	Customer RAG ingestion

Returns 202 Accepted with a rebuild_id; poll status.

Manifold status

GET /v1/audit/assurance/integrity/status — audit:read

{
  "last_rebuild_id": "vir_01J9X…",
  "last_rebuilt_at": "2026-05-01T00:00:00Z",
  "stores": {
    "policy_store": { "scored": 18234, "quarantined": 12 },
    "rag_store": { "scored": 92837, "quarantined": 47 }
  },
  "psi": 0.03
}

Sweep

POST /v1/audit/assurance/integrity/sweep — audit:write

Score pending embeddings against the current manifold without rebuilding it. Use after a bulk RAG ingestion.

Findings

GET /v1/audit/assurance/integrity/findings — audit:read

List quarantine findings, filterable by store, label, detection_method. Each finding carries hubness fields (detection_method: "manifold" | "hubness", hubness_score) — a high hubness score flags a Black-Hole vector that poisons retrieval by attracting unrelated queries.

Quarantine list & release

• GET /v1/audit/assurance/integrity/quarantine — audit:read. List quarantined chunks.
• POST /v1/audit/assurance/integrity/quarantine/:findingId/release — audit:write. Manually release a chunk back into retrieval (requires a documented reason; the release is itself attested into the ledger).

Webhook events

Event	When	Severity
audit.assurance.vector_integrity.query_risk	A retrieval query scored high risk against the manifold.	medium / high.
audit.assurance.integrity.quarantine_added	A chunk was quarantined.	medium.

Errors

HTTP	error.code	When
402	entitlement_missing	Org lacks entitlement.vector_integrity_assurance.
404	not_found (flag_rollout_off)	Feature flag disabled.
409	conflict	A rebuild is already in flight.

---

→ Vector Integrity — the product overview. → Continuous Assurance API — the streaming twin. → Errors, rate limits & conventions — shared contract.