too-many-requests

Description

The client has exceeded an allowed request rate. The server is throttling further requests.

Response Example

Code
{
  "type": "https://docs.kordiam.app/docs/errors/too-many-requests",
  "title": "Too Many Requests",
  "status": 429,
  "detail": "Too many requests",
  "instance": "/api/v2/elements",
  "traceId": "abc-123-def",
  "retryAfter": 60
}

Common Causes

• The request rate for the endpoint has been exceeded.
• The client sent a burst of requests faster than the deployment allows.

How to Fix

1. Check the Retry-After response header or the retryAfter response property to determine how long to wait before retrying.
2. Implement exponential backoff with jitter in your client to avoid bursts of requests.
3. Reduce polling frequency or batch requests where the endpoint supports it.