नियम सूचीबद्ध करें

कनेक्शन का हर नियम, उसी क्रम में जिसमें उनका मूल्यांकन होता है।

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

नियम आने वाले संदेश पर शर्तों की सूची और उनसे मेल खाने वाली हर चीज़ पर की जाने वाली कार्रवाइयों की सूची है। नियम कनेक्शन के होते हैं, उसके नहीं जिसने उन्हें लिखा। वर्कस्पेस कुंजी वही नियम देखती है जो कोई सहकर्मी देखता है, और लेखक का खाता हटाने से वे साथ नहीं जाते।

एक कनेक्शन 100 नियम रखता है, और उनमें से हर एक अधिकतम 20 शर्तें और 10 कार्रवाइयाँ। ये प्लान की सीमाएँ नहीं, बेकाबू स्क्रिप्ट से बचाव हैं: 101वाँ नियम rule_limit_reached, एक 422 है, और 21वीं शर्त कुछ लिखे जाने से पहले ही स्कीमा द्वारा मना कर दी जाती है।

match: "all" शर्तों को AND करता है, match: "any" उन्हें OR करता है, और किसी एक शर्त पर negate NOT है। नेस्टेड बूलियन वृक्ष नहीं है: (A and B) or C दो नियम हैं। यह शॉर्टकट नहीं, एक निर्णय है। रिकर्सिव स्कीमा को $refStrategy: "none" के साथ OpenAPI दस्तावेज़ में वर्णित नहीं किया जा सकता, MCP क्लाइंट को JSON Schema के रूप में नहीं थमाया जा सकता, और यही वह आकार है जिसने इस रेपो में पहले भी TypeScript की instantiation सीमा उड़ाई है। छह महीने बाद कोई व्यक्ति भी उसे दो नियमों के रूप में ही पढ़ेगा।

कनेक्शन के हर सक्षम नियम का मूल्यांकन हर आने वाले संदेश पर होता है, position क्रम में, सबसे छोटे से शुरू। ऐसे मेल खाते नियम के बाद मूल्यांकन रुक जाता है जिस पर stopProcessing: true है, और उसके नीचे कुछ भी नहीं देखा जाता। जहाँ दो मेल खाते नियम दोनों किसी फ़ोल्डर का नाम लेते हैं, वहाँ बाद वाला जीतता है और संदेश उसी के फ़ोल्डर में पहुँचता है — क्रमांकित सूची से यही पाठ बनता है, और क्रम के बारे में यही एक बात बताने लायक है, खोजे जाने पर छोड़ने लायक नहीं।

कुछ भी पूर्वव्यापी नहीं है। नियम तय करता है कि उसके बनने के बाद आने वाली मेल का क्या होगा, और जानबूझकर ऐसा कोई एंडपॉइंट नहीं जो उसे आपके पास पहले से मौजूद मेलबॉक्स पर लागू करे। POST /rules/{id}/test देखें, जो उस सवाल का जवाब देता है जो लोग असल में तब पूछ रहे होते हैं।

rules:read चाहिए। limit 100 तक जाता है, cursor अपारदर्शी है (जो nextCursor मिला था वही वापस भेजें), और enabled स्विच के एक ही पक्ष तक सीमित करता है।

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}