Added value: +{
+  "description": "Same as create_form questions[].rateStyle.",
+  "enum": [
+    "star",
+    "number"
+  ],
+  "type": "string"
+}

Removed value: -{
-  "description": "Same as create_form questions[].collectOnly.",
-  "type": "boolean"
-}

Previous value: -"FIELD APPLICABILITY — `type` is the only field the schema always requires; `type` (plus the form scene) decides which of the remaining fields apply, and one that does not apply is either rejected with an explanatory error or ignored, so never pass it. Breaker (page break) takes nothing but `type`. Display blocks collect no answer, are never scored and are allowed in every scene: Statement takes `content` (the rich text IS the block) and Swiper takes `items` (an image carousel); both also accept an optional `name`, a label used by the web editor only, and neither takes any question field. Every question type takes `name` (required) plus the optional `code` / `description` / `explain` / `required`. Type-specific fields: SingleCheck / MultiCheck / DropDown / Ordering / Cascade need `choices` (Cascade nests via choices[i].children; DropDown also takes `multiple`; Ordering also takes `shuffle`); TrueFalse has a fixed pair of options and takes `trueLabel` / `falseLabel` instead of `choices`; DateField / TimeField take `precision`; NumberField takes `min` / `max` / `unit` / `decimalPlaces`; Rate takes `steps` / `words`. Scene rules for scoring: quiz — `correctAnswer` plus `score` > 0 are REQUIRED on SingleCheck / MultiCheck / DropDown / Ordering, optional on FillBlank (add `aiMatch` to have AI grade it instead of exact string match) and NumberField (omit both and the question is just a data-collection field), and rejected on DateField / TimeField; scored_quiz — score each option via choices[i].score; `correctAnswer` / `score` are rejected on NumberField and Rate (the submitted value is the score) and on FillBlank (free text is collected only, never scored); outcome — nothing is scored: `correctAnswer` / `score` / `aiMatch` are all rejected, every choice needs `outcomes` (TrueFalse votes via `trueOutcomes` / `falseOutcomes`). Type availability per scene: Ordering is knowledge_quiz-only; FillBlank works in knowledge_quiz (optionally scored) and in scored_quiz (data-collection only — its answer never feeds a score or a report formula); Cascade, Rate, DateField and TimeField are scored_quiz-only; and the outcome_quiz scene accepts only SingleCheck / MultiCheck / DropDown / TrueFalse / Breaker."New value: +"Item fields, their per-type / per-scene rules and the question types themselves are exactly those of create_form questions[] — read the full field descriptions there."

Previous value: -"Only for FillBlank in the knowledge_quiz scene. Enables AI grading: the AI compares the respondent answer against correctAnswer and scores by accuracy, instead of requiring an exact string match. Requires correctAnswer (the standard answer) and score > 0 (the score earned when accuracy reaches the threshold). Pass an empty object {} to enable with default settings; omit for plain exact-match grading."New value: +"Same as create_form questions[].aiMatch."

Removed value: -"Accuracy threshold (0-100) at or above which the full score is awarded. Default 80."

Removed value: -"Optional partial-credit tiers for answers below the full-score threshold. Each {accuracy, score}: if the AI accuracy is below the threshold but >= this tier accuracy, this score is awarded. Tiers are matched from highest accuracy to lowest; if none match, the score is 0."

Removed value: -"Tier accuracy threshold (0-100)"

Removed value: -"Score awarded at this tier"

Previous value: -"Choice-based questions only (SingleCheck / MultiCheck / DropDown / Ordering / Cascade), where it is required; ignored for every other type, including TrueFalse — its two options come from trueLabel / falseLabel. Per-type limits: SingleCheck / MultiCheck 2-100 items — for a longer list use DropDown (2-300 items) instead; Ordering 2-10 items; Cascade nests via choices[i].children (up to 3 levels, at most 100 nodes in total). IMPORTANT (knowledge_quiz scene): vary the position of the correct option(s) across questions — do NOT always place the correct answer first. Distribute correct answers roughly evenly over all positions so they are not predictable."New value: +"Same as create_form questions[].choices."

Removed value: -"Cascade only: child options of this node (nesting up to 3 levels in total). Rejected for other question types."

Removed value: -"Cascade only: child options of this node (nesting up to 3 levels in total). Rejected for other question types."

Removed value: -"Optional stable identifier for this choice (option code). Omit to auto-generate. Same identifier rules as the question code; must be unique among the choices of this question. correctAnswer may reference a choice by its label or its code."

Removed value: -"scored_quiz scene only: the points this choice adds to each dimension when selected, as a map of dimension code → score, e.g. { \"dim_d\": 3, \"dim_i\": 1 }. Any choice carrying it switches the question to per-dimension scoring: for each dimension the question contributes the selected choices' scores for that dimension (a dimension not listed on the chosen choice counts 0), and a dimension without a formula automatically sums these contributions across questions. Codes must exist in report.dimensionAnalysis.dimensions — give dimensions[].code and reference them in the same create_form call. `score` remains the overall score fed to report.formula. Rejected in the knowledge_quiz / outcome_quiz scenes."

Removed value: -"Display text of the choice"

