Skip to main content
PromptGuard maintains detailed logs of all security events and interactions, accessible through the dashboard for security analysis and compliance reporting. The Enterprise, Shadow Business and Shadow Enterprise plans include a persistent audit log with integrity hash chaining, built to support SOC 2 evidence.
Prefer to watch? This page as a silent, step-by-step video:

Current Availability

Dashboard Access

View audit logs and security events through the dashboard:
  1. Navigate to Interactions: app.promptguard.co → Projects → [Your Project] → Interactions
  2. Filter and Search: Use filters to find specific events by type, date, or content
  3. Export Data: Download interaction data for analysis

Audit Log Page

The Enterprise, Shadow Business and Shadow Enterprise plans include a dedicated Audit Log page:
  1. Navigate: app.promptguard.co → Dashboard → Audit Log
  2. Filter: Project, Source (People, Agents, Dashboard assistant, MCP clients), Category, Severity and Outcome
  3. Export: Export CSV downloads the events matching your filters for compliance reporting. For JSON, call GET /dashboard/audit-log/export?format=json
The audit log captures configuration changes, every sign-in and refused sign-in through your organization’s SSO, data access, and security decisions. Sign-ins by password or OAuth are not recorded in it. The page shows the audit log of the organization you are acting in, and everyone with a role there sees all of it: Owners, Admins, Members and Viewers, and anyone acting in it through a grant. A security analyst who should see everything and change nothing is a Viewer. Your own events in other organizations are not shown. To send the audit log to your SIEM, pushed beside your alerts or pulled with an export key, see SIEM export: audit events.

What Gets Logged

PromptGuard captures comprehensive audit trails for:

Security Events

  • Threat Detection: Security violations, blocked requests, policy triggers
  • PII Redaction: Automatic masking of sensitive data
  • Policy Decisions: Allow, block, or redact actions
  • Detection Methods: Regex, ML, or agentic evaluator used

API Activity

  • Request Details: All API calls with timestamps and metadata
  • Response Information: Status codes, processing times
  • Error Events: Failures, timeouts, and error conditions
  • Usage Tracking: Token consumption and costs

Log Structure

Standard Log Format

All security events follow a consistent structure:

Event Categories

Security Events

PII Redaction Events

Dashboard Access

Viewing Interactions

Access your security events through the dashboard:
  1. Navigate: app.promptguard.co → Projects → [Your Project] → Interactions
  2. Filter: Use the filters to find specific events:
    • Flagged Only: Show only detections: blocked, redacted and flagged events
    • Search: Search in content or reason text
    • Date Range: Filter by last N days
  3. Details: Click on any event to see full details

Exporting Data

Pull interactions via the API and feed them into your own tooling — a SIEM, a data warehouse, a compliance dashboard, or a simple script.
/dashboard/* takes a dashboard sign-in, not an API key. These endpoints are the API the dashboard at app.promptguard.co calls. They are not part of the public API, and no API key or long-lived token works on them. Everything under /api/v1 takes your X-API-Key instead (API reference).To script one anyway, sign in with your email and password. This needs an account that has a password, and an email domain that requires SSO is refused. The access token lasts one hour.
Where an example shows YOUR_SESSION_TOKEN or YOUR_SESSION_COOKIE, it means the access_token from step 1, sent as Authorization: Bearer <token> or as the access_token cookie. A request acts on your personal organization unless it sends X-Organization-Id.

Available Filters

Events are returned sorted by timestamp descending.

Best Practices

Log Retention

  • Current: Logs are retained based on your plan tier
  • Free: 24 hours (no guaranteed retention)
  • Developer: 30 days retention
  • Enterprise: Custom retention (configurable per organization)

Persistent Audit Trail (Enterprise, Shadow Business, Shadow Enterprise)

These plans include a persistent audit trail stored in the audit_events table:
  • Categories: security, authentication, data_access, configuration, billing
  • Integrity: Each event has a SHA-256 integrity hash chained to the previous event’s hash (previous_hash → integrity_hash), forming a tamper-evident append-only chain
  • Organization-scoped: Events filtered by your organization context
  • Supports SOC 2 evidence: Designed for the audit-log controls a SOC 2 audit examines (CC7.2). PromptGuard’s own SOC 2 is not yet held: Type 1 preparation started October 2026, and no report exists

Hash Chain Verification

Verify the integrity of your audit trail over any time range:
Response:
If any event has been tampered with, valid will be false and first_break_at will identify the first corrupted event.

GDPR Compliance

GDPR data subject rights are on every plan, Free included (Pricing):
  • Data Export: POST /dashboard/compliance/data-export - Export all your data
  • Data Deletion: POST /dashboard/compliance/data-deletion - Delete all your data (requires confirmation)

Compliance

  • All security events are logged for compliance
  • Logs include timestamps, user IDs, organization IDs, and decision metadata
  • Pull audit data via the Interactions API for compliance reporting
  • Events include IP address and user agent for forensic analysis

Next Steps

View Interactions

Access your security events in the dashboard

Analytics

View comprehensive analytics and metrics

Usage Tracking

Monitor API usage and costs

API Reference

Complete API documentation
Need help integrating audit data with your infrastructure? Contact support for guidance on enterprise integrations.
Last modified on November 21, 2026