فهرست گفتوگوها با یک مخاطب
هر رشتهای که نشانی نوشته یا به آن نوشته شده است، در همهٔ پوشهها: زبانهٔ نامه روی یک مخاطب در برنامه. نشانی لازم نیست مخاطب ذخیرهشده باشد. `limit` تا ۱۰۰ است و پیشفرضش ۲۵، و تا وقتی `hasMore` برابر true است، `nextCursor` بهعنوان `cursor` برمیگردد.
فراخوانی واقعی را با کلید خودتان روی فضای کاری شما اجرا میکند.
GET /contacts/{email}/threads
هر رشتهای که نشانی نوشته یا به آن نوشته شده است، در همهٔ پوشهها: زبانهٔ نامه روی یک مخاطب در برنامه. نشانی لازم نیست مخاطب ذخیرهشده باشد. limit تا ۱۰۰ است و پیشفرضش ۲۵، و تا وقتی hasMore برابر true است، nextCursor بهعنوان cursor برمیگردد.
نمونه
به threads:read نیاز دارد، چون نامهها را میخواند نه مخاطب را.
curl "$OE/contacts/ada%40example.com/threads?q=invoice&sort=newest" -H "$AUTH"{ "object": "list", "data": [ { "object": "thread", "id": "thr_5d31c2a8…", "subject": "Invoice 2026-09", "from": { "name": "Ada Lovelace", "email": "[email protected]" }, "receivedAt": "2026-09-22T16:04:11.000Z", "messageCount": 3, "hasUnread": true, "labels": [{ "id": "INBOX", "name": "Inbox" }] } ], "hasMore": false, "nextCursor": null}q درون آن رشتهها با نحو جستوجوی صندوق جستوجو میکند. sort یکی از newest (پیشفرض)، oldest، sender یا subject است. cursor را با همان q و sort برگردانید.
هر ردیف یک خلاصه است. GET /threads/{id} پیامهای پشت آن را میخواند.