ویرایش صندوق

نام نمایشی، امضا، پاسخ خودکار، تخصیص به همکار و سهمیهٔ فضا را تغییر می‌دهد.

PATCHhttps://api.irnoti.com/v1/email/mailboxes/{id}

scope: email.manage

فقط فیلدهای ارسال‌شده تغییر می‌کنند. با null می‌توان امضا یا پاسخ خودکار را پاک کرد. پاسخ خودکار به خبرنامه‌ها و ربات‌ها فرستاده نمی‌شود. quotaMb از سقف بسته بیشتر نمی‌شود؛ برای فضای بیشتر افزونهٔ فضا بخرید.

پارامترها

نام	محل	نوع	توضیح
id *	مسیر	string	شناسهٔ صندوق.
displayName	بدنه	string \| null	نام نمایشی.
signature	بدنه	string \| null	امضای خودکار (حداکثر ۵۰۰۰ نویسه).
autoReply	بدنه	object \| null	`{enabled, subject, body, until?}`.
assigneeUserId	بدنه	string \| null	شناسهٔ همکاری که صندوق به او تخصیص می‌یابد.
quotaMb	بدنه	number	سهمیهٔ فضا (۵۰ تا ۱٬۰۰۰٬۰۰۰ مگابایت).
portalEnabled	بدنه	boolean	دسترسی به وب‌میل.

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

401	unauthorized	کلید API نامعتبر یا منقضی است.
403	insufficient_scope	کلید API دامنهٔ دسترسی لازم را ندارد.
404	not_found	صندوق پیدا نشد یا متعلق به شما نیست.
400	validation_error	ورودی نامعتبر است؛ خطای هر فیلد در `details` آمده است.

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

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

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

→ قبلی

تنظیمات اتصال نرم‌افزار ایمیل

بعدی ←

رمز جدید صندوق

curl -X PATCH 'https://api.irnoti.com/v1/email/mailboxes/12' \
  -H "Authorization: Bearer $IRNOTI_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "autoReply": {
    "body": "تا شنبه پاسخ می‌دهیم.",
    "until": "2026-10-31",
    "enabled": true,
    "subject": "خارج از دفتر"
  },
  "displayName": "تیم فروش"
}'

پاسخ نمونه200 OK

{
  "id": "12",
  "kind": "hosted",
  "status": "active",
  "address": "sales@example.ir",
  "quotaMb": 2048,
  "lastError": null,
  "usedBytes": 5242880,
  "lastSyncAt": "2026-10-24T08:30:00.000Z",
  "displayName": "فروش"
}