RooQuiz

Update question

update_question

Destructive

Update a single question of an existing form, located by code. Changeable: name / description / explain / required / score / correctAnswer / aiMatch (FillBlank AI grading) / precision (DateField/TimeField picker precision) / min / max / unit / decimalPlaces (NumberField) / words (Rate scale labels) / maxFiles (Attachment) / choices (replaces ALL choices of a choice-based question). NOT changeable — delete_question then add_question instead: question type, Rate steps, DropDown multiple, Ordering shuffle, Attachment kind. DateField / TimeField / Rate reject score / correctAnswer / aiMatch (configure date/time scoring in the web app). The scored_quiz, outcome_quiz and ai_quiz scenes reject the top-level score / correctAnswer / aiMatch as well: pass choices carrying choices[i].score or choices[i].outcomes instead (TrueFalse outcome votes still need delete + recreate). Display blocks are edited here too, with their own keys: Statement takes content, Swiper takes items (replacing all slides), and both take name / description — every question key is rejected on them.

Input Schema

Name	Required	Description
`max`	No	NumberField only: new maximum allowed value; pass null to remove the upper bound. Ignored for other question types.
`min`	No	NumberField only: new minimum allowed value; pass null to remove the lower bound. Ignored for other question types.
`code`	Yes	Question code (field.code), from the get_form / create_form return value
`name`	No	New question stem, optional
`unit`	No	NumberField only: new display unit suffix (e.g. "kg"); pass null or an empty string to clear. Ignored for other question types.
`items`	No	Swiper block only: replace ALL slides with this list (1-10). Slides get fresh ids, so any translated slide titles / notes for this block have to be rewritten afterwards.
`score`	No	Score for this question; 0 or omitted + no correctAnswer means not scored
`words`	No	Rate only: new scale labels shown under the rating control (up to 5); pass null or [] to remove the labels. Ignored for other question types.
`formId`	Yes	The form ID the question belongs to
`aiMatch`	No	FillBlank AI grading config (knowledge_quiz scene only). Pass an object to enable AI matching (requires the question to have correctAnswer + score > 0); pass null to turn it off and revert to exact-match grading. Omit to leave the existing grading mode untouched.
`choices`	No	Replace ALL choices of a choice-based question (SingleCheck / MultiCheck / DropDown / Ordering / Cascade; rejected for other types). To keep an existing choice's identity (so past answers still match it) pass its current code from get_form; entries without a code get a new auto-generated code. knowledge_quiz scene: if the existing correctAnswer references a code missing from the new choices, pass a new correctAnswer in the same call. scored_quiz scene: set choices[i].score to rebuild Option Scoring (required if the question currently has Option Scoring). outcome_quiz scene: every choice must carry an outcomes vote list (use [] for a neutral choice).
`content`	No	Statement block only: the new body text, which is the whole block. Same rich-text rules as description. It cannot be emptied — delete_question the block if you no longer want it. Write HTML, never Markdown: <strong>bold</strong> not bold, <ul><li> not "- item", <h2> not "## heading". 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.
`explain`	No	New answer explanation (the question's "answer explanation" field, not the question note); pass an empty string to clear. Same rich-text rules as description. Write HTML, never Markdown: <strong>bold</strong> not bold, <ul><li> not "- item", <h2> not "## heading".
`maxFiles`	No	Attachment only: how many files a respondent may upload (1-3); pass null to reset to the default 3. Rejected for other question types.
`required`	No	Whether the question is required
`precision`	No	DateField / TimeField only: new picker precision. DateField accepts year \| month \| day \| hour \| minute; TimeField accepts only minute \| second. Ignored for other question types.
`rateStyle`	No	Rate only: new look of the rating control — "star" or "number" (numbered circles); pass null to reset to the default star. Display only, collected ratings are unaffected. Ignored for other question types.
`trueLabel`	No	TrueFalse only: new custom display text for the "true" option; pass an empty string to clear and fall back to the localized default. Ignored for other question types.
`falseLabel`	No	TrueFalse only: new custom display text for the "false" option; pass an empty string to clear and fall back to the localized default. Ignored for other question types.
`description`	No	New question note; pass an empty string to clear. Write HTML, never Markdown: <strong>bold</strong> not bold, <ul><li> not "- item", <h2> not "## heading". 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.
`correctAnswer`	No	New correct answer; the shape follows the question type — see the anyOf branches. Choices are referenced by label or code (use the code when the same label repeats), and they must exist in the question's current choices, or in the `choices` replacement passed in this same call. NumberField answers must stay typeable within min / max and decimalPlaces. Rejected for DateField / TimeField / Rate, and in the scored_quiz / outcome_quiz scenes.
`decimalPlaces`	No	NumberField only: new number of decimal places allowed (0 = integers only); pass null to reset to the default 0. Ignored for other question types.

Output Schema

Name	Required	Description
`code`	No	The question that was updated
`field`	No	The question after the merge
`formId`	No	The form that was edited
`changed`	No	Which question attributes this call changed

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedNov 9, 2026

addedInput schema / properties / rateStyle

Added value: +{
+  "anyOf": [
+    {
+      "enum": [
+        "star",
+        "number"
+      ],
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "description": "Rate only: new look of the rating control — \"star\" or \"number\" (numbered circles); pass null to reset to the default star. Display only, collected ratings are unaffected. Ignored for other question types."
+}

Changed3 schema fields changedNov 3, 2026

changedInput schema / properties / content / description

Previous value: -"Statement block only: the new body text, which is the whole block. Same rich-text rules as description. It cannot be emptied — delete_question the block if you no longer want it. 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: +"Statement block only: the new body text, which is the whole block. Same rich-text rules as description. It cannot be emptied — delete_question the block if you no longer want it. Write HTML, never Markdown: <strong>bold</strong> not **bold**, <ul><li> not \"- item\", <h2> not \"## heading\". 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."

changedInput schema / properties / description / description

Previous value: -"New question note; pass an empty string to clear. 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: +"New question note; pass an empty string to clear. Write HTML, never Markdown: <strong>bold</strong> not **bold**, <ul><li> not \"- item\", <h2> not \"## heading\". 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."

changedInput schema / properties / explain / description

Previous value: -"New answer explanation (the question's \"answer explanation\" field, not the question note); pass an empty string to clear. Same rich-text rules as description."New value: +"New answer explanation (the question's \"answer explanation\" field, not the question note); pass an empty string to clear. Same rich-text rules as description. Write HTML, never Markdown: <strong>bold</strong> not **bold**, <ul><li> not \"- item\", <h2> not \"## heading\"."

Changed3 schema fields changedOct 31, 2026

changed

Input schema / properties / choices / items / properties / children / items / properties / children / items / properties / dimensionScores / description

Previous 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."New 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 }. Each entry overrides this choice's score for that one dimension; a dimension not listed falls back to the plain choice `score`, and an explicit 0 really counts 0. Dimension scores still come only from each dimension's required formula: inside it `{{q}}` is the sum of the selected choices' override-or-score for that dimension, and a question the formula does not reference adds nothing. Codes must exist in report.dimensionAnalysis.dimensions — give dimensions[].code and reference them in the same create_form call. `score` remains the overall score (summed by default, or fed to report.formula when set). Rejected in the knowledge_quiz / outcome_quiz scenes."

changedInput schema / properties / choices / items / properties / children / items / properties / dimensionScores / description

Previous 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."New 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 }. Each entry overrides this choice's score for that one dimension; a dimension not listed falls back to the plain choice `score`, and an explicit 0 really counts 0. Dimension scores still come only from each dimension's required formula: inside it `{{q}}` is the sum of the selected choices' override-or-score for that dimension, and a question the formula does not reference adds nothing. Codes must exist in report.dimensionAnalysis.dimensions — give dimensions[].code and reference them in the same create_form call. `score` remains the overall score (summed by default, or fed to report.formula when set). Rejected in the knowledge_quiz / outcome_quiz scenes."

changedInput schema / properties / choices / items / properties / dimensionScores / description

Previous 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."New 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 }. Each entry overrides this choice's score for that one dimension; a dimension not listed falls back to the plain choice `score`, and an explicit 0 really counts 0. Dimension scores still come only from each dimension's required formula: inside it `{{q}}` is the sum of the selected choices' override-or-score for that dimension, and a question the formula does not reference adds nothing. Codes must exist in report.dimensionAnalysis.dimensions — give dimensions[].code and reference them in the same create_form call. `score` remains the overall score (summed by default, or fed to report.formula when set). Rejected in the knowledge_quiz / outcome_quiz scenes."

Changed1 schema field changedOct 31, 2026

removedInput schema / properties / collectOnly

Removed value: -{
-  "description": "scored_quiz scene only, for SingleCheck / MultiCheck / DropDown / Cascade / TrueFalse / Rate: true = collect the answer as data without scoring it (plain radio / checkbox display, no score, not referenceable by formulas); false = score it again with its existing Option Scoring. Turning it on is rejected while report.formula or a dimension formula still references this question — remove the reference first.",
-  "type": "boolean"
-}

Changed1 schema field changedOct 31, 2026

addedInput schema / properties / maxFiles

Added value: +{
+  "anyOf": [
+    {
+      "maximum": 3,
+      "minimum": 1,
+      "type": "integer"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "description": "Attachment only: how many files a respondent may upload (1-3); pass null to reset to the default 3. Rejected for other question types."
+}

Changed9 schema fields changedOct 12, 2026

changed

Input schema / properties / choices / items / properties / children / items / properties / children / items / properties / outcomes / description

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

Input schema / properties / choices / items / properties / children / items / properties / children / items / properties / outcomes / items / anyOf

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"
+  }
+]

removedInput schema / properties / choices / items / properties / children / items / properties / children / items / properties / outcomes / items / type
```
Removed value: -"string"
```

changedInput schema / properties / choices / items / properties / children / items / properties / outcomes / description

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."

addedInput schema / properties / choices / items / properties / children / items / properties / outcomes / items / anyOf

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"
+  }
+]

removedInput schema / properties / choices / items / properties / children / items / properties / outcomes / items / type
```
Removed value: -"string"
```

changedInput schema / properties / choices / items / properties / outcomes / description

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."

addedInput schema / properties / choices / items / properties / outcomes / items / anyOf

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"
+  }
+]

