Skip to main content
Glama

Update form settings

update_form_settings
Destructive

Change how a form of the current team is delivered, as opposed to what it says (use update_form for title / questions / report / theme). Editable: submissionAccess (who may answer and whether seeing the report needs a login — this is the lead-capture gate), reportGateRequireCode (whether that login gate collects an emailed verification code, trading completion rate against lead quality), timeLimit, sharing (the result-page share button and personalised share card, which is what drives organic spread), answerSheet, crowdCompare (show respondents what share of people picked the same option — off by default, not for knowledge quizzes), instantFeedback (knowledge quizzes only, on by default for newly created ones except level tests: respondents submit each page and see right / wrong, the correct answer and the explanation before moving on), hideScores (hide every score respondents see — report, question points, instant feedback and answer review — while keeping levels and right / wrong), booking (the result-page block that opens the team's Cal.com scheduling link; bookings sync back read-only), feedback (a one-question feedback block on the result page), allowPdfDownload (respondents can download their full report as a PDF — Pro), resultRedirect (send respondents straight to a link chosen by their score level or outcome after they submit, instead of the result page — Pro), defaultCta (the result-page CTA master switch plus the default button for results without their own), hiddenFields (URL parameters such as partner or campaign_id captured with each response for attribution), sharedWithAll (whether every team member can see this form), searchIndexable (whether search engines may list the quiz), and slug (the custom path that gives the public link a memorable, SEO-friendly address). Only the keys you pass are changed. Read the current values with get_form_share_info.

Input Schema

NameRequiredDescriptionDefault
slugNoCustom path of the public answer link — the SEO-friendly address (e.g. quizster.app/<team>/burnout-test on the platform domain, or <custom-domain>/burnout-test when the team's custom domain is serving). Lowercase letters, digits and hyphens, 2-64 chars, must start and end with a letter or digit, unique within the team. Pass an empty string to clear back to the random address. Changing it breaks the previous custom path right away, but the token address (/a/<publicToken>) always keeps working and the page's canonical URL follows the custom path.
formIdYesThe form UUID
bookingNoThe result-page booking block: switch, copy and the Cal.com link respondents book through. With the team's Cal.com connector, bookings flow back and show up in list_bookings. Without a calLink the block is not shown, even when enabled.
sharingNoResult-page sharing: the share button, the personalised share card and the public summary. Turning this off stops respondents spreading their results.
feedbackNoResult-page feedback block: one question asked after respondents read their report — tells you whether the result landed. Replaced WHOLESALE: read the current block from get_form_share_info and pass every key you want to keep (omitted copy falls back to the default, omitted choices are dropped).
timeLimitNoAnswer-time countdown. Only knowledge quizzes (knowledge_quiz) can turn this on — a countdown makes sense when unanswered means wrong, but rushing a scorecard or a personality quiz just produces careless answers.
defaultCtaNoResult-page CTA buttons. This is the master switch: while it is off no result shows a CTA, not even levels / outcomes / AI result tags that have their own. Passing an object turns it on and replaces the default button (text + url), which every result without its own cta uses — pass {} to turn it on with no default, so only results with their own cta show a button. null turns it off and keeps the copy. Per-result buttons are set with update_form (writing one also turns this on). For AI quizzes the button appears below the AI report. Free on every plan.
hideScoresNoHide every score the respondent sees: the result page's overall score (score ring / number / percentile) and every dimension score, the points badge on each question while answering, the score in instant feedback, and the per-question scores in the answer review. Level names, level descriptions, the summary and right / wrong verdicts stay. The team still sees scores in the dashboard. Scenes with scores only (knowledge_quiz / scored_quiz). Note the summary template still renders its score variable if one is left in. Off by default.
answerSheetNoThe answer-sheet sidebar on the answering page: a question navigator that lets respondents jump to any question. On by default for newly created forms; turn it off for short quizzes meant to be answered straight through to the result page.
crowdCompareNoShow respondents what share of people picked the same option ("62% of people chose the same as you"). Off by default: it publishes this quiz's answer distribution to whoever answers it, and seeing the majority choice nudges later respondents toward it — leave it off for quizzes used to match courses or place learners. Percentages only, never individual answers, and nothing shows until the quiz has 10+ submissions. Not available for knowledge quizzes at all: the distribution is effectively a crowdsourced answer key.
hiddenFieldsNoURL parameters to capture with each response (hidden fields), e.g. ["partner", "campaign_id"]: opening the quiz link with ?partner=acme stores partner=acme on the record, where it shows in record detail, exports and webhook / Zapier payloads. Lowercase names, up to 10; utm_* and system names (email, name, lang, ref, embed…) are reserved. Replaces the whole list; null or [] clears it.
sharedWithAllNoWhether every member of the team can see and open this form
resultRedirectNoRedirect after submission (Pro): respondents go straight to a link instead of the result page — after the login / lead gate if the report has one. The per-result links live on report.levels[i].redirectUrl (knowledge / scored quizzes) and report.outcomes[i].redirectUrl (outcome quizzes), set with update_form. Shared result links and return visits still open the result page. Only the keys you pass change.
instantFeedbackNoKnowledge quizzes only (knowledge_quiz). When on, the respondent submits each page on its own and sees whether they were right, the correct answer and the question's explanation; submitted questions lock before they move on, and the last page ends with a "See results" button that finishes the quiz. On by default for newly created knowledge quizzes except level tests (useCase level_test); existing quizzes keep whatever they had. Turns the quiz into a learn-as-you-go challenge; it does reveal answers question by question, so leave it off when the score is used for placement.
searchIndexableNoWhether search engines may list this quiz: true puts it in the sitemap and marks its public pages indexable, false keeps them out of search results (drafts, funnel pages meant only for one audience). New quizzes default to true.
allowPdfDownloadNoLet respondents download their full report as a PDF. Pro only (switching it on is rejected on the Free plan). Takes effect only on gated quizzes (submissionAccess login_to_view_report) because the download is tied to the signed-in respondent.
submissionAccessNopublic = anyone answers and sees the report; login_to_view_report = anyone answers but must sign in to see the report (the default, this is how leads get captured)
reportGateRequireCodeNoOnly applies when submissionAccess is login_to_view_report. false (the default for newly created quizzes) = the respondent only types an email and a name to see this one result — far more people finish, but the address is unverified and they get no account, and since result links do get forwarded, the report is effectively as reachable as public for whoever opens the link first. true = the respondent must confirm an emailed 6-digit code, so every captured lead has a verified address and the respondent gets an account they can return to. Quizzes created before this setting existed read as true.

Output Schema

NameRequiredDescriptionDefault
slugNoCustom path after this change; null when cleared (back to the random address)
formIdNoThe form that was changed
changedNoWhich settings this call changed
deliveryNoDelivery state: { isActive, submissionAccess, reportGateRequireCode, timeLimit, sharing, answerSheet, crowdCompare, instantFeedback, hideScores, booking, feedback, allowPdfDownload, resultRedirect, defaultCta, hiddenFields, sharedWithAll, searchIndexable }

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed3 schema fields changed
    • changedInput schema / properties / hideScores / description
      Previous value: -"Hide every score the respondent sees: the result page's overall score (score ring / number / percentile) and every dimension score, the points badge on each question while answering, the score in instant feedback, and the per-question scores in the answer review. Level names, level descriptions, the summary and right / wrong verdicts stay. The team still sees scores in the dashboard. Scenes with scores only (knowledge_quiz / random_knowledge_quiz / scored_quiz). Note the summary template still renders its score variable if one is left in. Off by default."New value: +"Hide every score the respondent sees: the result page's overall score (score ring / number / percentile) and every dimension score, the points badge on each question while answering, the score in instant feedback, and the per-question scores in the answer review. Level names, level descriptions, the summary and right / wrong verdicts stay. The team still sees scores in the dashboard. Scenes with scores only (knowledge_quiz / scored_quiz). Note the summary template still renders its score variable if one is left in. Off by default."
    • changedInput schema / properties / instantFeedback / description
      Previous value: -"Knowledge quizzes only (knowledge_quiz / random_knowledge_quiz). When on, the respondent submits each page on its own and sees whether they were right, the correct answer and the question's explanation; submitted questions lock before they move on, and the last page ends with a \"See results\" button that finishes the quiz. On by default for newly created knowledge quizzes except level tests (useCase level_test); existing quizzes keep whatever they had. Turns the quiz into a learn-as-you-go challenge; it does reveal answers question by question, so leave it off when the score is used for placement."New value: +"Knowledge quizzes only (knowledge_quiz). When on, the respondent submits each page on its own and sees whether they were right, the correct answer and the question's explanation; submitted questions lock before they move on, and the last page ends with a \"See results\" button that finishes the quiz. On by default for newly created knowledge quizzes except level tests (useCase level_test); existing quizzes keep whatever they had. Turns the quiz into a learn-as-you-go challenge; it does reveal answers question by question, so leave it off when the score is used for placement."
    • changedInput schema / properties / timeLimit / description
      Previous value: -"Answer-time countdown. Only knowledge quizzes (knowledge_quiz / random_knowledge_quiz) can turn this on — a countdown makes sense when unanswered means wrong, but rushing a scorecard or a personality quiz just produces careless answers."New value: +"Answer-time countdown. Only knowledge quizzes (knowledge_quiz) can turn this on — a countdown makes sense when unanswered means wrong, but rushing a scorecard or a personality quiz just produces careless answers."
  2. Changed1 schema field changed
    • changedOutput schema / properties / delivery / description
      Previous value: -"Delivery state: { isActive, submissionAccess, reportGateRequireCode, timeLimit, sharing, answerSheet, crowdCompare, instantFeedback, hideScores, booking, feedback, allowPdfDownload, resultRedirect, defaultCta, hiddenFields, sharedWithAll, searchIndexable }; get_form_share_info adds the team-level examineeSignupDisabled (respondent self-signup off = a login-gated quiz turns away anyone not on the roster)"New value: +"Delivery state: { isActive, submissionAccess, reportGateRequireCode, timeLimit, sharing, answerSheet, crowdCompare, instantFeedback, hideScores, booking, feedback, allowPdfDownload, resultRedirect, defaultCta, hiddenFields, sharedWithAll, searchIndexable }"
  3. Changed2 schema fields changed
    • addedInput schema / properties / defaultCta
      Added value: +{
      +  "anyOf": [
      +    {
      +      "additionalProperties": false,
      +      "properties": {
      +        "label": {
      +          "anyOf": [
      +            {
      +              "maxLength": 100,
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "Optional lead-in line shown above the default button"
      +        },
      +        "text": {
      +          "description": "Default button text (give it together with url, or leave both out)",
      +          "maxLength": 30,
      +          "type": "string"
      +        },
      +        "url": {
      +          "description": "Default button link; http/https only",
      +          "maxLength": 2048,
      +          "type": "string"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "description": "Result-page CTA buttons. This is the master switch: while it is off no result shows a CTA, not even levels / outcomes / AI result tags that have their own. Passing an object turns it on and replaces the default button (text + url), which every result without its own cta uses — pass {} to turn it on with no default, so only results with their own cta show a button. null turns it off and keeps the copy. Per-result buttons are set with update_form (writing one also turns this on). For AI quizzes the button appears below the AI report. Free on every plan."
      +}
    • changedOutput schema / properties / delivery / description
      Previous value: -"Delivery state: { isActive, submissionAccess, reportGateRequireCode, timeLimit, sharing, answerSheet, crowdCompare, instantFeedback, hideScores, booking, feedback, allowPdfDownload, resultRedirect, hiddenFields, sharedWithAll, searchIndexable }; get_form_share_info adds the team-level examineeSignupDisabled (respondent self-signup off = a login-gated quiz turns away anyone not on the roster)"New value: +"Delivery state: { isActive, submissionAccess, reportGateRequireCode, timeLimit, sharing, answerSheet, crowdCompare, instantFeedback, hideScores, booking, feedback, allowPdfDownload, resultRedirect, defaultCta, hiddenFields, sharedWithAll, searchIndexable }; get_form_share_info adds the team-level examineeSignupDisabled (respondent self-signup off = a login-gated quiz turns away anyone not on the roster)"
  4. Changed2 schema fields changed
    • addedInput schema / properties / resultRedirect
      Added value: +{
      +  "additionalProperties": false,
      +  "description": "Redirect after submission (Pro): respondents go straight to a link instead of the result page — after the login / lead gate if the report has one. The per-result links live on report.levels[i].redirectUrl (knowledge / scored quizzes) and report.outcomes[i].redirectUrl (outcome quizzes), set with update_form. Shared result links and return visits still open the result page. Only the keys you pass change.",
      +  "properties": {
      +    "appendParams": {
      +      "description": "Append score, level, outcome and outcome_name plus the quiz's hidden fields and UTM tags to the link (never emails or other personal details; parameters already in the link are kept).",
      +      "type": "boolean"
      +    },
      +    "defaultUrl": {
      +      "anyOf": [
      +        {
      +          "maxLength": 2048,
      +          "type": "string"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ],
      +      "description": "http(s) fallback link for respondents whose matched level / outcome has no redirectUrl of its own; \"\" or null removes it, and then those respondents see the result page."
      +    },
      +    "enabled": {
      +      "description": "Master switch. Pro only (switching it on is rejected on the Free plan). Not available for ai_quiz.",
      +      "type": "boolean"
      +    }
      +  },
      +  "type": "object"
      +}
    • changedOutput schema / properties / delivery / description
      Previous value: -"Delivery state: { isActive, submissionAccess, reportGateRequireCode, timeLimit, sharing, answerSheet, crowdCompare, instantFeedback, hideScores, booking, feedback, allowPdfDownload, hiddenFields, sharedWithAll, searchIndexable }; get_form_share_info adds the team-level examineeSignupDisabled (respondent self-signup off = a login-gated quiz turns away anyone not on the roster)"New value: +"Delivery state: { isActive, submissionAccess, reportGateRequireCode, timeLimit, sharing, answerSheet, crowdCompare, instantFeedback, hideScores, booking, feedback, allowPdfDownload, resultRedirect, hiddenFields, sharedWithAll, searchIndexable }; get_form_share_info adds the team-level examineeSignupDisabled (respondent self-signup off = a login-gated quiz turns away anyone not on the roster)"
  5. Changed3 schema fields changed
    • removedInput schema / properties / gaTrackingId
      Removed value: -{
      -  "description": "Google Analytics measurement id (G-XXXXXX) or Universal Analytics id (UA-XXXX-Y). Pass an empty string to clear.",
      -  "type": "string"
      -}
    • removedInput schema / properties / tracking
      Removed value: -{
      -  "anyOf": [
      -    {
      -      "additionalProperties": false,
      -      "properties": {
      -        "gtmContainerId": {
      -          "description": "Google Tag Manager container id (GTM-XXXX); only loaded on the team's custom domain",
      -          "type": "string"
      -        },
      -        "includeResultData": {
      -          "description": "Whether conversion events carry the outcome / level / score (default true). Turn off for sensitive topics such as health or finance.",
      -          "type": "boolean"
      -        },
      -        "linkedinConversionIds": {
      -          "additionalProperties": false,
      -          "description": "LinkedIn conversion ids created in Campaign Manager, one per event (quiz start, lead captured, quiz completed, result CTA click, booking)",
      -          "properties": {
      -            "booking": {
      -              "type": "string"
      -            },
      -            "complete": {
      -              "type": "string"
      -            },
      -            "cta": {
      -              "type": "string"
      -            },
      -            "lead": {
      -              "type": "string"
      -            },
      -            "start": {
      -              "type": "string"
      -            }
      -          },
      -          "type": "object"
      -        },
      -        "linkedinPartnerId": {
      -          "description": "LinkedIn Insight Tag partner id",
      -          "type": "string"
      -        },
      -        "metaPixelId": {
      -          "description": "Meta Pixel ID, 15-16 digits",
      -          "type": "string"
      -        },
      -        "mode": {
      -          "description": "inherit (default) uses the team's pixels, custom uses only the ids given here, off loads no pixel on this quiz",
      -          "enum": [
      -            "inherit",
      -            "custom",
      -            "off"
      -          ],
      -          "type": "string"
      -        },
      -        "tiktokPixelId": {
      -          "description": "TikTok Pixel code, uppercase letters and digits",
      -          "type": "string"
      -        }
      -      },
      -      "type": "object"
      -    },
      -    {
      -      "type": "null"
      -    }
      -  ],
      -  "description": "Ad tracking pixels for this quiz (Pro). Replaces the whole group; null clears it back to inheriting the team. Fires standard conversion events (quiz start, lead, completion, CTA click, booking) so ad platforms can optimise on them."
      -}
    • changedOutput schema / properties / delivery / description
      Previous value: -"Delivery state: { isActive, submissionAccess, reportGateRequireCode, timeLimit, sharing, answerSheet, crowdCompare, instantFeedback, hideScores, booking, feedback, allowPdfDownload, gaTrackingId, tracking, hiddenFields, sharedWithAll, searchIndexable }; get_form_share_info adds the team-level examineeSignupDisabled (respondent self-signup off = a login-gated quiz turns away anyone not on the roster)"New value: +"Delivery state: { isActive, submissionAccess, reportGateRequireCode, timeLimit, sharing, answerSheet, crowdCompare, instantFeedback, hideScores, booking, feedback, allowPdfDownload, hiddenFields, sharedWithAll, searchIndexable }; get_form_share_info adds the team-level examineeSignupDisabled (respondent self-signup off = a login-gated quiz turns away anyone not on the roster)"
  6. Changed6 schema fields changed
    • changedInput schema / properties / answerSheet / description
      Previous value: -"The answer-sheet sidebar on the answering page: a question navigator that lets respondents jump to any question. Off by default — most quizzes are meant to be answered straight through to the result page; turn it on for long knowledge quizzes."New value: +"The answer-sheet sidebar on the answering page: a question navigator that lets respondents jump to any question. On by default for newly created forms; turn it off for short quizzes meant to be answered straight through to the result page."
    • changedInput schema / properties / booking / properties / description / description
      Previous value: -"Block copy. Plain text or HTML (<p>, <strong>, <em>, <u>, <s>, <a href>, <ul>/<ol>/<li>); no images or video; at most 500 visible characters."New value: +"Block copy. Plain text or HTML (<p>, <strong>, <em>, <u>, <s>, <a href>, <ul>/<ol>/<li>), never Markdown; no images or video; at most 500 visible characters."
    • changedInput schema / properties / feedback / properties / description / description
      Previous value: -"Block copy; empty = built-in default. Plain text or HTML (<p>, <strong>, <em>, <u>, <s>, <a href>, <ul>/<ol>/<li>); no images or video; at most 500 visible characters."New value: +"Block copy; empty = built-in default. Plain text or HTML (<p>, <strong>, <em>, <u>, <s>, <a href>, <ul>/<ol>/<li>), never Markdown; no images or video; at most 500 visible characters."
    • addedInput schema / properties / hiddenFields
      Added value: +{
      +  "anyOf": [
      +    {
      +      "items": {
      +        "pattern": "^[a-z][a-z0-9_]{0,31}$",
      +        "type": "string"
      +      },
      +      "maxItems": 10,
      +      "type": "array"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "description": "URL parameters to capture with each response (hidden fields), e.g. [\"partner\", \"campaign_id\"]: opening the quiz link with ?partner=acme stores partner=acme on the record, where it shows in record detail, exports and webhook / Zapier payloads. Lowercase names, up to 10; utm_* and system names (email, name, lang, ref, embed…) are reserved. Replaces the whole list; null or [] clears it."
      +}
    • addedInput schema / properties / tracking
      Added value: +{
      +  "anyOf": [
      +    {
      +      "additionalProperties": false,
      +      "properties": {
      +        "gtmContainerId": {
      +          "description": "Google Tag Manager container id (GTM-XXXX); only loaded on the team's custom domain",
      +          "type": "string"
      +        },
      +        "includeResultData": {
      +          "description": "Whether conversion events carry the outcome / level / score (default true). Turn off for sensitive topics such as health or finance.",
      +          "type": "boolean"
      +        },
      +        "linkedinConversionIds": {
      +          "additionalProperties": false,
      +          "description": "LinkedIn conversion ids created in Campaign Manager, one per event (quiz start, lead captured, quiz completed, result CTA click, booking)",
      +          "properties": {
      +            "booking": {
      +              "type": "string"
      +            },
      +            "complete": {
      +              "type": "string"
      +            },
      +            "cta": {
      +              "type": "string"
      +            },
      +            "lead": {
      +              "type": "string"
      +            },
      +            "start": {
      +              "type": "string"
      +            }
      +          },
      +          "type": "object"
      +        },
      +        "linkedinPartnerId": {
      +          "description": "LinkedIn Insight Tag partner id",
      +          "type": "string"
      +        },
      +        "metaPixelId": {
      +          "description": "Meta Pixel ID, 15-16 digits",
      +          "type": "string"
      +        },
      +        "mode": {
      +          "description": "inherit (default) uses the team's pixels, custom uses only the ids given here, off loads no pixel on this quiz",
      +          "enum": [
      +            "inherit",
      +            "custom",
      +            "off"
      +          ],
      +          "type": "string"
      +        },
      +        "tiktokPixelId": {
      +          "description": "TikTok Pixel code, uppercase letters and digits",
      +          "type": "string"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "description": "Ad tracking pixels for this quiz (Pro). Replaces the whole group; null clears it back to inheriting the team. Fires standard conversion events (quiz start, lead, completion, CTA click, booking) so ad platforms can optimise on them."
      +}
    • changedOutput schema / properties / delivery / description
      Previous value: -"Delivery state: { isActive, submissionAccess, reportGateRequireCode, timeLimit, sharing, answerSheet, crowdCompare, instantFeedback, hideScores, booking, feedback, allowPdfDownload, gaTrackingId, sharedWithAll, searchIndexable }; get_form_share_info adds the team-level examineeSignupDisabled (respondent self-signup off = a login-gated quiz turns away anyone not on the roster)"New value: +"Delivery state: { isActive, submissionAccess, reportGateRequireCode, timeLimit, sharing, answerSheet, crowdCompare, instantFeedback, hideScores, booking, feedback, allowPdfDownload, gaTrackingId, tracking, hiddenFields, sharedWithAll, searchIndexable }; get_form_share_info adds the team-level examineeSignupDisabled (respondent self-signup off = a login-gated quiz turns away anyone not on the roster)"
  7. Changed1 schema field changed
    • changedInput schema / properties / answerSheet / description
      Previous value: -"The answer-sheet sidebar on the answering page"New value: +"The answer-sheet sidebar on the answering page: a question navigator that lets respondents jump to any question. Off by default — most quizzes are meant to be answered straight through to the result page; turn it on for long knowledge quizzes."
  8. Changed3 schema fields changed
    • changedInput schema / properties / allowPdfDownload / description
      Previous value: -"Let respondents download their full report as a PDF. Pro only (switching it on is rejected on the Free plan). Takes effect only on gated quizzes — submissionAccess login_to_view_report or examinee_only — because the download is tied to the signed-in respondent."New value: +"Let respondents download their full report as a PDF. Pro only (switching it on is rejected on the Free plan). Takes effect only on gated quizzes (submissionAccess login_to_view_report) because the download is tied to the signed-in respondent."
    • changedInput schema / properties / submissionAccess / description
      Previous value: -"public = anyone answers and sees the report; login_to_view_report = anyone answers but must sign in to see the report (the default, this is how leads get captured); examinee_only = a login is required before answering at all"New value: +"public = anyone answers and sees the report; login_to_view_report = anyone answers but must sign in to see the report (the default, this is how leads get captured)"
    • changedInput schema / properties / submissionAccess / enum
      Previous value: -[
      -  "public",
      -  "login_to_view_report",
      -  "examinee_only"
      -]New value: +[
      +  "public",
      +  "login_to_view_report"
      +]
  9. Changed1 schema field changed
    • changedInput schema / properties / instantFeedback / description
      Previous value: -"Knowledge quizzes only (knowledge_quiz / random_knowledge_quiz). When on, the respondent submits each page on its own and sees whether they were right, the correct answer and the question's explanation; submitted questions lock before they move on, and the last page ends with a \"See results\" button that finishes the quiz. Off by default. Turns the quiz into a learn-as-you-go challenge; it does reveal answers question by question, so leave it off when the score is used for placement."New value: +"Knowledge quizzes only (knowledge_quiz / random_knowledge_quiz). When on, the respondent submits each page on its own and sees whether they were right, the correct answer and the question's explanation; submitted questions lock before they move on, and the last page ends with a \"See results\" button that finishes the quiz. On by default for newly created knowledge quizzes except level tests (useCase level_test); existing quizzes keep whatever they had. Turns the quiz into a learn-as-you-go challenge; it does reveal answers question by question, so leave it off when the score is used for placement."
  10. Changed2 schema fields changed
    • addedInput schema / properties / hideScores
      Added value: +{
      +  "additionalProperties": false,
      +  "description": "Hide every score the respondent sees: the result page's overall score (score ring / number / percentile) and every dimension score, the points badge on each question while answering, the score in instant feedback, and the per-question scores in the answer review. Level names, level descriptions, the summary and right / wrong verdicts stay. The team still sees scores in the dashboard. Scenes with scores only (knowledge_quiz / random_knowledge_quiz / scored_quiz). Note the summary template still renders its score variable if one is left in. Off by default.",
      +  "properties": {
      +    "enabled": {
      +      "type": "boolean"
      +    }
      +  },
      +  "required": [
      +    "enabled"
      +  ],
      +  "type": "object"
      +}
    • changedOutput schema / properties / delivery / description
      Previous value: -"Delivery state: { isActive, submissionAccess, reportGateRequireCode, timeLimit, sharing, answerSheet, crowdCompare, instantFeedback, booking, feedback, allowPdfDownload, gaTrackingId, sharedWithAll, searchIndexable }; get_form_share_info adds the team-level examineeSignupDisabled (respondent self-signup off = a login-gated quiz turns away anyone not on the roster)"New value: +"Delivery state: { isActive, submissionAccess, reportGateRequireCode, timeLimit, sharing, answerSheet, crowdCompare, instantFeedback, hideScores, booking, feedback, allowPdfDownload, gaTrackingId, sharedWithAll, searchIndexable }; get_form_share_info adds the team-level examineeSignupDisabled (respondent self-signup off = a login-gated quiz turns away anyone not on the roster)"
  11. Changed2 schema fields changed
    • addedInput schema / properties / instantFeedback
      Added value: +{
      +  "additionalProperties": false,
      +  "description": "Knowledge quizzes only (knowledge_quiz / random_knowledge_quiz). When on, the respondent submits each page on its own and sees whether they were right, the correct answer and the question's explanation; submitted questions lock before they move on, and the last page ends with a \"See results\" button that finishes the quiz. Off by default. Turns the quiz into a learn-as-you-go challenge; it does reveal answers question by question, so leave it off when the score is used for placement.",
      +  "properties": {
      +    "enabled": {
      +      "type": "boolean"
      +    }
      +  },
      +  "required": [
      +    "enabled"
      +  ],
      +  "type": "object"
      +}
    • changedOutput schema / properties / delivery / description
      Previous value: -"Delivery state: { isActive, submissionAccess, reportGateRequireCode, timeLimit, sharing, answerSheet, crowdCompare, booking, feedback, allowPdfDownload, gaTrackingId, sharedWithAll, searchIndexable }; get_form_share_info adds the team-level examineeSignupDisabled (respondent self-signup off = a login-gated quiz turns away anyone not on the roster)"New value: +"Delivery state: { isActive, submissionAccess, reportGateRequireCode, timeLimit, sharing, answerSheet, crowdCompare, instantFeedback, booking, feedback, allowPdfDownload, gaTrackingId, sharedWithAll, searchIndexable }; get_form_share_info adds the team-level examineeSignupDisabled (respondent self-signup off = a login-gated quiz turns away anyone not on the roster)"
  12. Changed1 schema field changed
    • changedInput schema / properties / booking / properties / enabled / description
      Previous value: -"Whether the result page offers booking a 1:1 call"New value: +"Whether the result page shows the Cal.com booking block"
  13. Changed8 schema fields changed
    • changedInput schema / properties / booking / properties / description / description
      Previous value: -"Block copy"New value: +"Block copy. Plain text or HTML (<p>, <strong>, <em>, <u>, <s>, <a href>, <ul>/<ol>/<li>); no images or video; at most 500 visible characters."
    • changedInput schema / properties / booking / properties / description / maxLength
      Previous value: -500New value: +10000
    • changedInput schema / properties / booking / properties / title / description
      Previous value: -"Block heading; empty = built-in default"New value: +"Block heading; empty = built-in default. Plain text or inline HTML (<strong>, <u>, <s>, <mark>; no italic); at most 100 visible characters."
    • changedInput schema / properties / booking / properties / title / maxLength
      Previous value: -100New value: +2000
    • changedInput schema / properties / feedback / properties / description / description
      Previous value: -"Block copy; empty = built-in default"New value: +"Block copy; empty = built-in default. Plain text or HTML (<p>, <strong>, <em>, <u>, <s>, <a href>, <ul>/<ol>/<li>); no images or video; at most 500 visible characters."
    • changedInput schema / properties / feedback / properties / description / maxLength
      Previous value: -500New value: +10000
    • changedInput schema / properties / feedback / properties / title / description
      Previous value: -"Block heading; empty = built-in default"New value: +"Block heading; empty = built-in default. Plain text or inline HTML (<strong>, <u>, <s>, <mark>; no italic); at most 100 visible characters."
    • changedInput schema / properties / feedback / properties / title / maxLength
      Previous value: -100New value: +2000
  14. Changed1 schema field changed
    • changedInput schema / properties / booking / description
      Previous value: -"The result-page booking block: switch, copy and the Cal.com link respondents book through. With the team's Cal.com connector, bookings flow back and show up in list_bookings. Without a calLink the block falls back to the built-in scheduler, which is being retired."New value: +"The result-page booking block: switch, copy and the Cal.com link respondents book through. With the team's Cal.com connector, bookings flow back and show up in list_bookings. Without a calLink the block is not shown, even when enabled."
  15. Changed2 schema fields changed
    • changedInput schema / properties / booking / description
      Previous value: -"The result-page booking block. The bookable hours live in the team's booking settings, not here — this is only the switch and the copy. Bookings that come in are handled with list_bookings / review_booking."New value: +"The result-page booking block: switch, copy and the Cal.com link respondents book through. With the team's Cal.com connector, bookings flow back and show up in list_bookings. Without a calLink the block falls back to the built-in scheduler, which is being retired."
    • addedInput schema / properties / booking / properties / calLink
      Added value: +{
      +  "description": "Cal.com booking page the button opens, e.g. https://cal.com/jane/intro-call (cal.com or cal.eu only). Omit to leave it unchanged; empty string removes it.",
      +  "maxLength": 500,
      +  "type": "string"
      +}
  16. Changed4 schema fields changed
    • addedInput schema / properties / allowPdfDownload
      Added value: +{
      +  "description": "Let respondents download their full report as a PDF. Pro only (switching it on is rejected on the Free plan). Takes effect only on gated quizzes — submissionAccess login_to_view_report or examinee_only — because the download is tied to the signed-in respondent.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / feedback
      Added value: +{
      +  "additionalProperties": false,
      +  "description": "Result-page feedback block: one question asked after respondents read their report — tells you whether the result landed. Replaced WHOLESALE: read the current block from get_form_share_info and pass every key you want to keep (omitted copy falls back to the default, omitted choices are dropped).",
      +  "properties": {
      +    "allowComment": {
      +      "description": "rating / choice only: add an optional free-text comment box under the answer",
      +      "type": "boolean"
      +    },
      +    "answerType": {
      +      "description": "rating = 1-5 stars (default); choice = pick one of choices; text = free text",
      +      "enum": [
      +        "rating",
      +        "choice",
      +        "text"
      +      ],
      +      "type": "string"
      +    },
      +    "buttonText": {
      +      "description": "Submit button label; empty = built-in default",
      +      "maxLength": 30,
      +      "type": "string"
      +    },
      +    "choices": {
      +      "description": "answerType choice only: 2-6 options",
      +      "items": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "code": {
      +            "description": "Existing choice code from get_form_share_info — pass it back to keep past answers attached to this choice; omit for a new choice",
      +            "type": "string"
      +          },
      +          "label": {
      +            "maxLength": 100,
      +            "minLength": 1,
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "label"
      +        ],
      +        "type": "object"
      +      },
      +      "maxItems": 6,
      +      "type": "array"
      +    },
      +    "description": {
      +      "description": "Block copy; empty = built-in default",
      +      "maxLength": 500,
      +      "type": "string"
      +    },
      +    "enabled": {
      +      "description": "Whether the result page shows the feedback block",
      +      "type": "boolean"
      +    },
      +    "question": {
      +      "description": "The one question respondents answer, e.g. \"How useful was this report?\"; required when enabling",
      +      "maxLength": 200,
      +      "type": "string"
      +    },
      +    "title": {
      +      "description": "Block heading; empty = built-in default",
      +      "maxLength": 100,
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "enabled"
      +  ],
      +  "type": "object"
      +}
    • addedInput schema / properties / searchIndexable
      Added value: +{
      +  "description": "Whether search engines may list this quiz: true puts it in the sitemap and marks its public pages indexable, false keeps them out of search results (drafts, funnel pages meant only for one audience). New quizzes default to true.",
      +  "type": "boolean"
      +}
    • changedOutput schema / properties / delivery / description
      Previous value: -"Delivery state: { isActive, submissionAccess, reportGateRequireCode, timeLimit, sharing, answerSheet, booking, gaTrackingId, sharedWithAll }; get_form_share_info adds the team-level examineeSignupDisabled (respondent self-signup off = a login-gated quiz turns away anyone not on the roster)"New value: +"Delivery state: { isActive, submissionAccess, reportGateRequireCode, timeLimit, sharing, answerSheet, crowdCompare, booking, feedback, allowPdfDownload, gaTrackingId, sharedWithAll, searchIndexable }; get_form_share_info adds the team-level examineeSignupDisabled (respondent self-signup off = a login-gated quiz turns away anyone not on the roster)"
  17. Changed1 schema field changed
    • changedInput schema / properties / crowdCompare / description
      Previous value: -"Show respondents what share of people picked the same option (\"62% of people chose the same as you\"). Off by default: it publishes this quiz's answer distribution to whoever answers it, and seeing the majority choice nudges later respondents toward it — leave it off for quizzes used to match courses or place learners. Percentages only, never individual answers, and nothing shows until the quiz has 20+ submissions. Knowledge quizzes show it only in the answer review after submitting, since mid-quiz it would give the answer away."New value: +"Show respondents what share of people picked the same option (\"62% of people chose the same as you\"). Off by default: it publishes this quiz's answer distribution to whoever answers it, and seeing the majority choice nudges later respondents toward it — leave it off for quizzes used to match courses or place learners. Percentages only, never individual answers, and nothing shows until the quiz has 10+ submissions. Not available for knowledge quizzes at all: the distribution is effectively a crowdsourced answer key."
  18. Changed1 schema field changed
    • addedInput schema / properties / crowdCompare
      Added value: +{
      +  "additionalProperties": false,
      +  "description": "Show respondents what share of people picked the same option (\"62% of people chose the same as you\"). Off by default: it publishes this quiz's answer distribution to whoever answers it, and seeing the majority choice nudges later respondents toward it — leave it off for quizzes used to match courses or place learners. Percentages only, never individual answers, and nothing shows until the quiz has 20+ submissions. Knowledge quizzes show it only in the answer review after submitting, since mid-quiz it would give the answer away.",
      +  "properties": {
      +    "enabled": {
      +      "type": "boolean"
      +    }
      +  },
      +  "required": [
      +    "enabled"
      +  ],
      +  "type": "object"
      +}
  19. Changed2 schema fields changed
    • changedInput schema / properties / timeLimit / properties / minutes / description
      Previous value: -"Minutes allowed; required (>= 1) when enabling"New value: +"Minutes allowed; required when enabling, between 1 and 600"
    • addedInput schema / properties / timeLimit / properties / minutes / maximum
      Added value: +600
  20. Changed1 schema field changed
    • changedInput schema / properties / timeLimit / description
      Previous value: -"Answer-time countdown"New value: +"Answer-time countdown. Only knowledge quizzes (knowledge_quiz / random_knowledge_quiz) can turn this on — a countdown makes sense when unanswered means wrong, but rushing a scorecard or a personality quiz just produces careless answers."
  21. First observed

TDQS

Score is being calculated.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources