Change a fleet-wide rate limit at runtime.

The flagship feature of this system is a shared rate limit, and the first version of this API could only display it. During an incident the operator’s action is to raise, lower, or drain a limit — and if that requires a redeploy, the honest summary is that the feature does not exist operationally. River UI edits queue concurrency from its queue detail page; this is the equivalent for the gate.

PUT /rate-classes/{name}

Error

A valid request URL is required to generate request examples

Headers

Idempotency-Key · string · required

Required on every mutating request. A double-clicked Retry, or a proxy retrying a POST, must not enqueue the job twice. Keys are retained long enough to cover a client retry window and the response is replayed verbatim.

Path Parameters

name · string · required

Body

application/json

limit · integer

window_ms · integer

burst · integer

paused · boolean

Admit nothing in this class. The kill switch.

Response

200

Updated