Skip to the documentation
API

Retrieve a file

One file, by id.

GET/files/{id}

Runs the real call on your workspace.

GET /files/{id}

One file, by id.

Example

Needs files:read.

curl
curl "$OE/files/file_6bb640f5b99e47deb758f1f5" -H "$AUTH"
Response
{  "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": "billing@acme.com",  "usage": "received",  "deletable": false,  "createdAt": "2026-09-12T08:41:03.000Z"}

A deleted file, one outside the addresses a narrowed key holds, and an unknown id all answer 404.

Reference