Skip to main content

What are limits?

Two types of rules you can set per agent:
  • Email Alert — Sends you an email when a threshold is hit.
  • Hard Limit — Returns HTTP 429 and stops requests once the threshold is hit.
You can also combine both on a single rule.

Creating a rule

1

Open the Limits page

Navigate to your agent’s Limits page in the dashboard.
2

Create a rule

Click + Create rule.
3

Configure the rule

Pick a rule type (Email Alert, Hard Limit, or both), a metric (tokens or cost), a threshold, and a period (hour / day / week / month).
4

Save

Click Create rule. The rule takes effect immediately.

How blocking works

When a Hard Limit triggers, the next proxy request returns 429 Too Many Requests with a message:
Limit exceeded: cost usage ($X) exceeds $Y per day
The block resets at the start of the next period.

Email notifications

Alerts are sent to your account email. Make sure it is correct in your profile settings.

Checking rules

  • Rules are evaluated hourly (cron) for notifications, and on every request for blocks.
  • A notification is sent once per rule per period to avoid spam.