Zur Dokumentation springen
API

Eine Regel abrufen

Eine Regel vollständig, mit ihren Bedingungen, ihren Aktionen und der Angabe, wie oft sie ausgelöst hat.

GETapi.openemail.uk/rules/{id}

Führt den echten Aufruf gegen Ihren Workspace aus, mit Ihrem eigenen Schlüssel.

GET /rules/{id}

Eine Regel vollständig, mit ihren Bedingungen, ihren Aktionen und der Angabe, wie oft sie ausgelöst hat.

Beispiel

Benötigt rules:read. IDs tragen das Präfix rul_.

curl
curl "$OE/rules/rul_7f3a1c94e05d3862c1f0a44b" -H "$AUTH"
Antwort
{  "object": "rule",  "id": "rul_7f3a1c94e05d3862c1f0a44b",  "name": "Receipts to their own label",  "description": null,  "enabled": true,  "position": 0,  "match": "all",  "conditions": [    { "field": "from_domain", "op": "matches", "value": "*.stripe.com", "negate": false }  ],  "actions": [{ "type": "label", "value": "USER_RECEIPTS" }, { "type": "archive" }],  "stopProcessing": true,  "lastMatchedAt": "2026-08-29T11:04:12.000Z",  "matchCount": 148,  "createdAt": "2026-08-01T09:00:00.000Z",  "updatedAt": "2026-08-20T16:31:00.000Z"}

Eine Regel auf einer anderen Connection ist rule_not_found, ein 404 und kein 403, also dieselbe Antwort wie bei einer ID, die nie existiert hat; einem Key zu verraten, welche IDs in einem Postfach existieren, das er nicht lesen darf, ist selbst schon das Leck.

Das ist die gesamte Regel. Es gibt keine Versionen und keine Historie: Eine Änderung überschreibt, und was eine Regel GETAN hat, wird stattdessen pro Nachricht in GET /rules/runs festgehalten.