Change a queue's fleet-wide selection weight.

Weight chooses BETWEEN queues inside the atomic admission gate. It never changes per-job priority ordering within a queue and is unrelated to a job envelope’s rate-budget weight.

PUT /queues/{queue}

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

queue · string · required

Body

application/json

weight · integer · required

Required range: x >= 1

Response

200

Updated