API

Retrieve a file

One file, by id.

GETapi.openemail.uk/files/{id}

Runs the real call against your workspace, with your own key.

GET /files/{id}

One file, by id.

Example

Needs threads:read.

curl

curl "$OE/files/file_6bb640f5b99e47deb758f1f5" -H "$AUTH"

Response

{  "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"}

A deleted file, one outside the addresses a narrowed key holds, and an unknown id all answer 404.