ویرایش قانون

فقط فیلدهای ارسال‌شده تغییر می‌کنند.

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

scope: email.manage

پاسخ موفق 204 است.

پارامترها

نام	محل	نوع	توضیح
id *	مسیر	string	شناسهٔ قانون.
name	بدنه	string	نام قانون.
mailboxId	بدنه	string \| null	فقط یک صندوق؛ null یعنی همه.
matchAll	بدنه	boolean	true یعنی همهٔ شرط‌ها (و)، false یعنی هرکدام (یا). پیش‌فرض true.
conditions	بدنه	object[]	`{field, op, value?}`؛ field: from، to، subject، body، hasAttachment، category؛ op: contains، equals، startsWith، endsWith، not_contains، is_true (حداکثر ۱۰).
actions	بدنه	object[]	یکی از: `{type:"move",folder}`، `{type:"label",labelId}`، `markRead`، `star`، `{type:"forward",to}`، `{type:"category",category}`، `stop` (حداکثر ۱۰).
sort	بدنه	number	ترتیب اجرا؛ کوچک‌تر زودتر.
enabled	بدنه	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/rules/2' \
  -H "Authorization: Bearer $IRNOTI_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "enabled": false
}'

پاسخ نمونه200 OK

{}