लोगों की सूची
वे सभी जिन्हें ऐप का संपर्क पेज सूचीबद्ध करता है: सहेजे गए संपर्क, और किसी थ्रेड के सबसे नए संदेश के प्रेषक या प्राप्तकर्ता के रूप में मेल में दिखा हर पता, साथ में यह कि हर एक मेलबॉक्स के साथ कितने थ्रेड साझा करता है और आख़िरी मेल कब आया-गया। जो व्यक्ति मेल में दिखा और सहेजा भी गया है वह एक ही पंक्ति है। पेजिंग कीसेट आधारित है: `limit` अधिकतम 100 और डिफ़ॉल्ट 25 है, और जब तक `hasMore` true है, `nextCursor` को `cursor` के रूप में वापस भेजें।
असली कॉल आपकी अपनी कुंजी से आपके वर्कस्पेस पर चलाता है।
GET /contacts/people
वे सभी जिन्हें ऐप का संपर्क पेज सूचीबद्ध करता है: सहेजे गए संपर्क, और किसी थ्रेड के सबसे नए संदेश के प्रेषक या प्राप्तकर्ता के रूप में मेल में दिखा हर पता, साथ में यह कि हर एक मेलबॉक्स के साथ कितने थ्रेड साझा करता है और आख़िरी मेल कब आया-गया। जो व्यक्ति मेल में दिखा और सहेजा भी गया है वह एक ही पंक्ति है। पेजिंग कीसेट आधारित है: limit अधिकतम 100 और डिफ़ॉल्ट 25 है, और जब तक hasMore true है, nextCursor को cursor के रूप में वापस भेजें।
उदाहरण
contacts:read चाहिए। मेल में दिखे पते तभी शामिल होते हैं जब कुंजी के पास threads:read भी हो।
curl "$OE/contacts/people?sort=threads&limit=25" -H "$AUTH"{ "object": "list", "data": [ { "object": "person", "email": "[email protected]", "displayEmail": "[email protected]", "name": "Ada Lovelace", "saved": true, "source": "manual", "notes": "Met at the engine demo", "photoUrl": null, "threads": 42, "lastAt": "2026-09-22T16:04:11.000Z", "createdAt": "2026-08-01T10:00:00.000Z", "updatedAt": "2026-09-01T09:12:00.000Z", "blockedBy": null }, { "object": "person", "email": "[email protected]", "displayEmail": "[email protected]", "name": "Shop", "saved": false, "source": null, "notes": null, "photoUrl": null, "threads": 17, "lastAt": "2026-09-21T07:30:00.000Z", "createdAt": null, "updatedAt": null, "blockedBy": { "rule": "shop.example", "list": "blockedDomains" } } ], "hasMore": true, "nextCursor": "WyIyMDI2LTA5LTIxVDA3OjMwOjAwLjAwMFoiLDE3XQ", "seen": true}sort में recent (डिफ़ॉल्ट) सबसे नया मेल पहले और मेल में कभी न दिखे सहेजे गए संपर्क उसके बाद, name नाम से या नाम न हो तो पते से, बड़े-छोटे अक्षरों का भेद किए बिना, या threads सबसे ज़्यादा थ्रेड वाले पहले। बराबरी पर पता तय करता है, इसलिए पूरी सूची पढ़ते समय कोई पंक्ति न दोहराई जाती है न छूटती है।
q नाम, पते और नोट्स में खोजता है। email एक ही पता पढ़ता है, किसी एक व्यक्ति की थ्रेड संख्या और आख़िरी मेल पाने का यही तरीका है। blocked=true केवल उन लोगों को लौटाता है जिन्हें वर्कस्पेस की ब्लॉक सूची ब्लॉक करती है, पूरे डोमेन के नियमों सहित, और blockedBy हर पंक्ति पर नियम बताता है।
threads:read के बिना पंक्तियाँ केवल सहेजे गए संपर्क होती हैं और seen false होता है, क्योंकि बाकी मेल से पढ़ा जाता है। हटाए गए पते और मेलबॉक्स के अपने पते कभी सूचीबद्ध नहीं होते। कर्सर अपारदर्शी है: उसे उन्हीं sort, q और blocked के साथ वापस भेजें, और जो कर्सर दिया ही नहीं गया वह 400 invalid_cursor है।