FormSettingsEnvelope

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/fillo-so/json-schema/fillo-so-form-settings-envelope-schema.json",
  "title": "FormSettingsEnvelope",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/fillo-so-settings-api-openapi.yml#/components/schemas/FormSettingsEnvelope",
  "type": "object",
  "required": [
    "settings"
  ],
  "properties": {
    "settings": {
      "$ref": "#/$defs/FormSettings"
    }
  },
  "$defs": {
    "FormSettings": {
      "type": "object",
      "description": "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.",
      "additionalProperties": true
    }
  }
}