API

連絡先との会話を一覧にする

そのアドレスが書いた、またはそのアドレス宛に書かれたすべてのスレッドを、すべてのフォルダーから返します。アプリの連絡先にあるメールタブです。アドレスは保存済みの連絡先でなくてもかまいません。`limit` は最大 100、既定値は 25 で、`hasMore` が true のあいだ `nextCursor` を `cursor` として渡してください。

GETapi.openemail.uk/contacts/{email}/threads

実際の呼び出しを、ご自身のキーで自分のワークスペースに対して実行します。

GET /contacts/{email}/threads

そのアドレスが書いた、またはそのアドレス宛に書かれたすべてのスレッドを、すべてのフォルダーから返します。アプリの連絡先にあるメールタブです。アドレスは保存済みの連絡先でなくてもかまいません。limit は最大 100、既定値は 25 で、hasMore が true のあいだ nextCursor を cursor として渡してください。

例

threads:read が必要です。連絡先ではなくメールを読むからです。

curl

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} でその中のメッセージを読みます。