Removed value: -"Outcome scene only, and required there on every choice: the outcomes this choice votes for when selected (each code must exist in report.outcomes; a choice may vote for multiple outcomes). Use [] for a neutral choice that votes for nothing. Rejected in the knowledge_quiz / scored_quiz scenes. Each item is an outcome code (one vote) or { code, weight } to make this pick count more or less — e.g. { \"code\": \"lion\", \"weight\": 2 } for a question that should decide the result more than the others. The outcome with the most total votes wins."

Previous value: -[
-  {
-    "type": "string"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "code": {
-        "description": "Outcome code from report.outcomes",
-        "type": "string"
-      },
-      "weight": {
-        "description": "Votes this pick casts for the outcome; omit for 1. Decimals allowed, 0 = counts for nothing.",
-        "maximum": 100,
-        "minimum": 0,
-        "type": "number"
-      }
-    },
-    "required": [
-      "code"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "type": "string"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "code": {
+        "type": "string"
+      },
+      "weight": {
+        "maximum": 100,
+        "minimum": 0,
+        "type": "number"
+      }
+    },
+    "required": [
+      "code"
+    ],
+    "type": "object"
+  }
+]

Removed value: -"Used only in the scored_quiz scene; the score added when this choice is selected (generates partialScoring). For Cascade every node on the submitted path adds its score. Ignored in the knowledge_quiz scene; rejected in the outcome_quiz scene."

Removed value: -"Optional stable identifier for this choice (option code). Omit to auto-generate. Same identifier rules as the question code; must be unique among the choices of this question. correctAnswer may reference a choice by its label or its code."

Removed value: -"scored_quiz scene only: the points this choice adds to each dimension when selected, as a map of dimension code → score, e.g. { \"dim_d\": 3, \"dim_i\": 1 }. Any choice carrying it switches the question to per-dimension scoring: for each dimension the question contributes the selected choices' scores for that dimension (a dimension not listed on the chosen choice counts 0), and a dimension without a formula automatically sums these contributions across questions. Codes must exist in report.dimensionAnalysis.dimensions — give dimensions[].code and reference them in the same create_form call. `score` remains the overall score fed to report.formula. Rejected in the knowledge_quiz / outcome_quiz scenes."

Removed value: -"Display text of the choice"

Removed value: -"Outcome scene only, and required there on every choice: the outcomes this choice votes for when selected (each code must exist in report.outcomes; a choice may vote for multiple outcomes). Use [] for a neutral choice that votes for nothing. Rejected in the knowledge_quiz / scored_quiz scenes. Each item is an outcome code (one vote) or { code, weight } to make this pick count more or less — e.g. { \"code\": \"lion\", \"weight\": 2 } for a question that should decide the result more than the others. The outcome with the most total votes wins."

Previous value: -[
-  {
-    "type": "string"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "code": {
-        "description": "Outcome code from report.outcomes",
-        "type": "string"
-      },
-      "weight": {
-        "description": "Votes this pick casts for the outcome; omit for 1. Decimals allowed, 0 = counts for nothing.",
-        "maximum": 100,
-        "minimum": 0,
-        "type": "number"
-      }
-    },
-    "required": [
-      "code"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "type": "string"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "code": {
+        "type": "string"
+      },
+      "weight": {
+        "maximum": 100,
+        "minimum": 0,
+        "type": "number"
+      }
+    },
+    "required": [
+      "code"
+    ],
+    "type": "object"
+  }
+]

Removed value: -"Used only in the scored_quiz scene; the score added when this choice is selected (generates partialScoring). For Cascade every node on the submitted path adds its score. Ignored in the knowledge_quiz scene; rejected in the outcome_quiz scene."

Removed value: -"Optional stable identifier for this choice (option code). Omit to auto-generate. Same identifier rules as the question code; must be unique among the choices of this question. correctAnswer may reference a choice by its label or its code."

Removed value: -"scored_quiz scene only: the points this choice adds to each dimension when selected, as a map of dimension code → score, e.g. { \"dim_d\": 3, \"dim_i\": 1 }. Any choice carrying it switches the question to per-dimension scoring: for each dimension the question contributes the selected choices' scores for that dimension (a dimension not listed on the chosen choice counts 0), and a dimension without a formula automatically sums these contributions across questions. Codes must exist in report.dimensionAnalysis.dimensions — give dimensions[].code and reference them in the same create_form call. `score` remains the overall score fed to report.formula. Rejected in the knowledge_quiz / outcome_quiz scenes."

Removed value: -"Display text of the choice"

Removed value: -"Outcome scene only, and required there on every choice: the outcomes this choice votes for when selected (each code must exist in report.outcomes; a choice may vote for multiple outcomes). Use [] for a neutral choice that votes for nothing. Rejected in the knowledge_quiz / scored_quiz scenes. Each item is an outcome code (one vote) or { code, weight } to make this pick count more or less — e.g. { \"code\": \"lion\", \"weight\": 2 } for a question that should decide the result more than the others. The outcome with the most total votes wins."

