API

Lister les fichiers

Chaque pièce jointe que contient la boîte aux lettres, envoyée et reçue.

GETapi.openemail.uk/files

Exécute le véritable appel sur votre espace de travail, avec votre propre clé.

GET /files

Chaque pièce jointe que contient la boîte aux lettres, envoyée et reçue.

Exemple

Nécessite threads:read, car un fichier fait partie du courrier avec lequel il est arrivé. q cherche dans le nom et le type, kind garde image, pdf, audio, video ou text, et sort vaut newest, oldest, largest ou name.

curl

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

Réponse

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

Une clé limitée à certaines adresses ou certains domaines ne voit que les fichiers arrivés à ceux-ci, la même frontière que la liste des fils. Un fichier supprimé n'est pas listé.

L'index commence le jour de sa mise en service. Les pièces jointes plus anciennes restent sur leurs messages, où GET /threads/{id}/messages/{messageId}/attachments les lit.

Un curseur poursuit dans l'ordre sous lequel il a été remis, et un curseur remis sous un autre sort donne un 400 invalid_cursor.