Files

Every file that passed through the account, and how much space it uses.

Scope: files

Deleting is destructive: the stored object is removed and a message that referenced it shows a broken attachment afterwards.

📄️List files

Files in the warehouse, newest first — attachments customers sent in, files agents sent out, and uploads from forms and knowledge bases.

📄️Get storage statistics

Total files and bytes stored, against the plan's storage quota, broken down by

📄️Get a file

One file's metadata with a short-lived signed `download_url`. The URL expires within the hour and is minted per request — fetch a fresh one rather than storing it.

📄️Delete a file

Delete one file. The stored object goes with it and cannot be recovered.

📄️Delete many files

Delete up to 100 files in one call.