Kontakte auflisten
Das Adressbuch des Workspace, zuletzt gesehene zuerst, Kontakte, an die nie Mail ging, zuletzt. Jeder Schlüssel des Workspace liest dieselben Zeilen; ein Kontakt, den ein Mitglied speichert, ist daher ein Kontakt, den jedes Mitglied und jeder Schlüssel sieht. Die Seitenaufteilung erfolgt per Keyset: `limit` reicht bis 200, Standardwert ist 50, 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
Das Adressbuch des Workspace, zuletzt gesehene zuerst, Kontakte, an die nie Mail ging, zuletzt. Jeder Schlüssel des Workspace liest dieselben Zeilen; ein Kontakt, den ein Mitglied speichert, ist daher ein Kontakt, den jedes Mitglied und jeder Schlüssel sieht. Die Seitenaufteilung erfolgt per Keyset: limit reicht bis 200, Standardwert ist 50, und nextCursor geht als cursor zurück, solange hasMore true ist.
Beispiel
Erfordert contacts:read.
curl "$OE/contacts?limit=50" -H "$AUTH"{ "object": "list", "data": [ { "object": "contact", "email": "[email protected]", "name": "Ada Lovelace", "source": "auto", "notes": null, "lastSeenAt": "2026-08-29T08:19:08.000Z", "createdAt": "2026-08-01T10:00:00.000Z", "updatedAt": "2026-08-29T08:19:08.000Z" } ], "hasMore": false, "nextCursor": null}source ist manual, wenn jemand die Adresse gespeichert hat, in der App oder über POST /contacts, und auto, wenn sie erfasst wurde, weil ein Mitglied aus dem Composer Mail an sie gesendet hat. Das sind inhaltlich verschiedene Aussagen (auto belegt Korrespondenz, manual belegt Absicht) und eine Verzweigung wert.
Sortiert wird nach lastSeenAt absteigend mit nulls zuletzt, danach neueste zuerst. Ein gerade angelegter Kontakt hat kein lastSeenAt und landet am Ende statt oben.
Das Adressbuch gehört dem Workspace und nicht demjenigen, der eine Zeile gespeichert hat. Eingehende Mail von einer Adresse legt nichts an.