Limits
Limits are spend ceilings you set ahead of time on your Mizan keys and projects, so a runaway integration or a usage spike can never surprise you on the bill. Manage every limit — and see exactly how close each one is to firing — from the Limits page.
Overview
There are two independent levels a limit can be set at — an individual API key, or an entire project. Both are enforced live, in the request path, before a call is ever sent upstream, and both use the same two shapes: a lifetime cap and a rolling period cap (see below).
API key limits
A limit on a single Mizan key caps what that key alone can spend — independent of, and in addition to, any limit on the project it belongs to. Useful for capping an individual integration, environment, or teammate's key without touching anyone else's.
Project limits
A limit on a project caps the combined spend of every key inside it. It's the right tool when several keys share a budget — an app with a dev and prod key, or a team's shared workspace — and you want one ceiling for the group rather than tracking each key separately.
Lifetime vs. rolling period
Both key limits and project limits support two independent forms, settable on their own or together:
- Lifetime limit — total spend, ever. Once hit, it stays hit until you raise or clear it.
- Rolling period limit — spend within a window you choose (e.g. every 7 or 30 days). The counter resets automatically the moment the window elapses — no manual action needed.
What happens when a limit is hit
The instant a limit is reached, every further call is rejected with a 403 — for a key limit, just that key; for a project limit, every key inside that project, even ones that haven't hit their own limit. Nothing is deleted or revoked — raising the limit, clearing it, or waiting for its rolling period to reset immediately unblocks the key(s) again. Check the Limits page any time to see live usage against every cap you've set.
BYOK calls are exempt
Limits only gate platform-routed calls — the ones billed against your Mizan wallet. A call served through a BYOK connection you've set up never touches Mizan's own spend, so it's never counted toward — or blocked by — any limit here.