Rate limits

The current Okatana guide documents a per-credential rate limit and gives a default deployment value of 120 requests per minute.

A 429 response maps to OkatanaRateLimitException.

catch (OkatanaRateLimitException e) {
    e.retryAfter().ifPresent(delay -> metrics.record(delay));
}

GET requests can retry 429 automatically. The default backoff includes jitter so multiple workers are less likely to retry at the same instant.

For sustained high-volume integrations, reduce unnecessary polling, use larger supported page sizes, partition unrelated workloads by credential when operationally appropriate, and prefer event-driven integration where available.