removedInput schema / properties / choices / items / properties / outcomes / items / type
```
Removed value: -"string"
```

Changed1 schema field changedOct 3, 2026

changedInput schema / properties / precision / description

Previous value: -"DateField / TimeField only: new picker precision. DateField accepts year | month | day | hour | minute | second; TimeField accepts only minute | second. Ignored for other question types."New value: +"DateField / TimeField only: new picker precision. DateField accepts year | month | day | hour | minute; TimeField accepts only minute | second. Ignored for other question types."

Changed1 schema field changedSep 30, 2026

addedInput schema / properties / collectOnly

Added value: +{
+  "description": "scored_quiz scene only, for SingleCheck / MultiCheck / DropDown / Cascade / TrueFalse / Rate: true = collect the answer as data without scoring it (plain radio / checkbox display, no score, not referenceable by formulas); false = score it again with its existing Option Scoring. Turning it on is rejected while report.formula or a dimension formula still references this question — remove the reference first.",
+  "type": "boolean"
+}

Changed3 schema fields changedSep 5, 2026

added

Input schema / properties / choices / items / properties / children / items / properties / children / items / properties / dimensionScores

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"
+}

addedInput schema / properties / choices / items / properties / children / items / properties / dimensionScores

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"
+}

addedInput schema / properties / choices / items / properties / dimensionScores

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"
+}

Changed2 schema fields changedAug 26, 2026

addedInput schema / properties / content

Added value: +{
+  "description": "Statement block only: the new body text, which is the whole block. Same rich-text rules as description. It cannot be emptied — delete_question the block if you no longer want it. 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"
+}

addedInput schema / properties / items

Added value: +{
+  "description": "Swiper block only: replace ALL slides with this list (1-10). Slides get fresh ids, so any translated slide titles / notes for this block have to be rewritten afterwards.",
+  "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"
+}

First observedAug 24, 2026

TDQS

Score is being calculated.

All RooQuiz tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?