API

Listar as conversas com um contacto

Cada conversa que o endereço escreveu ou em que lhe escreveram, em todas as pastas: o separador Correio de um contacto na app. O endereço não tem de ser um contacto guardado. `limit` vai até 100 e vale 25 por omissão, e `nextCursor` volta como `cursor` enquanto `hasMore` for true.

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

Executa a chamada real contra o seu espaço de trabalho, com a sua própria chave.

GET /contacts/{email}/threads

Cada conversa que o endereço escreveu ou em que lhe escreveram, em todas as pastas: o separador Correio de um contacto na app. O endereço não tem de ser um contacto guardado. limit vai até 100 e vale 25 por omissão, e nextCursor volta como cursor enquanto hasMore for true.

Exemplo

Requer threads:read, porque lê correio e não o contacto.

curl

curl "$OE/contacts/ada%40example.com/threads?q=invoice&sort=newest" -H "$AUTH"

Resposta

{  "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 pesquisa dentro dessas conversas com a sintaxe de pesquisa da caixa. sort é newest (por omissão), oldest, sender ou subject. Devolva cursor com os mesmos q e sort.

Cada linha é um resumo. GET /threads/{id} lê as mensagens por trás dela.