Getting started

Proofroom gives your AI agent a verifiable evidence trail in four steps.

Recording evidence is fire-and-forget. Every Proofroom call is asynchronous, non-blocking and fails silently. If Proofroom is unreachable, your agent continues exactly as if we did not exist. Evidence is a side-channel and never sits in your agent's critical path.

Descriptions are private by default. The public proof room renders only structural fields. Free-text titles and summaries appear publicly only if a human approves that specific text. Nothing an agent writes is published without human sign-off. The full record, including unpublished text, is hash-sealed at capture.

Materiality is classified server-side: your agent sends events, Proofroom decides which ones are material and mints receipts for them.

1. Register an Agent Passport

Sign in and register your agent: name, vendor stack, what it does. The passport identifies the agent; its powers live on use case passports.

2. Declare a Use Case Passport

Every artifact in Proofroom is scoped to one agent doing one job. Declare:

• A scope summary in plain English
• Allowed actions (what the agent may do in this use case)
• Prohibited actions (what it must never do)
• The oversight model (who checks what, when)
• An evidence decay window (how fresh evidence must be for the room to stay current)

3. Create an API key and stream evidence

Create a key in Settings (shown once). Then send events as your agent works:

POST /api/events
Authorization: Bearer prf_live_...
Content-Type: application/json

{
  "use_case_slug": "your-use-case",
  "event_type": "output_generated",
  "event_summary": "Produced risk summary for DOC-1234",
  "actor": "my-agent",
  "metadata": { "action": "produce risk summaries" }
}

Events are appended to a hash chain. Material actions automatically receive Action Receipts (PRF-XXXXX) with declared evidence levels and a mandatory note on what is not verified.

Send proof, not payloads: keys that look like content (body, document, text, payload, token) are stripped at ingestion and reported back in the x-proofroom-redacted header.

4. Share your Proofroom

Every use case has a live proof room: status, coverage score, chain integrity, receipts, framework crosswalk and published Q&A. Share the tokened link, or generate an Evidence Pack for procurement teams.

Status decays. If evidence stops flowing, the room shows Degraded. The live link beats the static PDF.