When the detector stamps an auto-mitigation
The detector compares your current spend velocity against your recent baseline. When a channel crosses an anomaly threshold, Orbit writes a self-expiring mitigation record for that channel:
Three properties matter when you are deciding what to do about one:
- Clamp-down only. A mitigation can only lower the channel’s effective per-minute cap. It never raises a cap you configured, so it can never weaken protection you already have.
- Self-expiring. Every record carries an expiry at most six hours after it was applied, and a detection late in the UTC day expires sooner. When it expires, the channel’s normal caps apply again with nothing to do.
- Per-channel. Only channels with an enforced per-minute cap are auto-mitigated:
sms,whatsapp,rcs,email, andvoice. A surge elsewhere still raises an alert and a fraud review, but nothing is throttled.
View the active list in the dashboard
- Open Settings, then Compliance.
- Find the Active auto-mitigations panel.
- Read the rows. Each one shows the channel, the action in force (Paused or Throttled to N/min), the time it was applied, and the time it auto-clears, all in your local timezone.
List active mitigations via API
GET /settings/compliance/fraud-mitigations returns every active record, most recently applied first. The endpoint fails open: if the lookup cannot be served, it returns an empty list rather than an error, so monitoring you build on it always renders.
mode is throttle for a high-severity record and pause for critical. max_per_min is the effective cap the send and dial guards enforce while the record is active; 0 means fully paused.
Lift a mitigation early
Lifting a mitigation is an owner-only action, the same role gate as the fraud-caps settings it sits beside. A clear takes effect on the very next send or dial: the guards read your compliance settings on every enforcement, so there is no cache to wait out. Clearing a channel with no active record is a no-op that still returns success, which keeps retries and dashboards simple. From the dashboard, choose Clear on the row. From the API:all (/settings/compliance/fraud-mitigations/all) to lift every active mitigation at once.
Expected responses:
200when the clear is recorded, including the no-op case where the record had already expired.403when the calling user is not an organization owner.422when:channelis not one ofsms,whatsapp,rcs,email,voice, orall.503on a transient datastore fault. The mitigation is still active in this case; retry after a few seconds.
When not to clear
A clear is a judgement that the surge is your own traffic. The original driver for this surface was the cold-start misfire: a young organization with little spend history can trip a critical projection from a small baseline and wake up paused. That case is safe to clear, and so are:- A new campaign, customer, or market ramp your baseline could not yet know about.
- A planned burst you recognize, such as a scheduled send window or a dialer shift.
- A retry storm from your own clients after an outage you have already resolved.
- You cannot match the volume to any campaign, queue, or dialer plan you started.
- An API key or dashboard session may have leaked. Rotate credentials and review recent sends before you lift anything; Fraud review triage walks the review.
- The surge returns immediately after a clear. If the detector re-applies a mitigation, the underlying velocity has not changed, and clearing again only extends the burn. Investigate first.
Observability
- Every clear writes an audit-log row with the action
settings.fraud_mitigation_cleared, recording who lifted which channel and when. It lands in the same ledger as your other settings changes; see Audit ledger model. - The Active auto-mitigations panel and
GET /settings/compliance/fraud-mitigationsreflect the clear immediately, because both read live settings rather than a cache. - The channel’s effective cap reverts on the next send or dial, so refusals caused by a pause stop at that point. Traffic counters and dashboards resume accruing at the normal rate from then on.
- On the apply side, the detector also opens a fraud review and sends you an alert when it stamps a mitigation, so a clear never erases the evidence that something surged; see Spend anomaly and alert model.
Ask for evidence before you clear
Before lifting a pause, spend a minute on what the detector saw:- Open your spend-anomaly alert rules (Usage anomaly alerts, Usage anomaly alert rules) and compare the projected spend against the baseline it used.
- Read the anomaly entry behind the alert: baseline, current, and projected spend, plus the mitigation that was applied.
- Clear when the projection is out of line with traffic you can explain. Keep the pause when it matches traffic you cannot.