API

Listar ficheiros

Cada anexo que a caixa de correio guarda, enviado e recebido.

GETapi.openemail.uk/files

Executa a chamada real contra o seu espaço de trabalho, com a sua própria chave.

GET /files

Cada anexo que a caixa de correio guarda, enviado e recebido.

Exemplo

Precisa de threads:read, porque um ficheiro faz parte do correio com que chegou. q pesquisa o nome e o tipo, kind mantém image, pdf, audio, video ou text, e sort é newest, oldest, largest ou name.

curl

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

Resposta

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

Uma chave limitada a determinados endereços ou domínios só vê os ficheiros que chegaram a eles, a mesma fronteira que a lista de conversas usa. Um ficheiro eliminado não é listado.

O índice começa no dia em que foi lançado. Os anexos mais antigos continuam nas suas mensagens, onde GET /threads/{id}/messages/{messageId}/attachments os lê.

Um cursor continua na ordem em que foi entregue, e um entregue com outro sort é um 400 invalid_cursor.