خالی‌کردن سطل زباله یا هرزنامه

همهٔ نامه‌های پوشهٔ `trash` یا `spam` را برای همیشه حذف می‌کند.

POSThttps://api.irnoti.com/v1/email/messages/empty

scope: email.manage

این کار بازگشت‌پذیر نیست. بدون mailboxId روی همهٔ صندوق‌های شما اعمال می‌شود.

پارامترها

نام	محل	نوع	توضیح
folder *	بدنه	string	`trash` یا `spam`.
mailboxId	بدنه	string	فقط یک صندوق.

خطاهای خاص این endpoint

401	unauthorized	کلید API نامعتبر یا منقضی است.
403	insufficient_scope	کلید API دامنهٔ دسترسی لازم را ندارد.

اجرای زنده (محیط تست)

باز کردن در کنسول کامل ←

این endpoint در محیط تست پشتیبانی نمی‌شود؛ برای اجرا، کلید واقعی را در حالت «اجرای واقعی» وارد کنید.

→ قبلی

ذخیرهٔ پیش‌نویس

بعدی ←

همگام‌سازی فوری صندوق

curl -X POST 'https://api.irnoti.com/v1/email/messages/empty' \
  -H "Authorization: Bearer $IRNOTI_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "folder": "spam"
}'

پاسخ نمونه200 OK

{
  "removed": 14
}