Aller à la documentation
API

Mettre à jour une règle

Tous les champs sont facultatifs, et `conditions` et `actions` remplacent en bloc.

PATCHapi.openemail.uk/rules/{id}

Exécute le véritable appel sur votre espace de travail, avec votre propre clé.

PATCH /rules/{id}

Tous les champs sont facultatifs, et conditions et actions remplacent en bloc.

Exemple

Requiert rules:write. position est accepté ici et déplace la règle, en renumérotant ce qu'elle déloge.

curl
curl -X PATCH "$OE/rules/rul_7f3a1c94e05d3862c1f0a44b" -H "$AUTH" \  -H "Content-Type: application/json" \  -d '{ "enabled": false }'
Réponse
{  "object": "rule",  "id": "rul_7f3a1c94e05d3862c1f0a44b",  "name": "Receipts to their own label",  "enabled": false,  "position": 0,  "matchCount": 148,  "updatedAt": "2026-08-30T11:02:19.000Z"}

conditions et actions sont des tableaux à REMPLACEMENT INTÉGRAL. Il n'y a pas de patch par élément : envoyer conditions écarte celles qui étaient là et stocke exactement ce que vous avez envoyé ; lisez donc la règle, modifiez le tableau et renvoyez-le. Un patch qui fusionnerait n'aurait aucun moyen de dire « supprime la deuxième condition ».

Le patch est fusionné sur la règle stockée et c'est le résultat ENTIER qui est revalidé, jamais le patch seul. Un PATCH { "actions": [{ "type": "reject" }] } contrôlé isolément n'a aucune condition où chercher un envelope_from et écrirait exactement la règle qui renvoie un 550 à une liste de diffusion.

La désactivation est la manière sûre d'arrêter une règle dont vous n'êtes pas sûr. Elle reste dans la liste, conserve ses compteurs, et est ignorée sur chaque message jusqu'à ce que vous la rallumiez.