Refresh a Five9 Domain's live limits
Admin only. Re-reads Five9’s live rate-limit counters through an active bound Connection and folds the observed caps into the stored record. The safety margin is never touched, and an observed cap of zero (or an unrecognized window) never overwrites a good stored cap.
A provider failure is NOT an error response: the Domain comes back with sync_status="stale" and its caps unchanged, so inspect that field rather than the status code. 409 means the refresh could not be attempted at all — either no active Connection is bound to this Domain, or Five9 did not answer within the request budget. Cross-tenant access returns 404, never 403.
Authorizations
Path Parameters
Response
Successful Response
One Five9 Domain: the provider-tenant record that anchors rate limits.
N Connections resolving to the same Domain share ONE quota budget. Each
rate bucket reports the provider's raw caps per time window, the
operator's margin_pct safety margin, and the effective budget computed
from both. tenancy_unit carries the platform's own vocabulary for this
record so it can be labelled correctly without a second lookup, and
sync_status reports whether the caps are provider-observed (live),
catalog defaults (catalog_default), or unchanged after a refresh returned
unusable counters (stale).