Unterhaltungen mit einem Kontakt auflisten
Jeder Thread, den die Adresse geschrieben hat oder an sie ging, in jedem Ordner: der Tab Mail bei einem Kontakt in der App. Die Adresse muss kein gespeicherter Kontakt sein. `limit` reicht bis 100 und ist standardmäßig 25, und `nextCursor` geht als `cursor` zurück, solange `hasMore` true ist.
Führt den echten Aufruf gegen Ihren Workspace aus, mit Ihrem eigenen Schlüssel.
GET /contacts/{email}/threads
Jeder Thread, den die Adresse geschrieben hat oder an sie ging, in jedem Ordner: der Tab Mail bei einem Kontakt in der App. Die Adresse muss kein gespeicherter Kontakt sein. limit reicht bis 100 und ist standardmäßig 25, und nextCursor geht als cursor zurück, solange hasMore true ist.
Beispiel
Erfordert threads:read, weil es Mails liest und nicht den Kontakt.
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 sucht in diesen Threads mit der Suchsyntax des Postfachs. sort ist newest (der Standard), oldest, sender oder subject. Gib cursor mit denselben q und sort zurück.
Jede Zeile ist eine Zusammenfassung. GET /threads/{id} liest die Nachrichten dahinter.