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 detectionRetry-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.