Lister les contacts
Le carnet d'adresses de l'espace de travail, les contacts les plus récemment vus d'abord, et en dernier ceux à qui rien n'a jamais été envoyé. Toutes les clés de l'espace de travail lisent les mêmes lignes : un contact enregistré par un membre est donc un contact que voient tous les membres et toutes les clés. La pagination se fait par keyset : `limit` monte jusqu'à 200 et vaut 50 par défaut, et `nextCursor` se renvoie comme `cursor` tant que `hasMore` vaut true.
Exécute le véritable appel sur votre espace de travail, avec votre propre clé.
GET /contacts
Le carnet d'adresses de l'espace de travail, les contacts les plus récemment vus d'abord, et en dernier ceux à qui rien n'a jamais été envoyé. Toutes les clés de l'espace de travail lisent les mêmes lignes : un contact enregistré par un membre est donc un contact que voient tous les membres et toutes les clés. La pagination se fait par keyset : limit monte jusqu'à 200 et vaut 50 par défaut, et nextCursor se renvoie comme cursor tant que hasMore vaut true.
Exemple
Nécessite 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 vaut manual quand quelqu'un a enregistré l'adresse, dans l'application ou via POST /contacts, et auto quand elle a été consignée parce qu'un membre lui a écrit depuis la fenêtre de rédaction. Ce sont deux affirmations matériellement différentes (auto atteste d'une correspondance, manual atteste d'une intention) et il vaut la peine de les traiter séparément.
Le tri se fait sur lastSeenAt décroissant, valeurs null en dernier, puis du plus récent au plus ancien. Un contact que vous venez de créer n'a pas de lastSeenAt et se retrouve à la fin plutôt qu'en tête.
Le carnet appartient à l'espace de travail, et non à celui qui a enregistré une ligne. Un message reçu depuis une adresse ne crée rien.