What is Keragon's Rate-Limiting Policy?

To maintain reliable service, Keragon applies a rate limit of 10,000 requests per 5 minutes to each webhook URL. Here's how it works:

How Rate-Limiting Works

Each webhook URL is monitored individually. For every URL, we track the number of requests over a rolling 5-minute period:

• If the number of requests exceeds 10,000, the URL is temporarily blocked, and further requests return an error: 429 Too Many Requests.
• If the number of requests stays within 10,000, all requests are processed normally.

Example

Here’s an example of the limit in action:

1. You send 9,000 requests within 5 minutes. All requests are processed successfully.
2. You send another 2,000 requests shortly afterward. This brings the total to 11,000 requests in 5 minutes, exceeding the limit.
   • The URL is temporarily blocked, and further requests return 429 Too Many Requests.
3. After some time, older requests fall out of the 5-minute window, reducing the total. Once the count drops below 10,000, the URL is unblocked, and requests resume normally.

What Happens When Blocked?

While blocked, any requests to the URL will fail with 429 Too Many Requests. The block is lifted automatically as the request count drops below the limit within the rolling 5-minute window.

If you have further questions, feel free to contact our support team!