فهرست فایلها
هر پیوستی که صندوق پستی نگه میدارد، فرستاده و دریافتشده.
فراخوانی واقعی را با کلید خودتان روی فضای کاری شما اجرا میکند.
GET /files
هر پیوستی که صندوق پستی نگه میدارد، فرستاده و دریافتشده.
نمونه
به threads:read نیاز دارد، چون فایل بخشی از نامهای است که با آن آمده. q در نام و نوع جستوجو میکند، kind یکی از image، pdf، audio، video یا text را نگه میدارد، و sort یکی از newest، oldest، largest یا name است.
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 است.