API

ルールを更新する

すべてのフィールドは任意で、`conditions` と `actions` は全体を置き換えます。

PATCHapi.openemail.uk/rules/{id}

実際の呼び出しを、ご自身のキーで自分のワークスペースに対して実行します。

PATCH /rules/{id}

すべてのフィールドは任意で、conditions と actions は全体を置き換えます。

例

rules:write が必要です。ここでは position を受け付け、ルールを移動して、押しのけられたものを振り直します。

curl

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

レスポンス

{  "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 と actions は全置換の配列です。要素単位のパッチはありません。conditions を送ると、そこにあったものは破棄され、送ったものだけが保存されます。ルールを読み、配列を編集して、送り返してください。マージするパッチでは「2 つ目の条件を削除する」と言う方法がありません。

パッチは保存済みのルールにマージされ、パッチ単体ではなく結果「全体」が再検証されます。PATCH { "actions": [{ "type": "reject" }] } を単体で検証しても、envelope_from を確かめる条件が存在せず、メーリングリストに 550 を返すルールをそのまま書き込んでしまいます。

確信が持てないルールを止める安全な方法は無効化です。一覧には残り、カウントも保持され、再び有効にするまですべてのメッセージでスキップされます。