> ## Documentation Index
> Fetch the complete documentation index at: https://docs.prompt-wall.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PromptWall

> AI Observability + Runtime Control. One canonical event log; multiple integration modes.

PromptWall sits between your application and your LLM. It captures every
request, surfaces them on a unified Observability dashboard, and (optionally)
enforces runtime policies — block, rewrite, or regenerate — when an answer
violates your rules.

You can integrate in **three ways**, all of which feed the same dashboard:

<CardGroup cols={3}>
  <Card title="Full Control" icon="bolt" href="/modes/full-control" color="#3B82F6">
    **Recommended.** Drop-in OpenAI replacement. Change `OPENAI_BASE_URL`
    to PromptWall and you get observability immediately. Runtime control
    is opt-in.
  </Card>

  <Card title="Verify" icon="shield-check" href="/modes/verify" color="#10B981">
    Keep calling your LLM directly. POST the prompt + answer to
    `/v1/verify` and PromptWall validates it against your policies.
  </Card>

  <Card title="Events" icon="chart-line" href="/modes/events" color="#A78BFA">
    Observability-only ingest. Use when PromptWall did **not** run the
    LLM (your own SDK, a vendor like Moveo, or a log archive).
  </Card>
</CardGroup>

## How the modes compare

| Feature       | Proxy                           | Verify                       | Events            |
| ------------- | ------------------------------- | ---------------------------- | ----------------- |
| Endpoint      | `POST /v1/chat/completions`     | `POST /v1/verify`            | `POST /v1/events` |
| Required keys | OpenAI **and** PromptWall       | PromptWall only              | PromptWall only   |
| Control modes | observe / guard / verify / full | block / rewrite / regenerate | none (read-only)  |
| Code change   | Two env vars                    | Two SDK lines                | One HTTP POST     |
| Observability | ✓ Always on                     | ✓ Always on                  | ✓ Always on       |

> **You can mix modes.** Some apps use Proxy while others use Verify
> or Events. They all write to the same canonical event log and show up
> on the same Observability dashboard.

## What you get out of the box

* **Org-wide AI activity** sliced by use case · team · app · integration
* **Cost & token rollups** at 1-minute / 1-hour / 1-day granularity
* **Trace drill-through** for every request (prompt → guards → upstream → policy hits)
* **Failure-cluster panel** showing the top patterns this week
* **Policy synthesis** that watches traces and suggests new guards
* **Usage-based billing** primitives (volume only — never per use case)

Next: pick an integration mode →