Reordenar reglas
Todo el orden en una sola llamada, porque una lista de reglas solo significa algo en orden.
Ejecuta la llamada real contra tu espacio de trabajo, con tu propia clave.
POST /rules/reorder
Todo el orden en una sola llamada, porque una lista de reglas solo significa algo en orden.
Ejemplo
Requiere rules:write. El cuerpo nombra TODAS las reglas de la conexión, en el orden en que quieres que se evalúen. Devuelve la lista completa en su nuevo orden.
curl -X POST "$OE/rules/reorder" -H "$AUTH" -H "Content-Type: application/json" \ -d '{ "ruleIds": ["rul_7f3a1c94…", "rul_2b81de07…", "rul_c40a95f2…"] }'{ "object": "list", "data": [ { "object": "rule", "id": "rul_7f3a1c94…", "name": "Receipts to their own label", "position": 0 }, { "object": "rule", "id": "rul_2b81de07…", "name": "Newsletters after hours", "position": 1 }, { "object": "rule", "id": "rul_c40a95f2…", "name": "Anything from the old domain", "position": 2 } ], "hasMore": false, "nextCursor": null}Una lista parcial es incomplete_order, un 422, y no se mueve nada. Aceptarla significaría inventar posiciones para las reglas que dejaste fuera, y dónde acabaran respecto a las que sí nombraste sería una suposición nuestra sobre tu buzón en vez de una instrucción tuya.
Idempotente por construcción: el cuerpo nombra el orden completo, así que enviarlo dos veces termina en el mismo sitio. Es seguro reintentarlo y seguro ejecutarlo desde un script que no conoce el orden actual.
Todas las posiciones se reescriben en una sola sentencia dentro de una sola transacción, así que no hay ningún momento en que dos reglas compartan posición o la lista quede renumerada a medias.
El orden no es cosmético. Decide cuál de dos reglas nombra la carpeta en la que acaba un mensaje, y dónde una regla con stopProcessing corta la lista.