Notifications

​

Channels

​

Events you can subscribe to

• Budget thresholds — 50 / 75 / 90 / 100 % of monthly allowance consumed
• Topup completed — successful payment
• Payment failed — card declined, need to update billing
• Quota exceeded — specific API key hit RPM/TPD/budget limit
• Model deprecated — one of your referenced model slugs is scheduled for removal
• Fallback triggered (rate) — fallback events above a threshold per hour (prod-alerting signal)
• File quota reached — storage is full
• Subscription changes — upgrade/downgrade, cancellation, renewal
• Member invites — accepted / declined
• Security — new API key created, key revoked, suspicious login

​

Per-member subscriptions

​

Webhook format

{
  "id": "evt_01J...",
  "type": "budget.threshold_reached",
  "workspace_id": "ws_...",
  "created_at": "2026-04-15T21:14:00Z",
  "data": {
    "threshold_pct": 75,
    "credits_used": 7500,
    "monthly_allowance": 10000
  }
}

​

Suppressing notifications