Settings

Patch a form's settings

Update one or more operational settings. The request body IS the settings patch object, validated and saved by the same writer as the dashboard; any key set to null is cleared. Scope: settings:manage — plus forms:write whenever the patch names one of the six presentation keys (submitMode, submitLabel, successTitle, successMessage, redirectUrl, showProgress), which live inside the form schema rather than beside it. The 403 names the missing scope.

patch/api/v1/manage/forms/{form}/settings

Request

  • Base URL: https://fillo.so
  • URL: https://fillo.so/api/v1/manage/forms/{form}/settings
  • Auth: HTTP bearer

Path parameters

formstring required

A form id or slug.

Request body

FormSettings required

A partial FormSettings patch (see @usefillo/core FormSettings): booleans such as notifyEmailIncludeAnswers, sendReceipt, saveProgress, draftAnswersVisible, resumeEmails, and draftDigest; strings such as notifyEmail, notifyEmailReplyToField, and resumeUrl; an array notifyEmailAnswerFields; and objects such as responseLimit and trust. Any key set to null is cleared. Six of the keys are not operational settings but part of the form's definition — submitMode, submitLabel, successTitle, successMessage, redirectUrl, and showProgress live inside the form schema: patching any of them additionally requires forms:write, and code-managed forms reject them outright.

Response

The updated settings.

settingsFormSettings required

A partial FormSettings patch (see @usefillo/core FormSettings): booleans such as notifyEmailIncludeAnswers, sendReceipt, saveProgress, draftAnswersVisible, resumeEmails, and draftDigest; strings such as notifyEmail, notifyEmailReplyToField, and resumeUrl; an array notifyEmailAnswerFields; and objects such as responseLimit and trust. Any key set to null is cleared. Six of the keys are not operational settings but part of the form's definition — submitMode, submitLabel, successTitle, successMessage, redirectUrl, and showProgress live inside the form schema: patching any of them additionally requires forms:write, and code-managed forms reject them outright.

Changes

No recorded changes to this operation across all 1 revision of this API.