When to use which alert
Match the question you want answered to the alert that answers it.| If you want to know… | Use this alert |
|---|---|
| My balance is about to run out — alert me now | Low balance |
| My balance is trending toward zero — give me a heads up | Balance depletion |
| A specific key is close to hitting its usage cap | Key limit |
| A specific key is trending toward hitting its cap | Key exhaustion |
| Spending suddenly spiked compared to normal | Anomalous spend |
| My error rate jumped | Error rate spike |
| A long-dormant key started making requests again | Dormant key |
| Send me a recurring summary of which models are costing the most | Model usage report |
| Send me a recurring high-level snapshot of the account | Dashboard snapshot |
Alerts are per-user, not per-organization
Every alert is configured on your account, for you. Turning on an organization-scoped alert subscribes you to the alert about your organization — it does not enroll your coworkers. If multiple people in the same organization want to be notified about the same thing, each of them turns it on individually. This means:- You don’t need to be an organization owner to receive alerts. As long as your role grants visibility to the data the alert covers (for example, billing members can see organization-wide spend), the alert is available to you.
- Coworkers won’t suddenly start getting alerts because you configured yours.
- Your alert preferences travel with your account, not with the organization.
Personal vs. organization alerts
There are two places to configure alerts:- Personal alerts — cover spend, balances, and keys tied to your personal account.
- Organization alerts — cover spend, balances, and keys tied to an organization you belong to. Available scopes depend on your role in that organization.
How notifications are delivered
Alerts are sent via email and/or SMS. You choose which channels you want in Settings → Notifications. SMS requires a verified phone number. Each alert has a built-in cooldown so a single situation doesn’t notify you repeatedly. If a condition persists, you’ll hear about it again on a future evaluation, not on every check.Scheduled vs. reactive alerts
Some alerts run on a schedule you pick (hourly, daily, weekly, or monthly, depending on the alert). Others react in real time when an event happens.- Scheduled — Anomalous spend, Balance depletion, Error rate spike, Key exhaustion, Dormant key, Model usage report, Dashboard snapshot.
- Reactive (fire as soon as the condition is met, no schedule) — Low balance, Key limit.