پرش به مستندات
API

به‌روزرسانی یک فرم

یک به‌روزرسانی جزئی. `document` کل پیش‌نویس را جایگزین می‌کند، و فرم فعال تا وقتی منتشر نکنید همان نسخهٔ منتشرشده‌اش را نشان می‌دهد. `settings` فیلد به فیلد ادغام می‌شود و بی‌درنگ اعمال می‌شود.

PATCH/forms/{id}

فراخوانی واقعی را روی فضای کاری شما اجرا می‌کند.

PATCH /forms/{id}

یک به‌روزرسانی جزئی. document کل پیش‌نویس را جایگزین می‌کند، و فرم فعال تا وقتی منتشر نکنید همان نسخهٔ منتشرشده‌اش را نشان می‌دهد. settings فیلد به فیلد ادغام می‌شود و بی‌درنگ اعمال می‌شود.

نمونه

به forms:write نیاز دارد، و وقتی تأیید دوگانه را روشن کند، فرستنده‌ای تعیین کند یا ایمیل تأیید را تغییر دهد، به emails:send هم نیاز دارد. updatedAt را که خوانده‌اید به‌صورت expectedUpdatedAt بفرستید: اگر کسی در این میان فرم را ذخیره کرده باشد، تغییر شما رد می‌شود و روی تغییر او نوشته نمی‌شود.

curl
curl -X PATCH "$OE/forms/frm_3b9d2e7a1c4f80d56e2a9b14" -H "$AUTH" -H 'content-type: application/json' -d '{  "settings": { "successAction": "redirect", "redirectUrl": "https://acme.com/thanks" },  "expectedUpdatedAt": "2026-09-12T08:00:00.000Z"}'
پاسخ
{  "object": "form",  "id": "frm_3b9d2e7a1c4f80d56e2a9b14",  "name": "Newsletter sign-up",  "description": null,  "status": "live",  "url": "https://openemail.uk/form/frm_3b9d2e7a1c4f80d56e2a9b14",  "subscribeUrl": "https://api.openemail.uk/subscribe/frm_3b9d2e7a1c4f80d56e2a9b14",  "audienceIds": ["aud_4c1b8e2a7d9f05c36b4e8a71"],  "doubleOptIn": true,  "hasUnpublishedChanges": true,  "document": {    "fields": [      {        "id": "fld_k2m8q4w9z1x7",        "type": "email",        "key": "email",        "label": "Email",        "placeholder": "[email protected]",        "help": null,        "required": true,        "defaultValue": null,        "options": [],        "mapsTo": "email",        "width": "full",        "minLength": null,        "maxLength": null,        "min": null,        "max": null      }    ],    "copy": {      "title": "Join our list",      "description": "News from us, about once a month.",      "submitLabel": "Subscribe",      "successTitle": "You are on the list",      "successMessage": "Thanks for signing up.",      "pendingTitle": "Check your inbox",      "pendingMessage": "Open the email we sent and confirm to finish.",      "closedTitle": "This form is closed",      "closedMessage": "It is not taking new sign-ups right now.",      "footer": null    },    "style": {      "accent": "#18181b",      "background": "#f4f4f5",      "surface": "#ffffff",      "text": "#18181b",      "font": "system",      "radius": "md",      "width": "normal",      "layout": "card",      "align": "left",      "logoUrl": null    }  },  "publishedDocument": { "fields": ["…"], "copy": { "title": "Join the list" }, "style": { "accent": "#18181b" } },  "settings": {    "audienceIds": ["aud_4c1b8e2a7d9f05c36b4e8a71"],    "doubleOptIn": true,    "senderAddress": "[email protected]",    "confirmSubject": "Please confirm your subscription",    "confirmMessage": "Confirm your email address to start getting our messages.",    "confirmButton": "Confirm my subscription",    "successAction": "message",    "redirectUrl": null,    "notifyAddresses": ["[email protected]"]  },  "audiences": [{ "id": "aud_4c1b8e2a7d9f05c36b4e8a71", "name": "Newsletter", "builtin": false }],  "senderIssue": null,  "senderProblem": null,  "stats": { "views": 1840, "submissions": 212, "added": 198, "pending": 14, "lastSubmittedAt": "2026-09-30T16:42:11.000Z" },  "publishedAt": "2026-09-12T08:00:00.000Z",  "createdAt": "2026-09-10T14:20:00.000Z",  "updatedAt": "2026-09-12T08:00:00.000Z"}

یک expectedUpdatedAt کهنه 409 version_conflict است، و چیزی نوشته نمی‌شود. فرم را دوباره بخوانید و تغییر را از نو انجام دهید.

مقداری با شکل نادرست، مثلاً رنگی که #rrggbb نیست یا redirectUrl که نشانی http یا https نیست، 422 invalid_parameter است، یا برای کلیدی که بدنه نمی‌پذیرد unknown_parameter. قاعده‌ای که سند یا تنظیمات با هم زیر پا بگذارند 422 invalid_form است. هر دو فیلد را در param نام می‌برند، مثلاً document.fields.2.key یا settings.redirectUrl.

برای تغییر یک فیلد از سند، فرم را بخوانید، آن را تغییر دهید و کل document را برگردانید.

صندوق ورودی شما،
با شرایط خودتان.

زیرساخت ایمیل برای کسب‌وکارها، هوش مصنوعی، عامل‌ها و ایمیل شخصی. ساخته‌شده برای مقیاس، حریم خصوصی و کنترل. هر چه ایمیل باید از روز نخست می‌داشت.

© 2026 OpenEmail. همه حقوق محفوظ است.