The org's own files
Files the org has uploaded, newest first. `folder` narrows it; today the only folder in use is `email-attachments`.
Files the org has uploaded, newest first. folder narrows it; today the only folder in use is email-attachments.
API key (sk_live_... prefix). Generate keys in the UI under Settings > API Keys, then send it as Authorization: Bearer sk_live_...
In: header
Query Parameters
Which folder in the bucket to list.
Response Body
application/json
application/json
application/json
curl -X GET "https://loading/api/v1/org/documents"{
"data": [
{
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"folder": "string",
"filename": "string",
"mime_type": "string",
"size_bytes": -9007199254740991,
"created_at": "string"
}
]
}{
"error": "string",
"message": "string",
"statusCode": -9007199254740991
}{
"error": "module_required",
"module": "string",
"message": "string",
"contact": "string"
}Pull recent mail now POST
Fetches recent messages for this org's connected mailboxes and records anything new. The inbox calls it on open, because neither path that normally delivers a reply — the provider webhook or the periodic sync — runs on a developer machine, and a fresh deployment would otherwise show an empty inbox until the first scheduled tick. Idempotent: everything dedupes on the provider's message id.
Upload a file POST
Stores one file, as multipart form data, and returns its record. The id is what a send names in `document_ids`. Uploading is deliberately its own step: a large file is already up by the time the message is written, and a refused send does not cost the upload twice. Capped at 25MB, which is the ceiling email itself imposes.