Email Alerts
Get notified by email when important events occur in your app.
Email alerts are available on Growth and Compliance.
Supported Event Types
| Event Type | Description |
|---|---|
| policy.violation | A guardrail rule was triggered (PII detected, secret leaked, model blocked, etc.) |
| budget.exceeded | A cost or token budget limit was breached |
| ai.error | An AI provider error or timeout occurred |
Configuration
Email and webhook alerts share one configuration, in the Alerts card under Settings → Webhooks. You can control:
| Setting | Default | Description |
|---|---|---|
| Enabled | Off | Master toggle for email alerts |
| Event types | None | Which event types trigger an alert |
| Minimum severity | 1 (all) | Only alert on violations at or above this level (1–10) |
| Cooldown | 15 min | Minimum time between alert emails (1–1440 min) |
| Recipient | Account email | Optional override email address |
How It Works
When an event is ingested that matches your alert configuration, an email is queued and sent asynchronously. Alerts never block or delay event ingestion.
The cooldown prevents alert spam. After an alert is sent, no further alerts fire for that app until the cooldown period has passed. The cooldown is checked both when the alert is queued and again when it is sent, so even under high event volume you will not be flooded.
Severity Levels
Policy violations carry a severity from 1 (informational) to 10 (critical), taken from the rule that fired. Use the minimum severity setting to filter out low-priority alerts.
budget.exceeded and
ai.error events are always severity 5, so a minimum
severity above 5 silently stops them from alerting at all. Keep the threshold at 5 or below if you want
budget and error notifications.
Each alert email includes a direct link to your app's settings page where you can adjust or disable alerts.