Previous value: -[
-  {
-    "type": "string"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "code": {
-        "description": "Outcome code from report.outcomes",
-        "type": "string"
-      },
-      "weight": {
-        "description": "Votes this pick casts for the outcome; omit for 1. Decimals allowed, 0 = counts for nothing.",
-        "maximum": 100,
-        "minimum": 0,
-        "type": "number"
-      }
-    },
-    "required": [
-      "code"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "type": "string"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "code": {
+        "type": "string"
+      },
+      "weight": {
+        "maximum": 100,
+        "minimum": 0,
+        "type": "number"
+      }
+    },
+    "required": [
+      "code"
+    ],
+    "type": "object"
+  }
+]

Removed value: -"Used only in the scored_quiz scene; the score added when this choice is selected (generates partialScoring). For Cascade every node on the submitted path adds its score. Ignored in the knowledge_quiz scene; rejected in the outcome_quiz scene."

Previous value: -"Optional stable identifier for this question (field code). Omit it to let the server auto-generate one. Set a meaningful code (e.g. \"q1\") when report.formula or a dimension needs to reference this question, so you can write the formula as `{{q1}}` in the same call instead of round-tripping via get_form. Rules: start with a letter or underscore, then only letters/digits/underscores (no hyphens, spaces, or leading digit), at most 64 chars, and not a reserved math word (e, E, pi, PI, tau, phi, i, Infinity, NaN, true, false, null, undefined). Must be unique among all items in the form."New value: +"Same as create_form questions[].code."

Previous value: -"scored_quiz scene only, for SingleCheck / MultiCheck / DropDown / Cascade / TrueFalse / Rate: collect the answer as data without scoring it (e.g. age range, industry, how they heard about you). A collect-only question produces no score, cannot be referenced by report.formula or dimension formulas, and is shown with plain radio buttons / checkboxes instead of A/B/C letter badges. Do not pass any scoring input (choices[i].score, dimensionScores, score, correctAnswer) together with it. Rejected in other scenes."New value: +"Same as create_form questions[].collectOnly."

Previous value: -"Statement only, and required there: the text respondents read — an intro, a section lead-in, instructions, a disclaimer. The block renders this and nothing else. Same rich-text rules as `description` (headings / lists / links / <img src> / math formulas). This field also accepts an inline image: put an <img src=\"...\"> in it, where src is a direct image URL that renders in <img src> (a page URL that merely contains an image does not work). Use finalize_image_upload to host an image yourself, or a direct URL the user supplied. Never invent an image URL — omit the image instead of risking a broken one."New value: +"Same as create_form questions[].content."

Previous value: -[
-  {
-    "description": "SingleCheck / single-select DropDown: one choice label or code. FillBlank: the standard answer text.",
-    "type": "string"
-  },
-  {
-    "description": "MultiCheck / multi-select DropDown (multiple=true): the label or code of every correct choice. Ordering: ALL choice labels/codes in the correct order (order-sensitive).",
-    "items": {
-      "type": "string"
-    },
-    "type": "array"
-  },
-  {
-    "description": "TrueFalse: true or false.",
-    "type": "boolean"
-  },
-  {
-    "description": "NumberField: a finite number, matched exactly.",
-    "type": "number"
-  }
-]New value: +[
+  {
+    "type": "string"
+  },
+  {
+    "items": {
+      "type": "string"
+    },
+    "type": "array"
+  },
+  {
+    "type": "boolean"
+  },
+  {
+    "type": "number"
+  }
+]

Previous value: -"The \"correct answer\" of the knowledge_quiz scene; setting it makes the question scored, so pair it with a positive `score`. The shape follows the question type — see the anyOf branches; a choice is referenced by its label or its code, so reference it by code whenever the same label appears more than once (Ordering rejects an ambiguous label outright). Required on SingleCheck / MultiCheck / DropDown / Ordering in the knowledge_quiz scene, optional on FillBlank / NumberField there. NumberField answers must be typeable within min / max and decimalPlaces. Rejected for DateField / TimeField / Rate (data-collection and rating fields; configure date/time scoring in the web app), rejected for FillBlank in the scored_quiz scene (free text is collected only there), and rejected in the outcome_quiz scene (no right or wrong answers there). In the scored_quiz scene prefer choices[i].score per option; passing correctAnswer + score there only falls back to \"the matching choice gets score, others get 0\"."New value: +"Same as create_form questions[].correctAnswer."

Previous value: -"NumberField only: how many decimal places respondents may enter (stored as the field's numeric precision), default 0 = integers only. Rejected for other question types. Note this is different from the string `precision` of DateField / TimeField."New value: +"Same as create_form questions[].decimalPlaces."

Previous value: -"Optional supplementary note for the question. Allows a wider HTML subset: everything the stem allows + <h1>-<h6> <ul> <ol> <li> <blockquote> <a href> <img src> <hr> <art-field> (variable placeholder, data-type / data-cid); unsafe protocols (javascript:/data:) and unknown attributes are stripped. This field also accepts an inline image: put an <img src=\"...\"> in it, where src is a direct image URL that renders in <img src> (a page URL that merely contains an image does not work). Use finalize_image_upload to host an image yourself, or a direct URL the user supplied. Never invent an image URL — omit the image instead of risking a broken one."New value: +"Same as create_form questions[].description."

