API

파일 나열

메일함이 보관하는 보내고 받은 모든 첨부 파일.

GETapi.openemail.uk/files

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

GET /files

메일함이 보관하는 보내고 받은 모든 첨부 파일.

예제

파일은 함께 온 메일의 일부이므로 threads:read가 필요합니다. q는 이름과 유형을 검색하고, kind는 image, pdf, audio, video, text 중 하나를 남기며, sort는 newest, oldest, largest, name 중 하나입니다.

curl

curl "$OE/files?kind=pdf&sort=largest" -H "$AUTH"

응답

{  "object": "list",  "data": [{      "object": "file",      "id": "file_6bb640f5b99e47deb758f1f5",      "filename": "invoice-0912.pdf",      "mimeType": "application/pdf",      "sizeBytes": 184233,      "direction": "inbound",      "threadId": "thread_2f9b…",      "messageId": "<CAF7x…@mail.gmail.com>",      "deliveredTo": "[email protected]",      "createdAt": "2026-09-12T08:41:03.000Z"    }],  "hasMore": false,  "nextCursor": null}

특정 주소나 도메인으로 제한된 키는 그곳으로 들어온 파일만 봅니다. 스레드 목록과 같은 경계입니다. 삭제된 파일은 나열되지 않습니다.

인덱스는 출시된 날부터 시작됩니다. 그 전의 첨부 파일은 여전히 메시지에 붙어 있으며, GET /threads/{id}/messages/{messageId}/attachments가 읽습니다.

커서는 발급된 정렬 순서대로 이어지며, 다른 sort로 발급된 커서는 400 invalid_cursor입니다.