Reorder shield rules
Shield Rules
Reorder shield rules
Replace the whole evaluation order in one call.
PUT
Reorder shield rules
Sets the order every shield rule is evaluated in. Position 0
is checked first.
This is the collection endpoint because that is what the operation is about: it
names every rule at once. To nudge a single rule one place, the per-rule
{ "move": "up" } spelling is shorter.
array
required
Rule ids (
sr_…) in the order you want them evaluated. Must be a permutation
of exactly the account’s rules — every rule present, none repeated.A list that is missing a rule, repeats one, or names a rule that isn’t yours
is rejected with
409 and nothing is written. That is deliberate: the
usual cause is a client holding a list from before a rule was created or
deleted somewhere else, and partially applying it would leave two rules
fighting over one position. Re-read
the list and send the order again.Priorities are rewritten to a dense
0…n-1 on every call, so gaps left by
deleted rules are tidied up as a side effect.