Previous value: -"Optional answer explanation. The frontend renders it in the question's \"answer explanation\" field (DescriptionEditor); the rich-text rules are identical to description. Do not stuff the answer explanation into description — that is the question's supplementary note and will not be shown as an explanation to respondents/graders."New value: +"Same as create_form questions[].explain."

Previous value: -"scored_quiz scene + TrueFalse only: the points answering \"false\" adds to each dimension, as a map of dimension code → score (same semantics as choices[i].dimensionScores). Rejected for other question types / scenes."New value: +"Same as create_form questions[].falseDimensionScores."

Previous value: -"TrueFalse only: custom display text for the \"false\" option (e.g. \"No\" / \"Disagree\"). Ignored for other question types. Leave empty to fall back to the built-in default for the form language (\"Incorrect\" in English forms). Does not change the stored answer value, which stays \"false\"."New value: +"Same as create_form questions[].falseLabel."

Previous value: -"Outcome scene + TrueFalse only (required there together with trueOutcomes): the outcomes that answering \"false\" votes for. Use [] for a side that votes for nothing. Rejected for other question types / scenes. Each item is an outcome code (one vote) or { code, weight } to make this pick count more or less — e.g. { \"code\": \"lion\", \"weight\": 2 } for a question that should decide the result more than the others. The outcome with the most total votes wins."New value: +"Same as create_form questions[].falseOutcomes."

Previous value: -[
-  {
-    "type": "string"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "code": {
-        "description": "Outcome code from report.outcomes",
-        "type": "string"
-      },
-      "weight": {
-        "description": "Votes this pick casts for the outcome; omit for 1. Decimals allowed, 0 = counts for nothing.",
-        "maximum": 100,
-        "minimum": 0,
-        "type": "number"
-      }
-    },
-    "required": [
-      "code"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "type": "string"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "code": {
+        "type": "string"
+      },
+      "weight": {
+        "maximum": 100,
+        "minimum": 0,
+        "type": "number"
+      }
+    },
+    "required": [
+      "code"
+    ],
+    "type": "object"
+  }
+]

Previous value: -"Swiper only, and required there: the carousel slides in display order, 1-10 of them. Upload the images with prepare_image_upload / finalize_image_upload first and pass the returned media IDs. Rejected for every other type."New value: +"Same as create_form questions[].items."

Removed value: -{
-  "description": "Optional slide note. Web editor only, same as title.",
-  "maxLength": 1000,
-  "type": "string"
-}

Removed value: -"The slide image: a media ID returned by finalize_image_upload, or the media URL of an image already in this team library. Required — the answer page renders the images and nothing else."

Removed value: -"Optional slide label. Shown in the web editor only (the answer page renders the image), and translatable per language."

Added value: +{
+  "description": "Same as create_form questions[].kind.",
+  "enum": [
+    "image",
+    "audio",
+    "video",
+    "document"
+  ],
+  "type": "string"
+}

Previous value: -"NumberField only: maximum allowed input value (must be >= min). Rejected for other question types."New value: +"Same as create_form questions[].max."

Added value: +{
+  "description": "Same as create_form questions[].maxFiles.",
+  "maximum": 3,
+  "minimum": 1,
+  "type": "integer"
+}

Previous value: -"NumberField only: minimum allowed input value (respondents cannot submit a smaller number). Rejected for other question types."New value: +"Same as create_form questions[].min."

Previous value: -"DropDown only: allow selecting multiple options (default false = single select). Affects the quiz-scene correctAnswer shape: an array of labels/codes when true, a single one when false. Rejected for other question types (SingleCheck/MultiCheck are inherently single/multi)."New value: +"Same as create_form questions[].multiple."

Previous value: -"Question stem text. Allows plain text or restricted HTML (tag allowlist: <p> <strong>/<b> <em>/<i> <u> <s> <mark> <span> <sup> <sub> <br>; other tags are stripped and the text kept)."New value: +"Same as create_form questions[].name."

Previous value: -"DateField / TimeField only: picker precision. DateField accepts year | month | day | hour | minute (default day; e.g. \"month\" shows a year-month picker, \"minute\" a date + hour:minute picker). TimeField accepts only minute | second (default minute). Ignored for other question types."New value: +"Same as create_form questions[].precision."

Previous value: -"Whether the question is required, default false"New value: +"Same as create_form questions[].required."

Previous value: -"Points this question is worth, default 0 (not scored). Quiz scene: awarded when the answer matches correctAnswer, and a positive value is required once correctAnswer is set. Scored Quiz scene: pairing it with correctAnswer enables the fallback mode above, but choices[i].score is more flexible. Rejected in the outcome_quiz scene, for DateField / TimeField / Rate, and — in the scored_quiz scene — for NumberField (where the submitted number itself is the score) and FillBlank (collected only, never scored)."New value: +"Same as create_form questions[].score."

Previous value: -"Ordering only: shuffle the displayed choice order for each respondent. Defaults to true for MCP-created questions — the stored choices order would otherwise leak the correct order when correctAnswer matches it. Pass false only when the initial order is intentionally meaningful. Rejected for other question types."New value: +"Same as create_form questions[].shuffle."

Previous value: -"Rate only: number of rating steps, i.e. the highest rating (3-10, default 5). In the scored_quiz scene the submitted rating value (1..steps) is the question score, unless a per-star score is configured in the web app. Rejected for other question types."New value: +"Same as create_form questions[].steps."

