Update a Five9 Domain's margins and lanes
Admin only. Three independent edits, any subset per request:
margins— a per-rate-bucket safety margin as a percentage of the provider cap. DOWNWARD-ONLY: values outside 1–100 are rejected, because a margin above the provider cap would hand out budget Five9 never granted, and a 0% margin is a permanent outage. Only the named buckets’ margins are written; the rawcapsare never touched.lane_overrides— move one action into a different named dispatch lane for this Domain.lane_order— fix the deterministic ordering of actions within a lane (an ordered list, not numeric weights).
Every referenced action id is re-validated against the catalog. An empty body is a no-op. Explicit JSON null is rejected — omit a field to leave it unchanged. Cross-tenant access returns 404, never 403.
Authorizations
Path Parameters
Body
Admin edits to a Domain: per-bucket safety margins and lane placement.
All three fields are optional and an omitted field is left untouched rather
than cleared. margins is keyed on the rate bucket (the provider's own
operation-type name), so a safety margin can be applied to one bucket
without affecting the others; values are a percentage of the provider cap
and are downward-only. lane_overrides moves one action into a different
named dispatch lane for this Domain, and lane_order fixes the order
actions run in within a lane as an ordered list of action ids rather than
numeric weights.
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).