API

ファイルを一覧にする

メールボックスが保持する送受信済みのすべての添付ファイル。

GETapi.openemail.uk/files

実際の呼び出しを、ご自身のキーで自分のワークスペースに対して実行します。

GET /files

メールボックスが保持する送受信済みのすべての添付ファイル。

例

ファイルは一緒に届いたメールの一部なので threads:read が必要。q は名前と種類を検索し、kind は image、pdf、audio、video、text のいずれかに絞り、sort は newest、oldest、largest、name のいずれか。

curl

curl "$OE/files?kind=pdf&sort=largest" -H "$AUTH"

レスポンス

{  "object": "list",  "data": [{      "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": "[email protected]",      "createdAt": "2026-09-12T08:41:03.000Z"    }],  "hasMore": false,  "nextCursor": null}

特定のアドレスやドメインに限定されたキーは、そこに届いたファイルしか見えない。スレッド一覧と同じ境界である。削除したファイルは一覧に出ない。

インデックスは提供開始の日から始まる。それより古い添付ファイルは今もメッセージに付いており、GET /threads/{id}/messages/{messageId}/attachments で読める。

カーソルは発行されたときの並び順で続き、別の sort で発行されたカーソルは 400 invalid_cursor になる。