Previous value: -"scored_quiz scene + TrueFalse only: the points answering \"true\" adds to each dimension, as a map of dimension code → score (same semantics as choices[i].dimensionScores). Rejected for other question types / scenes."New value: +"Same as create_form questions[].trueDimensionScores."

Previous value: -"TrueFalse only: custom display text for the \"true\" option (e.g. \"Yes\" / \"Agree\"). Ignored for other question types. Leave empty to fall back to the built-in default for the form language (\"Correct\" in English forms). Does not change the stored answer value, which stays \"true\"."New value: +"Same as create_form questions[].trueLabel."

Previous value: -"Outcome scene + TrueFalse only (required there together with falseOutcomes): the outcomes that answering \"true\" votes for. Use [] for a side that votes for nothing. Rejected for other question types / scenes. Each item is an outcome code (one vote) or { code, weight } to make this pick count more or less — e.g. { \"code\": \"lion\", \"weight\": 2 } for a question that should decide the result more than the others. The outcome with the most total votes wins."New value: +"Same as create_form questions[].trueOutcomes."

Previous value: -[
-  {
-    "type": "string"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "code": {
-        "description": "Outcome code from report.outcomes",
-        "type": "string"
-      },
-      "weight": {
-        "description": "Votes this pick casts for the outcome; omit for 1. Decimals allowed, 0 = counts for nothing.",
-        "maximum": 100,
-        "minimum": 0,
-        "type": "number"
-      }
-    },
-    "required": [
-      "code"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "type": "string"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "code": {
+        "type": "string"
+      },
+      "weight": {
+        "maximum": 100,
+        "minimum": 0,
+        "type": "number"
+      }
+    },
+    "required": [
+      "code"
+    ],
+    "type": "object"
+  }
+]

Previous value: -[
-  "SingleCheck",
-  "MultiCheck",
-  "TrueFalse",
-  "FillBlank",
-  "DateField",
-  "TimeField",
-  "NumberField",
-  "Rate",
-  "DropDown",
-  "Cascade",
-  "Ordering",
-  "Breaker",
-  "Statement",
-  "Swiper"
-]New value: +[
+  "SingleCheck",
+  "MultiCheck",
+  "TrueFalse",
+  "FillBlank",
+  "DateField",
+  "TimeField",
+  "NumberField",
+  "Rate",
+  "DropDown",
+  "Cascade",
+  "Ordering",
+  "Attachment",
+  "Breaker",
+  "Statement",
+  "Swiper"
+]

Previous value: -"NumberField only: display unit suffix shown after the input, e.g. \"kg\" / \"$\" / \"min\". Rejected for other question types."New value: +"Same as create_form questions[].unit."

Previous value: -"Rate only: optional scale labels evenly distributed under the rating control, e.g. [\"Poor\", \"Excellent\"] for the two endpoints (up to 5 labels). Rejected for other question types."New value: +"Same as create_form questions[].words."

Previous value: -"Choice-based questions only (SingleCheck / MultiCheck / DropDown / Ordering / Cascade), where it is required; ignored for every other type, including TrueFalse — its two options come from trueLabel / falseLabel. Per-type limits: SingleCheck / MultiCheck 2-20 items — for a longer list use DropDown (2-100 items) instead; Ordering 2-10 items; Cascade nests via choices[i].children (up to 3 levels, at most 100 nodes in total). IMPORTANT (knowledge_quiz scene): vary the position of the correct option(s) across questions — do NOT always place the correct answer first. Distribute correct answers roughly evenly over all positions so they are not predictable."New value: +"Choice-based questions only (SingleCheck / MultiCheck / DropDown / Ordering / Cascade), where it is required; ignored for every other type, including TrueFalse — its two options come from trueLabel / falseLabel. Per-type limits: SingleCheck / MultiCheck 2-100 items — for a longer list use DropDown (2-300 items) instead; Ordering 2-10 items; Cascade nests via choices[i].children (up to 3 levels, at most 100 nodes in total). IMPORTANT (knowledge_quiz scene): vary the position of the correct option(s) across questions — do NOT always place the correct answer first. Distribute correct answers roughly evenly over all positions so they are not predictable."

Previous value: -100New value: +300

Previous value: -"Outcome scene only, and required there on every choice: the outcome codes this choice votes for when selected (each must exist in report.outcomes; a choice may vote for multiple outcomes). Use [] for a neutral choice that votes for nothing. Rejected in the knowledge_quiz / scored_quiz scenes."New value: +"Outcome scene only, and required there on every choice: the outcomes this choice votes for when selected (each code must exist in report.outcomes; a choice may vote for multiple outcomes). Use [] for a neutral choice that votes for nothing. Rejected in the knowledge_quiz / scored_quiz scenes. Each item is an outcome code (one vote) or { code, weight } to make this pick count more or less — e.g. { \"code\": \"lion\", \"weight\": 2 } for a question that should decide the result more than the others. The outcome with the most total votes wins."

