Eine Regel testen
Welche Ihrer jüngsten Nachrichten diese Regel erfasst hätte. Es ändert nichts.
Führt den echten Aufruf gegen Ihren Workspace aus, mit Ihrem eigenen Schlüssel.
POST /rules/{id}/test
Welche Ihrer jüngsten Nachrichten diese Regel erfasst hätte. Es ändert nichts.
Beispiel
Benötigt rules:read. Ein Probelauf liest ein Postfach und schreibt nichts, er ist also keine rules:write-Operation. days ist standardmäßig 30 und geht bis 365, limit ist standardmäßig 50 und geht bis 200, und threadIds testet benannte Threads statt eines Zeitfensters.
curl -X POST "$OE/rules/rul_7f3a1c94e05d3862c1f0a44b/test" -H "$AUTH" \ -H "Content-Type: application/json" \ -d '{ "days": 30, "limit": 50 }'{ "object": "rule_test", "ruleId": "rul_7f3a1c94e05d3862c1f0a44b", "scanned": 50, "matched": 3, "wouldApply": ["label:USER_RECEIPTS", "archive"], "messages": [ { "threadId": "thr_5d31c2a8…", "from": "[email protected]", "subject": "Your receipt", "receivedAt": "2026-08-28T10:00:00.000Z" } ], "warnings": [{ "code": "forward_unverified", "value": "[email protected]" }]}Dies beantwortet dieselbe Engine, die auf dem Zustellpfad läuft. Es ist ein einziges Modul, bewusst pur (keine Datenbank, kein Netzwerk), damit der Einstellungsbildschirm, der Probelauf und der SMTP-Handler nicht unterschiedlicher Meinung darüber sein können, ob eine Regel zutrifft. Eine zweimal geschriebene Vorschau sind zwei Antworten auf eine Frage, und die, die einem Menschen gezeigt wird, ist die falsche.
Konstruktionsbedingt begrenzt: höchstens 200 Nachrichten über höchstens ein Jahr. Das läuft in einem Worker mit einem Zeitbudget, und ein unbegrenzter Scan ist eine Anfrage, die auf halbem Weg stirbt und nichts vorzuweisen hat.
Eine deaktivierte Regel lässt sich trotzdem testen. Genau darum geht es: schreiben, testen, dann aktivieren.
In warnings taucht eine Regel auf, die sich zwar parsen lässt, sich aber nicht wie gewünscht verhält. Eine Weiterleitungsadresse, die niemand bestätigt hat, ist die, der Sie begegnen werden. Eine Warnung bricht den Test nie ab: Sinn eines Probelaufs ist es, in einem Durchgang alles Gefundene zu melden, statt beim ersten Punkt abzubrechen.
Es gibt kein „Wende das auf mein Postfach an“
Es gibt bewusst kein POST /rules/{id}/run, und es wird auch keines geben. Eine Regel rückwirkend auf ein ganzes Postfach anzuwenden ist unbegrenzt, unumkehrbar und ohne Rückgängig-Funktion (eine trash-Aktion über zehn Jahre Mail ist ein Aufruf ohne zweite Chance), und der Schreibpfad, den sie nutzen müsste, führt in den gespeicherten Thread zusammen, was jede berührte Nachricht als Nebenwirkung des Aufräumens an den Anfang des Posteingangs hieven würde.
Dieser Endpunkt ist die ehrliche Hälfte dieses Wunsches: Er beantwortet „Was hätte das getan?“, und das ist die eigentliche Frage; danach legen Sie die tatsächlich gemeinten Nachrichten mit PATCH /threads/{id} ab.