Rate Limits

ZettAgent enforces lightweight KV-backed counters per API key and per scope. Configure the thresholds in your environment:

RATE_LIMITS_PER_MINUTE=120
RATE_LIMITS_PER_HOUR=2400
RATE_LIMITS_PER_DAY=10000

The /v1/* endpoints return 429 with a Retry-After header when the limit is exceeded.

Headers

  • x-za-scope (optional) – override default scope detection
  • Retry-After – seconds until the smallest window resets

Example Response

{
  "error": "Rate limit exceeded"
}

The platform also logs usage metrics to the usage table, making it easy to push data into your BI warehouse.