Added value: +[
+  {
+    "type": "string"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "code": {
+        "description": "Outcome code from report.outcomes",
+        "type": "string"
+      },
+      "weight": {
+        "description": "Votes this pick casts for the outcome; omit for 1. Decimals allowed, 0 = counts for nothing.",
+        "maximum": 100,
+        "minimum": 0,
+        "type": "number"
+      }
+    },
+    "required": [
+      "code"
+    ],
+    "type": "object"
+  }
+]

Removed value: -"string"

Previous value: -"Outcome scene only, and required there on every choice: the outcome codes this choice votes for when selected (each must exist in report.outcomes; a choice may vote for multiple outcomes). Use [] for a neutral choice that votes for nothing. Rejected in the knowledge_quiz / scored_quiz scenes."New value: +"Outcome scene only, and required there on every choice: the outcomes this choice votes for when selected (each code must exist in report.outcomes; a choice may vote for multiple outcomes). Use [] for a neutral choice that votes for nothing. Rejected in the knowledge_quiz / scored_quiz scenes. Each item is an outcome code (one vote) or { code, weight } to make this pick count more or less — e.g. { \"code\": \"lion\", \"weight\": 2 } for a question that should decide the result more than the others. The outcome with the most total votes wins."

Added value: +[
+  {
+    "type": "string"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "code": {
+        "description": "Outcome code from report.outcomes",
+        "type": "string"
+      },
+      "weight": {
+        "description": "Votes this pick casts for the outcome; omit for 1. Decimals allowed, 0 = counts for nothing.",
+        "maximum": 100,
+        "minimum": 0,
+        "type": "number"
+      }
+    },
+    "required": [
+      "code"
+    ],
+    "type": "object"
+  }
+]

Removed value: -"string"

Previous value: -"Outcome scene only, and required there on every choice: the outcome codes this choice votes for when selected (each must exist in report.outcomes; a choice may vote for multiple outcomes). Use [] for a neutral choice that votes for nothing. Rejected in the knowledge_quiz / scored_quiz scenes."New value: +"Outcome scene only, and required there on every choice: the outcomes this choice votes for when selected (each code must exist in report.outcomes; a choice may vote for multiple outcomes). Use [] for a neutral choice that votes for nothing. Rejected in the knowledge_quiz / scored_quiz scenes. Each item is an outcome code (one vote) or { code, weight } to make this pick count more or less — e.g. { \"code\": \"lion\", \"weight\": 2 } for a question that should decide the result more than the others. The outcome with the most total votes wins."

Added value: +[
+  {
+    "type": "string"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "code": {
+        "description": "Outcome code from report.outcomes",
+        "type": "string"
+      },
+      "weight": {
+        "description": "Votes this pick casts for the outcome; omit for 1. Decimals allowed, 0 = counts for nothing.",
+        "maximum": 100,
+        "minimum": 0,
+        "type": "number"
+      }
+    },
+    "required": [
+      "code"
+    ],
+    "type": "object"
+  }
+]

Removed value: -"string"

Previous value: -"Outcome scene + TrueFalse only (required there together with trueOutcomes): the outcome codes that answering \"false\" votes for. Use [] for a side that votes for nothing. Rejected for other question types / scenes."New value: +"Outcome scene + TrueFalse only (required there together with trueOutcomes): the outcomes that answering \"false\" votes for. Use [] for a side that votes for nothing. Rejected for other question types / scenes. Each item is an outcome code (one vote) or { code, weight } to make this pick count more or less — e.g. { \"code\": \"lion\", \"weight\": 2 } for a question that should decide the result more than the others. The outcome with the most total votes wins."

Added value: +[
+  {
+    "type": "string"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "code": {
+        "description": "Outcome code from report.outcomes",
+        "type": "string"
+      },
+      "weight": {
+        "description": "Votes this pick casts for the outcome; omit for 1. Decimals allowed, 0 = counts for nothing.",
+        "maximum": 100,
+        "minimum": 0,
+        "type": "number"
+      }
+    },
+    "required": [
+      "code"
+    ],
+    "type": "object"
+  }
+]

Removed value: -"string"

Previous value: -"Outcome scene + TrueFalse only (required there together with falseOutcomes): the outcome codes that answering \"true\" votes for. Use [] for a side that votes for nothing. Rejected for other question types / scenes."New value: +"Outcome scene + TrueFalse only (required there together with falseOutcomes): the outcomes that answering \"true\" votes for. Use [] for a side that votes for nothing. Rejected for other question types / scenes. Each item is an outcome code (one vote) or { code, weight } to make this pick count more or less — e.g. { \"code\": \"lion\", \"weight\": 2 } for a question that should decide the result more than the others. The outcome with the most total votes wins."

Added value: +[
+  {
+    "type": "string"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "code": {
+        "description": "Outcome code from report.outcomes",
+        "type": "string"
+      },
+      "weight": {
+        "description": "Votes this pick casts for the outcome; omit for 1. Decimals allowed, 0 = counts for nothing.",
+        "maximum": 100,
+        "minimum": 0,
+        "type": "number"
+      }
+    },
+    "required": [
+      "code"
+    ],
+    "type": "object"
+  }
+]

Removed value: -"string"

