문서로 건너뛰기
API

연락처와의 대화 목록

그 주소가 쓰거나 그 주소로 쓴 모든 스레드를 모든 폴더에서 돌려줍니다. 앱에서 연락처의 메일 탭입니다. 주소는 저장된 연락처가 아니어도 됩니다. `limit`은 최대 100이고 기본값은 25이며, `hasMore`가 true인 동안 `nextCursor`를 `cursor`로 다시 보냅니다.

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

본인 키로 워크스페이스에 실제 호출을 실행합니다.

GET /contacts/{email}/threads

그 주소가 쓰거나 그 주소로 쓴 모든 스레드를 모든 폴더에서 돌려줍니다. 앱에서 연락처의 메일 탭입니다. 주소는 저장된 연락처가 아니어도 됩니다. limit은 최대 100이고 기본값은 25이며, hasMore가 true인 동안 nextCursorcursor로 다시 보냅니다.

예시

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는 메일함 검색 문법으로 그 스레드 안을 검색합니다. sortnewest(기본값), oldest, sender, subject 중 하나입니다. cursor는 같은 q, sort와 함께 다시 보냅니다.

각 행은 요약입니다. GET /threads/{id}로 그 뒤의 메시지를 읽습니다.