Skip to the documentation
SDK

Files

`files.list`, `listAll`, `iterate`, `get`, `download`, `listLinks`, `listAllLinks`, `iterateLinks` and `delete`.

Every method

files.ts
import { writeFile } from 'node:fs/promises' const page = await openemail.files.list({ kind: 'pdf', sort: 'largest' })const file = page.items[0]! await writeFile(file.filename, await openemail.files.download(file.id)) const links = await openemail.files.listAllLinks(file.id)console.log(links.map((link) => [link.url, link.downloads])) await openemail.files.delete(file.id)

Every attachment the mailbox holds, sent and received, the Files page of the app. download resolves with the bytes as a Uint8Array, and the links are the download links a large attachment went out as, with how often each was fetched.

Reading needs threads:read and deleting needs threads:write, and only the workspace owner may delete. A key limited to particular addresses or domains sees only the files that arrived at them.