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.