Previous value: -"DateField / TimeField only: picker precision. DateField accepts year | month | day | hour | minute | second (default day; e.g. \"month\" shows a year-month picker, \"second\" a full datetime picker). TimeField accepts only minute | second (default minute). Ignored for other question types."New value: +"DateField / TimeField only: picker precision. DateField accepts year | month | day | hour | minute (default day; e.g. \"month\" shows a year-month picker, \"minute\" a date + hour:minute picker). TimeField accepts only minute | second (default minute). Ignored for other question types."

Added value: +{
+  "description": "scored_quiz scene only, for SingleCheck / MultiCheck / DropDown / Cascade / TrueFalse / Rate: collect the answer as data without scoring it (e.g. age range, industry, how they heard about you). A collect-only question produces no score, cannot be referenced by report.formula or dimension formulas, and is shown with plain radio buttons / checkboxes instead of A/B/C letter badges. Do not pass any scoring input (choices[i].score, dimensionScores, score, correctAnswer) together with it. Rejected in other scenes.",
+  "type": "boolean"
+}

Added value: +{
+  "additionalProperties": {
+    "maximum": 100,
+    "minimum": 0,
+    "type": "number"
+  },
+  "description": "scored_quiz scene only: the points this choice adds to each dimension when selected, as a map of dimension code → score, e.g. { \"dim_d\": 3, \"dim_i\": 1 }. Any choice carrying it switches the question to per-dimension scoring: for each dimension the question contributes the selected choices' scores for that dimension (a dimension not listed on the chosen choice counts 0), and a dimension without a formula automatically sums these contributions across questions. Codes must exist in report.dimensionAnalysis.dimensions — give dimensions[].code and reference them in the same create_form call. `score` remains the overall score fed to report.formula. Rejected in the knowledge_quiz / outcome_quiz scenes.",
+  "type": "object"
+}

Added value: +{
+  "additionalProperties": {
+    "maximum": 100,
+    "minimum": 0,
+    "type": "number"
+  },
+  "description": "scored_quiz scene only: the points this choice adds to each dimension when selected, as a map of dimension code → score, e.g. { \"dim_d\": 3, \"dim_i\": 1 }. Any choice carrying it switches the question to per-dimension scoring: for each dimension the question contributes the selected choices' scores for that dimension (a dimension not listed on the chosen choice counts 0), and a dimension without a formula automatically sums these contributions across questions. Codes must exist in report.dimensionAnalysis.dimensions — give dimensions[].code and reference them in the same create_form call. `score` remains the overall score fed to report.formula. Rejected in the knowledge_quiz / outcome_quiz scenes.",
+  "type": "object"
+}

Added value: +{
+  "additionalProperties": {
+    "maximum": 100,
+    "minimum": 0,
+    "type": "number"
+  },
+  "description": "scored_quiz scene only: the points this choice adds to each dimension when selected, as a map of dimension code → score, e.g. { \"dim_d\": 3, \"dim_i\": 1 }. Any choice carrying it switches the question to per-dimension scoring: for each dimension the question contributes the selected choices' scores for that dimension (a dimension not listed on the chosen choice counts 0), and a dimension without a formula automatically sums these contributions across questions. Codes must exist in report.dimensionAnalysis.dimensions — give dimensions[].code and reference them in the same create_form call. `score` remains the overall score fed to report.formula. Rejected in the knowledge_quiz / outcome_quiz scenes.",
+  "type": "object"
+}

Added value: +{
+  "additionalProperties": {
+    "maximum": 100,
+    "minimum": 0,
+    "type": "number"
+  },
+  "description": "scored_quiz scene + TrueFalse only: the points answering \"false\" adds to each dimension, as a map of dimension code → score (same semantics as choices[i].dimensionScores). Rejected for other question types / scenes.",
+  "type": "object"
+}

Added value: +{
+  "additionalProperties": {
+    "maximum": 100,
+    "minimum": 0,
+    "type": "number"
+  },
+  "description": "scored_quiz scene + TrueFalse only: the points answering \"true\" adds to each dimension, as a map of dimension code → score (same semantics as choices[i].dimensionScores). Rejected for other question types / scenes.",
+  "type": "object"
+}

