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

برای صندوق سازمانی رمز تازه می‌سازد (یا رمز دلخواه شما را می‌گذارد) و همان‌جا یک‌بار برمی‌گرداند.

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

scope: email.manage

رمز فقط روی سرور ایمیل به‌صورت هش ذخیره می‌شود و دوباره قابل‌نمایش نیست. نرم‌افزارهای ایمیل کارمند باید با رمز جدید دوباره وارد شوند. رمز دلخواه حداقل ۱۰ نویسه است.

پارامترها

نام	محل	نوع	توضیح
id *	مسیر	string	شناسهٔ صندوق.
password	بدنه	string	رمز دلخواه؛ اگر نباشد رمز تصادفی ساخته می‌شود.

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

401	unauthorized	کلید API نامعتبر یا منقضی است.
403	insufficient_scope	کلید API دامنهٔ دسترسی لازم را ندارد.
403	feature_disabled	قابلیت ایمیل (یا ایمیل سازمانی `email.hosted`) برای حساب شما فعال نیست.
404	not_found	صندوق پیدا نشد یا متعلق به شما نیست.

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

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

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

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

پاسخ نمونه200 OK

{
  "password": "Qx7-mT2pVn9aLc4e"
}