Files

from pathlib import Path from openemail import openemail page = openemail.files.list(kind='pdf', sort='largest')file = page['items'][0] Path(file['filename']).write_bytes(openemail.files.download(file['id'])) links = openemail.files.list_all_links(file['id'])print([(link['url'], link['downloads']) for link in links]) stats = openemail.files.stats()print(stats['totals']['files'], stats['uploaded']['bytes'])

Every file the mailbox holds, attachments sent and received and the files uploaded to it, the Files page of the app. download returns the whole file as bytes, the links are the download links a file went out as, with how often each was fetched, and stats is the Analytics tab.

list, list_all and iterate take q, kind and sort, and also direction (inbound, outbound or uploaded), address, the files of one address compared without regard to case, and since and until, a datetime or an ISO 8601 string. since includes its moment and until stops before it.

from openemail import openemail uploads = openemail.files.list_all(direction='uploaded', since='2026-09-01') file = uploads[0] link = openemail.files.create_link(file['id'], domain='acme.com')print(link['url']) openemail.files.revoke_link(file['id'], link['id'])

create_link publishes a file at a public download link that opens with no sign-in and returns it. The link lives on the files host of domain when that domain has one, such as files.acme.com, else on the files host of the address the file belongs to, else on the API address. A file that came in or went out on a message is copied to public storage first, and a program or a script is refused with 422 file_unshareable.

from pathlib import Path from openemail import openemail upload = openemail.files.upload(    Path('price-list.pdf').read_bytes(),    filename='price-list.pdf',    content_type='application/pdf',) if upload['deletable']:    openemail.files.delete(upload['id']) result = openemail.files.delete_many([    'file_0c4e7a91d2b84f63a5e19b7d',    'file_6bb640f5b99e47deb758f1f5',])for kept in result['kept']:    print(kept['filename'], kept['reason'])

upload stores the bytes as they are, up to 100 MB, under filename, and returns the file, whose id a send attaches as {'fileId': upload['id']}. Pass content_type, or the bytes are stored as application/octet-stream. It is never retried, because a second attempt would store a second copy.

• files.list()Full reference
• files.list_all()Full reference
• files.iterate()Full reference
• files.get()Full reference
• files.download()Full reference
• files.list_links()Full reference
• files.list_all_links()Full reference
• files.iterate_links()Full reference
• files.create_link()Full reference
• files.revoke_link()Full reference
• files.stats()Full reference
• files.upload()Full reference
• files.delete()Full reference
• files.delete_many()Full reference