Listar archivos
Cada adjunto que guarda el buzón, enviado y recibido.
Ejecuta la llamada real contra tu espacio de trabajo, con tu propia clave.
GET /files
Cada adjunto que guarda el buzón, enviado y recibido.
Ejemplo
Necesita threads:read, porque un archivo forma parte del correo con el que llegó. q busca en el nombre y el tipo, kind conserva image, pdf, audio, video o text, y sort es newest, oldest, largest o name.
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}Una clave limitada a direcciones o dominios concretos solo ve los archivos que llegaron a ellos, el mismo límite que usa la lista de conversaciones. Un archivo eliminado no aparece.
El índice empieza el día en que se lanzó. Los adjuntos más antiguos siguen en sus mensajes, donde los lee GET /threads/{id}/messages/{messageId}/attachments.
Un cursor continúa en el orden en que se entregó, y uno entregado con otro sort es un 400 invalid_cursor.