API

Een regel bijwerken

Elk veld is optioneel, en `conditions` en `actions` vervangen in hun geheel.

PATCHapi.openemail.uk/rules/{id}

Voert de echte aanroep uit op je workspace, met je eigen sleutel.

PATCH /rules/{id}

Elk veld is optioneel, en conditions en actions vervangen in hun geheel.

Voorbeeld

Vereist rules:write. position wordt hier wél geaccepteerd en verplaatst de regel, waarbij alles wat verschuift opnieuw genummerd wordt.

curl

curl -X PATCH "$OE/rules/rul_7f3a1c94e05d3862c1f0a44b" -H "$AUTH" \  -H "Content-Type: application/json" \  -d '{ "enabled": false }'

Antwoord

{  "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 en actions zijn arrays die IN HUN GEHEEL VERVANGEN worden. Er is geen patch per element: conditions sturen gooit weg wat er stond en slaat precies op wat je verstuurde, dus lees de regel, bewerk de array en stuur hem terug. Een patch die zou samenvoegen, had geen manier om "verwijder de tweede voorwaarde" te zeggen.

De patch wordt op de opgeslagen regel samengevoegd en het HELE resultaat wordt opnieuw gevalideerd, nooit de patch op zichzelf. Een PATCH { "actions": [{ "type": "reject" }] } die op zichzelf gecontroleerd wordt, heeft geen voorwaarden om op een envelope_from te controleren en zou precies de regel wegschrijven die een mailinglijst een 550 geeft.

Uitschakelen is de veilige manier om een regel te stoppen waar je over twijfelt. Hij blijft in de lijst staan, behoudt zijn tellingen en wordt bij elk bericht overgeslagen tot je hem weer aanzet.