Skip to main content
POST https://api.prompt-wall.com/v1/verify Use this endpoint after your application’s LLM has produced an answer. PromptWall scans the input, checks the answer against the grounding tool_result, and applies any policies you’ve configured.

​
Request

​
Required headers

HeaderValue
X-API-KeyYour PromptWall API key (pw_…)
Content-Typeapplication/json
Authorization: Bearer pw_… is also accepted.

​
Optional headers

HeaderDefaultNotes
X-Use-CasedefaultDashboard dimension
X-Team-Id(unset)Dashboard dimension
X-Integration-Idapi:v1_verifyIdentifies the calling integration
X-End-User-Id(unset)End-user pseudonym
X-Session-Id(unset)Multi-turn session correlation

​
Body

{
  "prompt":      "What is our Q3 revenue?",
  "answer":      "Q3 revenue was $12.4M.",
  "tool_result": "Q3 revenue: $12.4M (from internal BI)",
  "model":       "gpt-4o-mini",
  "provider":    "openai"
}

​
Response

{
  "ok":              true,
  "request_id":      "1a2b3c…",
  "answer":          "Q3 revenue was $12.4M.",
  "answer_changed":  false,
  "governance":      "allow",
  "mismatch_type":   "none",
  "policy_hits":     [],
  "explanation":     { … }
}

​
governance field

ValueMeaning
allowAnswer passed every check — returned unchanged
rewriteAnswer modified (e.g. PII redacted) — answer_changed: true
regenerateAnswer violated a policy; a new answer was produced
blockAnswer cannot be returned — replaced with a safe fallback

​
mismatch_type field

ValueMeaning
noneNo grounding mismatch
numericNumber in the answer doesn’t match tool_result
contradictionDirect contradiction with grounding source
unsupportedClaim isn’t present in the grounding source

​
Errors

StatusBody
400{"ok": false, "error": "answer is required"}
401{"ok": false, "error": "Invalid or missing API key"}
The full request and decision are recorded as a trace and appear on the Observability dashboard.