عملیات روی نامه‌ها

خوانده/ستاره/انتقال/حذف/هرزنامه/برچسب برای چند نامه.

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

scope: email.manage

action: read unread star unstar trash delete spam notspam archive inbox move label unlabel. delete در سطل زباله برای همیشه حذف می‌کند و در غیر آن به سطل می‌برد. تغییر روی سرور ایمیل هم اعمال می‌شود تا سایر برنامه‌ها هماهنگ بمانند.

پارامترها

نام	محل	نوع	توضیح
ids *	بدنه	string[]	تا ۵۰۰ شناسه.
action *	بدنه	string	یکی از عملیات بالا.
folder	بدنه	string	برای `move`.
labelId	بدنه	string	برای `label` و `unlabel`.

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

401	unauthorized	کلید API نامعتبر یا منقضی است.
403	feature_disabled	قابلیت ایمیل (یا دامنهٔ دسترسی لازم) برای کلید/حساب شما فعال نیست.

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

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

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

curl -X POST 'https://api.irnoti.com/v1/email/messages/actions' \
  -H "Authorization: Bearer $IRNOTI_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "ids": [
    "9001",
    "9002"
  ],
  "action": "archive"
}'

پاسخ نمونه200 OK

{
  "affected": 2
}