Saltar para a documentação
API

Listar execuções de regras

O que as suas regras realmente fizeram, uma linha por regra e por mensagem.

GETapi.openemail.uk/rules/runs

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

GET /rules/runs

O que as suas regras realmente fizeram, uma linha por regra e por mensagem.

Exemplo

Requer rules:read. Mais recentes primeiro. ruleId restringe a uma regra e threadId responde a "porque é que esta mensagem acabou aqui".

curl
curl "$OE/rules/runs?threadId=thr_5d31c2a8…&limit=25" -H "$AUTH"
Resposta
{  "object": "list",  "data": [    {      "object": "rule_run",      "id": "rrun_9c1f0a4b7e05d3862c1f0a44",      "ruleId": "rul_7f3a1c94e05d3862c1f0a44b",      "ruleName": "Receipts to their own label",      "threadId": "thr_5d31c2a8…",      "messageId": "msg_c5f21cc6…",      "sender": "[email protected]",      "subject": "Your receipt",      "actions": ["label", "archive"],      "failures": [],      "createdAt": "2026-08-29T11:04:12.000Z"    }  ],  "hasMore": false,  "nextCursor": null}

actions contém o que foi APLICADO e failures contém o que foi recusado, como type: reason. São listas separadas em vez de uma lista anotada porque "a regra arquivou-a" e "a regra tentou arquivá-la" são factos diferentes, e um registo que os confunde não consegue responder a nenhuma das perguntas. Estes são tipos de ação puros. Os valores vivem na regra, e wouldApply num teste é o único sítio onde estão explicitados.

Uma resposta automática suprimida aparece aqui, como reply: auto-reply suppressed because the message carries List-Id, e é o único sítio onde aparece. Mais nada revela uma resposta que deliberadamente não saiu, e "porque é que a minha mensagem de ausência não respondeu àquilo" é de outro modo irrespondível.

ruleName é guardado na linha em vez de ser obtido por junção na leitura, por isso o registo continua a ler-se corretamente depois de uma regra ser renomeada ou eliminada. Uma linha a nomear uma regra que já não existe é o caso normal, não uma referência pendente.

O limite de uma resposta automática por remetente por dia é imposto por uma linha de reserva na mesma tabela, que este registo não devolve: é a razão pela qual uma segunda mensagem de ausência para o mesmo remetente dentro de um dia nunca dispara.