Listar reglas

Todas las reglas de la conexión, en el orden en que se evalúan.

export OE=https://api.openemail.ukexport AUTH="Authorization: Bearer $OPENEMAIL_API_KEY"

Una regla es una lista de condiciones sobre un mensaje entrante y una lista de acciones que aplicar a todo lo que coincida con ellas. Las reglas pertenecen a la CONEXIÓN, no a quien las escribió. Una clave del espacio de trabajo ve las mismas reglas que un compañero, y eliminar la cuenta del autor no se las lleva.

Una conexión admite 100 reglas, y cada una admite como mucho 20 condiciones y 10 acciones. Son protecciones contra scripts descontrolados, no límites de plan: la regla número 101 es rule_limit_reached, un 422, y la condición número 21 la rechaza el esquema antes de escribir nada.

match: "all" combina las condiciones con AND, match: "any" las combina con OR, y negate en una condición suelta es NOT. No hay árbol booleano anidado: (A and B) or C son dos reglas. Eso es una decisión, no un atajo. Un esquema recursivo no se puede describir en el documento de OpenAPI con $refStrategy: "none", no se puede entregar a un cliente MCP como JSON Schema, y es exactamente la forma que ya ha reventado antes el límite de instanciación de TypeScript en este repositorio. Dos reglas es también como lo lee una persona seis meses después.

Todas las reglas activadas de la conexión se evalúan contra cada mensaje entrante, en orden de position, de menor a mayor. La evaluación se detiene tras una regla coincidente que lleve stopProcessing: true, y no se considera nada por debajo de ella. Cuando dos reglas coincidentes nombran una carpeta, gana la ÚLTIMA y el mensaje acaba en su carpeta, que es la lectura que da una lista numerada y lo único sobre el orden que conviene decir en vez de dejar que se descubra.

Nada es retroactivo. Una regla decide qué pasa con el correo que llega después de que exista, y deliberadamente no hay ningún endpoint que la aplique a un buzón que ya tienes. Consulta POST /rules/{id}/test, que responde a la pregunta que la gente realmente hace cuando busca eso.

Requiere rules:read. limit llega hasta 100, cursor es opaco (devuelve el nextCursor que se te dio) y enabled restringe a uno de los dos lados del interruptor.

curl "$OE/rules?limit=25&enabled=true" -H "$AUTH"

{  "object": "list",  "data": [    {      "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 },        { "field": "subject", "op": "contains", "value": "receipt", "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"    }  ],  "hasMore": false,  "nextCursor": null}