Update or reorder a shield rule
Shield Rules
Update or reorder a shield rule
Replace a rule’s definition, or move it in the evaluation order.
PUT
Update or reorder a shield rule
This endpoint does one of two things depending on the body you send.
To set the whole arrangement at once instead — which is what a drag-and-drop UI
needs, since a drag can cross several positions — use
Reorder.
Replace the rule
Send the same body as Create. It is a whole-object replace rather than a merge: a rule’s conditions only mean anything as a set, so “merge my two conditions into your three” has no answer you’d reliably predict. Setenabled: false to switch a rule off without losing its definition or its
place in the order.
Move it in the order
Send onlymove. The rule swaps places with its neighbour and the whole
account’s priorities are renumbered from zero.
string
up or down. Moving past either end is a no-op, not an error.Order decides which of two matching rules fires, so a reorder changes what
happens to your mail even though no rule’s own definition changed. It is
recorded in the account’s audit trail.