Previous value: -"FIELD APPLICABILITY — `type` is the only field the schema always requires; `type` (plus the form scene) decides which of the remaining fields apply, and one that does not apply is either rejected with an explanatory error or ignored, so never pass it. Breaker (page break) takes nothing but `type`. Every question type takes `name` (required) plus the optional `code` / `description` / `explain` / `required`. Type-specific fields: SingleCheck / MultiCheck / DropDown / Ordering / Cascade need `choices` (Cascade nests via choices[i].children; DropDown also takes `multiple`; Ordering also takes `shuffle`); TrueFalse has a fixed pair of options and takes `trueLabel` / `falseLabel` instead of `choices`; DateField / TimeField take `precision`; NumberField takes `min` / `max` / `unit` / `decimalPlaces`; Rate takes `steps` / `words`. Scene rules for scoring: quiz — `correctAnswer` plus `score` > 0 are REQUIRED on SingleCheck / MultiCheck / DropDown / Ordering, optional on FillBlank (add `aiMatch` to have AI grade it instead of exact string match) and NumberField (omit both and the question is just a data-collection field), and rejected on DateField / TimeField; scored_quiz — score each option via choices[i].score; `correctAnswer` / `score` are rejected on NumberField and Rate (the submitted value is the score) and on FillBlank (free text is collected only, never scored); outcome — nothing is scored: `correctAnswer` / `score` / `aiMatch` are all rejected, every choice needs `outcomes` (TrueFalse votes via `trueOutcomes` / `falseOutcomes`). Type availability per scene: Ordering is knowledge_quiz-only; FillBlank works in knowledge_quiz (optionally scored) and in scored_quiz (data-collection only — its answer never feeds a score or a report formula); Cascade, Rate, DateField and TimeField are scored_quiz-only; and the outcome_quiz scene accepts only SingleCheck / MultiCheck / DropDown / TrueFalse / Breaker."New value: +"FIELD APPLICABILITY — `type` is the only field the schema always requires; `type` (plus the form scene) decides which of the remaining fields apply, and one that does not apply is either rejected with an explanatory error or ignored, so never pass it. Breaker (page break) takes nothing but `type`. Display blocks collect no answer, are never scored and are allowed in every scene: Statement takes `content` (the rich text IS the block) and Swiper takes `items` (an image carousel); both also accept an optional `name`, a label used by the web editor only, and neither takes any question field. Every question type takes `name` (required) plus the optional `code` / `description` / `explain` / `required`. Type-specific fields: SingleCheck / MultiCheck / DropDown / Ordering / Cascade need `choices` (Cascade nests via choices[i].children; DropDown also takes `multiple`; Ordering also takes `shuffle`); TrueFalse has a fixed pair of options and takes `trueLabel` / `falseLabel` instead of `choices`; DateField / TimeField take `precision`; NumberField takes `min` / `max` / `unit` / `decimalPlaces`; Rate takes `steps` / `words`. Scene rules for scoring: quiz — `correctAnswer` plus `score` > 0 are REQUIRED on SingleCheck / MultiCheck / DropDown / Ordering, optional on FillBlank (add `aiMatch` to have AI grade it instead of exact string match) and NumberField (omit both and the question is just a data-collection field), and rejected on DateField / TimeField; scored_quiz — score each option via choices[i].score; `correctAnswer` / `score` are rejected on NumberField and Rate (the submitted value is the score) and on FillBlank (free text is collected only, never scored); outcome — nothing is scored: `correctAnswer` / `score` / `aiMatch` are all rejected, every choice needs `outcomes` (TrueFalse votes via `trueOutcomes` / `falseOutcomes`). Type availability per scene: Ordering is knowledge_quiz-only; FillBlank works in knowledge_quiz (optionally scored) and in scored_quiz (data-collection only — its answer never feeds a score or a report formula); Cascade, Rate, DateField and TimeField are scored_quiz-only; and the outcome_quiz scene accepts only SingleCheck / MultiCheck / DropDown / TrueFalse / Breaker."

Added value: +{
+  "description": "Statement only, and required there: the text respondents read — an intro, a section lead-in, instructions, a disclaimer. The block renders this and nothing else. Same rich-text rules as `description` (headings / lists / links / <img src> / math formulas). This field also accepts an inline image: put an <img src=\"...\"> in it, where src is a direct image URL that renders in <img src> (a page URL that merely contains an image does not work). Use finalize_image_upload to host an image yourself, or a direct URL the user supplied. Never invent an image URL — omit the image instead of risking a broken one.",
+  "maxLength": 5000,
+  "type": "string"
+}

Added value: +{
+  "description": "Swiper only, and required there: the carousel slides in display order, 1-10 of them. Upload the images with prepare_image_upload / finalize_image_upload first and pass the returned media IDs. Rejected for every other type.",
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "description": {
+        "description": "Optional slide note. Web editor only, same as title.",
+        "maxLength": 1000,
+        "type": "string"
+      },
+      "image": {
+        "description": "The slide image: a media ID returned by finalize_image_upload, or the media URL of an image already in this team library. Required — the answer page renders the images and nothing else.",
+        "type": "string"
+      },
+      "title": {
+        "description": "Optional slide label. Shown in the web editor only (the answer page renders the image), and translatable per language.",
+        "maxLength": 200,
+        "type": "string"
+      }
+    },
+    "required": [
+      "image"
+    ],
+    "type": "object"
+  },
+  "maxItems": 10,
+  "minItems": 1,
+  "type": "array"
+}

Previous value: -"Question type; Breaker means a page break, no name/choices etc. needed"New value: +"Question type; Breaker means a page break, no name/choices etc. needed; Statement / Swiper are display-only blocks that collect no answer"

Previous value: -[
-  "SingleCheck",
-  "MultiCheck",
-  "TrueFalse",
-  "FillBlank",
-  "DateField",
-  "TimeField",
-  "NumberField",
-  "Rate",
-  "DropDown",
-  "Cascade",
-  "Ordering",
-  "Breaker"
-]New value: +[
+  "SingleCheck",
+  "MultiCheck",
+  "TrueFalse",
+  "FillBlank",
+  "DateField",
+  "TimeField",
+  "NumberField",
+  "Rate",
+  "DropDown",
+  "Cascade",
+  "Ordering",
+  "Breaker",
+  "Statement",
+  "Swiper"
+]