Saltar para a documentação
API

Atualizar uma regra

Todos os campos são opcionais, e `conditions` e `actions` substituem por inteiro.

PATCHapi.openemail.uk/rules/{id}

Executa a chamada real contra o seu espaço de trabalho, com a sua própria chave.

PATCH /rules/{id}

Todos os campos são opcionais, e conditions e actions substituem por inteiro.

Exemplo

Requer rules:write. position é aceite aqui e move a regra, renumerando o que ela deslocar.

curl
curl -X PATCH "$OE/rules/rul_7f3a1c94e05d3862c1f0a44b" -H "$AUTH" \  -H "Content-Type: application/json" \  -d '{ "enabled": false }'
Resposta
{  "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 e actions são arrays de SUBSTITUIÇÃO INTEIRA. Não há patch por elemento: enviar conditions descarta as que lá estavam e guarda exatamente o que enviou, por isso leia a regra, edite o array, e devolva-o. Um patch que fundisse não teria forma de dizer "elimina a segunda condição".

O patch é fundido na regra guardada e o resultado INTEIRO é revalidado, nunca o patch sozinho. Um PATCH { "actions": [{ "type": "reject" }] } verificado isoladamente não tem condições onde procurar um envelope_from e escreveria exatamente a regra que responde 550 a uma lista de distribuição.

Desativar é a forma segura de parar uma regra de que não tem a certeza. Fica na lista, mantém as suas contagens, e é saltada em todas as mensagens até a voltar a ligar.