Saltar para a documentação
API

Obter uma regra

Uma regra por inteiro, com as suas condições, as suas ações e quantas vezes disparou.

GETapi.openemail.uk/rules/{id}

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

GET /rules/{id}

Uma regra por inteiro, com as suas condições, as suas ações e quantas vezes disparou.

Exemplo

Requer rules:read. Os ids têm o prefixo rul_.

curl
curl "$OE/rules/rul_7f3a1c94e05d3862c1f0a44b" -H "$AUTH"
Resposta
{  "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"}

Uma regra noutra ligação é rule_not_found, um 404, e não um 403, a mesma resposta que um id que nunca existiu, porque dizer a uma chave que ids existem numa caixa de correio que ela não pode ler é, em si, a fuga.

Isto é a regra inteira. Não há versões nem histórico: uma edição sobrescreve, e o que uma regra FEZ é registado por mensagem em GET /rules/runs.