Check batch send against warmup headroom
Split a proposed send batch against today’s live (feedback-adjusted) IP-warmup headroom into an allow / partial / block verdict — how many emails may go today, how many are deferred, and when headroom reopens. The operator supplies the steady-state targetDailyVolume plus the requested batch size; startingVolume / growthFactor are optional ramp-tuning knobs identical to /warmup-plan. Read-only: the verdict only ever withholds volume above today’s ceiling, it never authorises a send. Requires owner or admin role.
Authorizations
Dashboard JWT token from Clerk
Headers
Sandbox opt-in for Clerk-session-authenticated requests. Set to true to route the call through the test-mode pipeline: no real provider delivery, no credits deducted, response meta.test_mode: true. Ignored for live API keys (dv_live_sk_*) — server-to-server clients must use a test-prefixed key (dv_test_sk_*) to exercise sandbox. Test-prefixed keys unconditionally enable sandbox regardless of this header.
true, false Query Parameters
Steady-state daily volume the warmup ramp aims toward (1-10M/day). Required.
Batch size the caller wants to send now. Required.
Optional custom day-one daily cap (same knob as /warmup-plan).
Optional daily-growth multiplier (1.05-4; default ~1.5).
Response
The batch verdict inside the standard { data, meta } envelope: data carries the decision (allow, partial, or block), how many of the requested batch may send today, the deferred remainder, and when warmup headroom reopens.
The batch verdict inside the standard { data, meta } envelope: data carries the decision (allow, partial, or block), how many of the requested batch may send today, the deferred remainder, and when warmup headroom reopens.