Edits a survey’s blocks in place — update, insert or remove whole blocks without resending the ones you are not changing. Operations apply in order against a single snapshot and are applied atomically: either all of them land or none do.
Blocks are addressed by id, never by position, so a concurrent edit cannot silently redirect an operation onto a different block. An update replaces the target block entirely, the same whole-subtree rule PATCH /api/v3/surveys/{surveyId} uses, and the replacement must carry every language the survey has configured.
Pass expectedUpdatedAt (the updatedAt from your last read) to make the write conditional; see the 409 response. Session cookie or x-api-key.
NextAuth session JWT cookie. Development: often next-auth.session-token.
Production (HTTPS): often __Secure-next-auth.session-token. Send the cookie your browser receives after sign-in.
Path Parameters
surveyId
string<cuid2>
required
Survey identifier.
Body
application/json
ops
object[]
required
Operations applied in order against a single snapshot, atomically — either all of them land or none do. Each operation resolves against the state left by the previous one, so an insert may anchor after a block an earlier operation inserted, and a remove followed by an insert of the same id is legal.
Required array length: 1 - 100 elements
A single block operation.
Option 1
Option 2
Option 3
Show child attributes
expectedUpdatedAt
string<date-time>
Optimistic-concurrency precondition: the survey's updatedAt from your last read. If the survey changed since, the write is rejected with 409 and the response carries the current value. Omit it to accept last-write-wins.
Response
Blocks updated; returns the full survey resource.
data
object
required
The three fields every SurveyListItem and SurveyResource carries, merged into both via allOf. All required, always present.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Documentation - Formbricks","colors":{"primary":"#00C4B8","light":"#00C4B8","dark":"#00C4B8"},"logo":{"light":"https://mintcdn.com/formbricks/wqEbm3FT1QK_6-vL/images/logo-light.svg?fit=max\u0026auto=format\u0026n=wqEbm3FT1QK_6-vL\u0026q=85\u0026s=365e5fb767b72b4fbbb2016860fd92ba","dark":"https://mintcdn.com/formbricks/wqEbm3FT1QK_6-vL/images/logo-dark.svg?fit=max\u0026auto=format\u0026n=wqEbm3FT1QK_6-vL\u0026q=85\u0026s=763690d005584ee5f4b4014615c3b98c"},"favicon":"https://mintcdn.com/formbricks/wqEbm3FT1QK_6-vL/images/favicon.svg?fit=max\u0026auto=format\u0026n=wqEbm3FT1QK_6-vL\u0026q=85\u0026s=01910ab43e3a3acc0aca5471235b90c5","navbar":{"links":[{"href":"/platform/changelog","label":"Release notes"},{"href":"https://github.com/formbricks/formbricks/discussions","label":"Support"}],"primary":{"type":"button","label":"Go to app","href":"https://app.formbricks.com"}},"footer":{"socials":{"github":"https://github.com/formbricks/formbricks","linkedin":"https://linkedin.com/company/formbricks","x":"https://x.com/formbricks"}},"integrations":{"posthog":{"apiKey":"phc_zJO1n3rjHlhqKiJ0gqLDwT4qvfWF1wzHDq2gfl0moQm","apiHost":"https://eu.i.posthog.com"}},"errors":{"404":{"redirect":true}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"formbricks","hasAudioNarration":false,"actualSubdomain":"formbricks","customDomains":["formbricks.com"],"gitSource":{"type":"github","owner":"formbricks","repo":"formbricks","deployBranch":"release/6.2","contentDirectory":"docs","isPrivate":false,"mountPath":"","label":"","_id":"6af9b4d1e79e0e5d7035333b"},"feedback":{"thumbs":true,"issues":true,"edits":true,"agentFeedback":false},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6af9b4d1e79e0e5d70353341","clientVersion":"0.0.4143","searchFilterCounts":[{"language":"default","tag":"Surveys (Ask)","count":99},{"language":"default","tag":"Self Hosting","count":86},{"language":"default","tag":"Surveys","count":76},{"language":"default","tag":"API v2 Reference (Beta)","count":41},{"language":"default","tag":"Upgrade","count":40},{"language":"default","tag":"API v1 Reference","count":36},{"language":"default","tag":"Upgrade by version","count":29},{"language":"default","tag":"Configure","count":28},{"language":"default","tag":"Platform","count":27},{"language":"default","tag":"Development","count":26}]},"assistantConfig":{},"basePath":"/docs","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-v3-reference/v3-surveys/edit-survey-blocks","slug":"/api-v3-reference/v3-surveys/edit-survey-blocks","pageMetadata":{"title":"Edit survey blocks","description":"Edits a survey's blocks in place — update, insert or remove whole blocks without resending the ones you are not changing. Operations apply in order against a single snapshot and are applied atomically: either all of them land or none do.\n\nBlocks are addressed by id, never by position, so a concurrent edit cannot silently redirect an operation onto a different block. An `update` replaces the target block entirely, the same whole-subtree rule `PATCH /api/v3/surveys/{surveyId}` uses, and the replacement must carry every language the survey has configured.\n\nPass `expectedUpdatedAt` (the `updatedAt` from your last read) to make the write conditional; see the **409** response. Session cookie or x-api-key.\n","deprecated":null,"version":null,"openapi":"/api-v3-reference/openapi.yml patch /api/v3/surveys/{surveyId}/blocks","href":"/api-v3-reference/v3-surveys/edit-survey-blocks","autogeneratedByOpenApi":true,"hidden":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n strong: \"strong\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Edits a survey’s blocks in place — update, insert or remove whole blocks without resending the ones you are not changing. Operations apply in order against a single snapshot and are applied atomically: either all of them land or none do.\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Blocks are addressed by id, never by position, so a concurrent edit cannot silently redirect an operation onto a different block. An \", _jsx(_components.code, {\n children: \"update\"\n }), \" replaces the target block entirely, the same whole-subtree rule \", _jsx(_components.code, {\n children: \"PATCH /api/v3/surveys/{surveyId}\"\n }), \" uses, and the replacement must carry every language the survey has configured.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Pass \", _jsx(_components.code, {\n children: \"expectedUpdatedAt\"\n }), \" (the \", _jsx(_components.code, {\n children: \"updatedAt\"\n }), \" from your last read) to make the write conditional; see the \", _jsx(_components.strong, {\n children: \"409\"\n }), \" response. Session cookie or x-api-key.\"]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Edit survey blocks","description":"Edits a survey's blocks in place — update, insert or remove whole blocks without resending the ones you are not changing. Operations apply in order against a single snapshot and are applied atomically: either all of them land or none do.\n\nBlocks are addressed by id, never by position, so a concurrent edit cannot silently redirect an operation onto a different block. An `update` replaces the target block entirely, the same whole-subtree rule `PATCH /api/v3/surveys/{surveyId}` uses, and the replacement must carry every language the survey has configured.\n\nPass `expectedUpdatedAt` (the `updatedAt` from your last read) to make the write conditional; see the **409** response. Session cookie or x-api-key.\n","deprecated":null,"version":null,"openapi":"/api-v3-reference/openapi.yml patch /api/v3/surveys/{surveyId}/blocks","href":"/api-v3-reference/v3-surveys/edit-survey-blocks","autogeneratedByOpenApi":true,"hidden":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/docs/_mintlify/custom/formbricks/7af300e0bdc69f45/formbricks.js"],"openApiReferenceData":{"operation":{"operationId":"editSurveyBlocksV3","summary":"Edit survey blocks","description":"Edits a survey's blocks in place — update, insert or remove whole blocks without resending the ones you are not changing. Operations apply in order against a single snapshot and are applied atomically: either all of them land or none do.\n\nBlocks are addressed by id, never by position, so a concurrent edit cannot silently redirect an operation onto a different block. An `update` replaces the target block entirely, the same whole-subtree rule `PATCH /api/v3/surveys/{surveyId}` uses, and the replacement must carry every language the survey has configured.\n\nPass `expectedUpdatedAt` (the `updatedAt` from your last read) to make the write conditional; see the **409** response. Session cookie or x-api-key.\n","tags":["V3 Surveys"],"parameters":["5134a771-1444-4cbb-bb5c-1cfc4326a02c"],"requestBody":"5e3863ae-2c21-4afe-98de-3ef76528611c","responses":{"200":"4f16c5f3-15b6-4bbb-aac7-2060415a8bb8","400":"cc8dc1d4-12b6-4362-b6b7-f1fb7119ff26","401":"15defb78-9a52-48e2-9802-c07bf309cd53","403":"cf0dfd8a-664f-4d7b-a8a7-43fe66b97622","409":"1c11f9c7-7fd0-494e-a520-c741a77a2d78","422":"757e39dd-9bf9-48b4-ae21-ff23999dc9e3","429":"7572a7db-f5a5-4785-bb53-2650cd0cd8f0","500":"6f56f1ae-2598-4c5b-a39a-294218fba096"},"security":["d2f12a3d-fdbd-43ab-8776-626a3b0dee11","af2d6811-bc93-4593-b882-e0ca1d4851cc","21ee008f-a86c-4994-8cac-f4558956651e"],"method":"patch","type":"path","servers":["bd5c2733-e216-4c58-8da0-ee079ace60b2"],"path":"/api/v3/surveys/{surveyId}/blocks","baseUrlOptions":["https://app.formbricks.com"],"title":"Edit survey blocks","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"5134a771-1444-4cbb-bb5c-1cfc4326a02c":{"in":"path","name":"surveyId","required":true,"schema":{"type":"string","format":"cuid2","isRequired":true,"description":"Survey identifier.","uniqueKey":"","typeLabel":"string\u003ccuid2>"},"description":"Survey identifier."}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["ops"],"properties":{"ops":{"type":"array","minItems":1,"maxItems":100,"items":{"oneOf":[{"type":"object","description":"A single block operation.","required":["op","id","block"],"properties":{"op":{"type":"string","enum":["update"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.op","typeLabel":"enum\u003cstring>"},"id":{"type":"string","maxLength":128,"minLength":1,"description":"Block to replace.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.id","typeLabel":"string"},"block":{"type":"object","description":"Replaces the target block entirely — the same whole-subtree rule PATCH uses. `block.id` is optional and taken from `id` when omitted; if present it must equal `id`.\n","required":["name","elements"],"properties":{"name":{"type":"string","minLength":1,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.name","typeLabel":"string"},"elements":{"type":"array","minItems":1,"items":{"oneOf":[{"type":"object","description":"Survey element/question inside a block. Element ids are stable public identifiers used by\nlogic, recall strings, response data, quotas, integrations, and analysis. `type` selects the\nallowed shape; unsupported fields are rejected instead of ignored.\n","required":["id","type","headline","required"],"properties":{"id":{"type":"string","pattern":"^[a-zA-Z0-9_-]+$","description":"Stable element id. Avoid spaces and reserved ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.0.id","typeLabel":"string"},"type":{"type":"string","enum":["openText"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.0.type","typeLabel":"enum\u003cstring>"},"headline":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.0.headline.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.0.headline","typeLabel":"object"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.0.required","typeLabel":"boolean"},"subheader":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.0.subheader.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.0.subheader","typeLabel":"object"},"imageUrl":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.0.imageUrl","typeLabel":"string"},"imageAltText":{"type":"object","description":"Text alternative for `imageUrl`, read by screen readers. Omit or leave empty for a decorative image (rendered as `alt=\"\"`).","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.0.imageAltText.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.0.imageAltText","typeLabel":"object"},"videoUrl":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.0.videoUrl","typeLabel":"string"},"isDraft":{"type":"boolean","description":"Draft marker used by the editor and future update rules.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.0.isDraft","typeLabel":"boolean"},"showIf":{"type":"object","description":"Show-if: the element is shown only when this condition group matches, re-evaluated live as answers above it on the same page change. A hidden element is not validated (a hidden required element never blocks submission) and its answer is not submitted. Conditions use the same operands and operators as block `logic`. Reference rule: an element's show-if may use answers from earlier blocks and from elements above it in the same block, never itself or anything below it; a violation fails with `misordered_reference` at the exact condition path. Omit it, or send an empty group, for an element that is always shown.","required":["id","connector","conditions"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.0.showIf.id","typeLabel":"string\u003ccuid2>"},"connector":{"type":"string","enum":["and","or"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.0.showIf.connector","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","items":{"oneOf":[{"type":"object","description":"Single condition. Operators such as `isSubmitted`, `isSkipped`, `isClicked`, `isAccepted`,\n`isBooked`, `isSet`, and `isEmpty` do not use `rightOperand`; comparison operators do.\n","required":["id","leftOperand","operator"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.0.showIf.conditions.items.[INDEX].oneOf.0.id","typeLabel":"string\u003ccuid2>"},"leftOperand":{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.0.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.0.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.0.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.0.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.0.showIf.conditions.items.[INDEX].oneOf.0.leftOperand","typeLabel":"object"},"operator":{"type":"string","enum":["equals","doesNotEqual","contains","doesNotContain","startsWith","doesNotStartWith","endsWith","doesNotEndWith","isSubmitted","isSkipped","isGreaterThan","isLessThan","isGreaterThanOrEqual","isLessThanOrEqual","equalsOneOf","includesAllOf","includesOneOf","doesNotIncludeOneOf","doesNotIncludeAllOf","isClicked","isNotClicked","isAccepted","isBefore","isAfter","isBooked","isPartiallySubmitted","isCompletelySubmitted","isSet","isNotSet","isEmpty","isNotEmpty","isAnyOf"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.0.showIf.conditions.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"rightOperand":{"oneOf":[{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.0.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.0.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.0.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.1","typeLabel":"number"},{"type":"array","items":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.0.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.0.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.0.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value","typeLabel":"string | number | string[]"},"columnId":{"type":"string","minLength":1,"description":"On a matrix row condition, the id of the column. Read before `value` and wins when the two disagree, so the condition survives reordering. Must be a column of the matrix. Optional: when only `value` is sent, the id is filled in from the position on write.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.0.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnId","typeLabel":"string"},"columnIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.0.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition with `isAnyOf`, the ids of the columns `value` lists. Read before `value`, like `columnId`.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.0.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.0.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0","typeLabel":"object"},{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.0.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.0.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.0.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.0.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.0.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1","typeLabel":"object"}],"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.0.showIf.conditions.items.[INDEX].oneOf.0.rightOperand","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.0.showIf.conditions.items.[INDEX].oneOf.0","typeLabel":"object"},{}],"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.0.showIf.conditions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.0.showIf.conditions","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.0.showIf","typeLabel":"object"},"code":{"type":"string","maxLength":30,"pattern":"^[a-z][a-z0-9_]*$","description":"Question code, the name the question carries in exports, webhooks and links. Optional. Starts with a lowercase letter, then lowercase letters, digits and `_`; no `__`, no trailing `_`, at most 30 characters. It must not be an SPSS reserved word (`all`, `and`, `by`, `eq`, `ge`, `gt`, `le`, `lt`, `ne`, `not`, `or`, `to`, `with`) or an export column name (`response_id`, `language`, `outcome`, ...), and must be unique among the survey's question codes, Embedded Data names and the Question IDs of other questions, ignoring case. CTA elements have no code.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.0.code","typeLabel":"string"},"placeholder":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.0.placeholder.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.0.placeholder","typeLabel":"object"},"longAnswer":{"type":"boolean","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.0.longAnswer","typeLabel":"boolean"},"inputType":{"type":"string","enum":["text","email","url","number","phone"],"default":"text","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.0.inputType","typeLabel":"enum\u003cstring>"},"insightsEnabled":{"type":"boolean","default":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.0.insightsEnabled","typeLabel":"boolean"},"charLimit":{"type":"object","description":"Optional `openText` character limit configuration.","properties":{"enabled":{"type":"boolean","default":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.0.charLimit.enabled","typeLabel":"boolean"},"min":{"type":"number","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.0.charLimit.min","typeLabel":"number"},"max":{"type":"number","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.0.charLimit.max","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.0.charLimit","typeLabel":"object"},"validation":{"type":"object","description":"Optional element-level validation rules.","required":["rules"],"properties":{"rules":{"type":"array","items":{"type":"object","required":["id","type","params"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.0.validation.rules.items.[INDEX].id","typeLabel":"string"},"type":{"type":"string","enum":["minLength","maxLength","pattern","email","url","phone","equals","doesNotEqual","contains","doesNotContain","minValue","maxValue","isGreaterThan","isLessThan","minSelections","maxSelections","minRanked","rankAll","minRowsAnswered","answerAllRows","isLaterThan","isEarlierThan","isBetween","isNotBetween","fileExtensionIs","fileExtensionIsNot"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.0.validation.rules.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"params":{"type":"object","additionalProperties":true,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.0.validation.rules.items.[INDEX].params","typeLabel":"object"},"field":{"type":"string","enum":["addressLine1","addressLine2","city","state","zip","country","firstName","lastName","email","phone","company"],"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.0.validation.rules.items.[INDEX].field","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.0.validation.rules.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.0.validation.rules","typeLabel":"object[]"},"logic":{"type":"string","enum":["and","or"],"default":"and","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.0.validation.logic","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.0.validation","typeLabel":"object"}},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","description":"Survey element/question inside a block. Element ids are stable public identifiers used by\nlogic, recall strings, response data, quotas, integrations, and analysis. `type` selects the\nallowed shape; unsupported fields are rejected instead of ignored.\n","required":["label","id","type","headline","required"],"properties":{"id":{"type":"string","pattern":"^[a-zA-Z0-9_-]+$","description":"Stable element id. Avoid spaces and reserved ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.1.id","typeLabel":"string"},"type":{"type":"string","enum":["consent"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.1.type","typeLabel":"enum\u003cstring>"},"headline":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.1.headline.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.1.headline","typeLabel":"object"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.1.required","typeLabel":"boolean"},"label":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.1.label.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.1.label","typeLabel":"object"},"subheader":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.1.subheader.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.1.subheader","typeLabel":"object"},"imageUrl":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.1.imageUrl","typeLabel":"string"},"imageAltText":{"type":"object","description":"Text alternative for `imageUrl`, read by screen readers. Omit or leave empty for a decorative image (rendered as `alt=\"\"`).","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.1.imageAltText.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.1.imageAltText","typeLabel":"object"},"videoUrl":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.1.videoUrl","typeLabel":"string"},"isDraft":{"type":"boolean","description":"Draft marker used by the editor and future update rules.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.1.isDraft","typeLabel":"boolean"},"showIf":{"type":"object","description":"Show-if: the element is shown only when this condition group matches, re-evaluated live as answers above it on the same page change. A hidden element is not validated (a hidden required element never blocks submission) and its answer is not submitted. Conditions use the same operands and operators as block `logic`. Reference rule: an element's show-if may use answers from earlier blocks and from elements above it in the same block, never itself or anything below it; a violation fails with `misordered_reference` at the exact condition path. Omit it, or send an empty group, for an element that is always shown.","required":["id","connector","conditions"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.1.showIf.id","typeLabel":"string\u003ccuid2>"},"connector":{"type":"string","enum":["and","or"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.1.showIf.connector","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","items":{"oneOf":[{"type":"object","description":"Single condition. Operators such as `isSubmitted`, `isSkipped`, `isClicked`, `isAccepted`,\n`isBooked`, `isSet`, and `isEmpty` do not use `rightOperand`; comparison operators do.\n","required":["id","leftOperand","operator"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.1.showIf.conditions.items.[INDEX].oneOf.0.id","typeLabel":"string\u003ccuid2>"},"leftOperand":{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.1.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.1.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.1.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.1.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.1.showIf.conditions.items.[INDEX].oneOf.0.leftOperand","typeLabel":"object"},"operator":{"type":"string","enum":["equals","doesNotEqual","contains","doesNotContain","startsWith","doesNotStartWith","endsWith","doesNotEndWith","isSubmitted","isSkipped","isGreaterThan","isLessThan","isGreaterThanOrEqual","isLessThanOrEqual","equalsOneOf","includesAllOf","includesOneOf","doesNotIncludeOneOf","doesNotIncludeAllOf","isClicked","isNotClicked","isAccepted","isBefore","isAfter","isBooked","isPartiallySubmitted","isCompletelySubmitted","isSet","isNotSet","isEmpty","isNotEmpty","isAnyOf"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.1.showIf.conditions.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"rightOperand":{"oneOf":[{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.1.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.1.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.1.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.1","typeLabel":"number"},{"type":"array","items":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.1.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.1.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.1.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value","typeLabel":"string | number | string[]"},"columnId":{"type":"string","minLength":1,"description":"On a matrix row condition, the id of the column. Read before `value` and wins when the two disagree, so the condition survives reordering. Must be a column of the matrix. Optional: when only `value` is sent, the id is filled in from the position on write.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.1.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnId","typeLabel":"string"},"columnIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.1.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition with `isAnyOf`, the ids of the columns `value` lists. Read before `value`, like `columnId`.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.1.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.1.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0","typeLabel":"object"},{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.1.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.1.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.1.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.1.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.1.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1","typeLabel":"object"}],"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.1.showIf.conditions.items.[INDEX].oneOf.0.rightOperand","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.1.showIf.conditions.items.[INDEX].oneOf.0","typeLabel":"object"},{}],"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.1.showIf.conditions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.1.showIf.conditions","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.1.showIf","typeLabel":"object"},"code":{"type":"string","maxLength":30,"pattern":"^[a-z][a-z0-9_]*$","description":"Question code, the name the question carries in exports, webhooks and links. Optional. Starts with a lowercase letter, then lowercase letters, digits and `_`; no `__`, no trailing `_`, at most 30 characters. It must not be an SPSS reserved word (`all`, `and`, `by`, `eq`, `ge`, `gt`, `le`, `lt`, `ne`, `not`, `or`, `to`, `with`) or an export column name (`response_id`, `language`, `outcome`, ...), and must be unique among the survey's question codes, Embedded Data names and the Question IDs of other questions, ignoring case. CTA elements have no code.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.1.code","typeLabel":"string"},"validation":{"type":"object","description":"Optional element-level validation rules.","required":["rules"],"properties":{"rules":{"type":"array","items":{"type":"object","required":["id","type","params"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.1.validation.rules.items.[INDEX].id","typeLabel":"string"},"type":{"type":"string","enum":["minLength","maxLength","pattern","email","url","phone","equals","doesNotEqual","contains","doesNotContain","minValue","maxValue","isGreaterThan","isLessThan","minSelections","maxSelections","minRanked","rankAll","minRowsAnswered","answerAllRows","isLaterThan","isEarlierThan","isBetween","isNotBetween","fileExtensionIs","fileExtensionIsNot"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.1.validation.rules.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"params":{"type":"object","additionalProperties":true,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.1.validation.rules.items.[INDEX].params","typeLabel":"object"},"field":{"type":"string","enum":["addressLine1","addressLine2","city","state","zip","country","firstName","lastName","email","phone","company"],"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.1.validation.rules.items.[INDEX].field","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.1.validation.rules.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.1.validation.rules","typeLabel":"object[]"},"logic":{"type":"string","enum":["and","or"],"default":"and","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.1.validation.logic","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.1.validation","typeLabel":"object"}},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.1","typeLabel":"object"},{"type":"object","description":"Survey element/question inside a block. Element ids are stable public identifiers used by\nlogic, recall strings, response data, quotas, integrations, and analysis. `type` selects the\nallowed shape; unsupported fields are rejected instead of ignored.\n","required":["choices","id","type","headline","required"],"properties":{"id":{"type":"string","pattern":"^[a-zA-Z0-9_-]+$","description":"Stable element id. Avoid spaces and reserved ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.2.id","typeLabel":"string"},"type":{"type":"string","enum":["multipleChoiceSingle"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.2.type","typeLabel":"enum\u003cstring>"},"headline":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.2.headline.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.2.headline","typeLabel":"object"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.2.required","typeLabel":"boolean"},"choices":{"type":"array","minItems":2,"items":{"type":"object","required":["id","label"],"properties":{"id":{"type":"string","description":"Stable choice id.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.2.choices.items.[INDEX].id","typeLabel":"string"},"label":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.2.choices.items.[INDEX].label.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.2.choices.items.[INDEX].label","typeLabel":"object"},"code":{"type":"string","maxLength":20,"pattern":"^[a-z0-9][a-z0-9_]*$","description":"Answer code of an option, a matrix row or a matrix column. Optional. Lowercase letters, digits and `_`; it may start with a digit, but not with `_`; no `__`, no trailing `_`, at most 20 characters. It must not be an SPSS reserved word or an export column name, and must be unique within its question (a matrix's rows and columns are checked separately), ignoring case.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.2.choices.items.[INDEX].code","typeLabel":"string"},"showIf":{"type":"object","description":"Option show-if: the option (or matrix row or column) is offered only when this condition group matches, re-evaluated live as earlier answers change. It may use what its element's show-if may use: answers from earlier blocks and from elements above its element in the same block, never its own element or anything below (`misordered_reference` at the exact condition path). A question left with no option to offer is skipped and recorded as not shown. Omit it, or send an empty group, for an option that is always offered. Allowed on published surveys.","required":["id","connector","conditions"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf.id","typeLabel":"string\u003ccuid2>"},"connector":{"type":"string","enum":["and","or"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf.connector","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","items":{"oneOf":[{"type":"object","description":"Single condition. Operators such as `isSubmitted`, `isSkipped`, `isClicked`, `isAccepted`,\n`isBooked`, `isSet`, and `isEmpty` do not use `rightOperand`; comparison operators do.\n","required":["id","leftOperand","operator"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.id","typeLabel":"string\u003ccuid2>"},"leftOperand":{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand","typeLabel":"object"},"operator":{"type":"string","enum":["equals","doesNotEqual","contains","doesNotContain","startsWith","doesNotStartWith","endsWith","doesNotEndWith","isSubmitted","isSkipped","isGreaterThan","isLessThan","isGreaterThanOrEqual","isLessThanOrEqual","equalsOneOf","includesAllOf","includesOneOf","doesNotIncludeOneOf","doesNotIncludeAllOf","isClicked","isNotClicked","isAccepted","isBefore","isAfter","isBooked","isPartiallySubmitted","isCompletelySubmitted","isSet","isNotSet","isEmpty","isNotEmpty","isAnyOf"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"rightOperand":{"oneOf":[{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.1","typeLabel":"number"},{"type":"array","items":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value","typeLabel":"string | number | string[]"},"columnId":{"type":"string","minLength":1,"description":"On a matrix row condition, the id of the column. Read before `value` and wins when the two disagree, so the condition survives reordering. Must be a column of the matrix. Optional: when only `value` is sent, the id is filled in from the position on write.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnId","typeLabel":"string"},"columnIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition with `isAnyOf`, the ids of the columns `value` lists. Read before `value`, like `columnId`.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0","typeLabel":"object"},{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1","typeLabel":"object"}],"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0","typeLabel":"object"},{}],"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf.conditions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf.conditions","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf","typeLabel":"object"},"hidden":{"type":"boolean","description":"Hidden: the option is never offered, whatever its `showIf` says, and is recorded as not shown. Use it to retire an option on a published survey instead of deleting it (deleting an option that existed at launch is refused): it keeps its id, answer code and earlier answers, and stays in results labelled Hidden.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.2.choices.items.[INDEX].hidden","typeLabel":"boolean"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.2.choices.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.2.choices","typeLabel":"object[]"},"subheader":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.2.subheader.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.2.subheader","typeLabel":"object"},"imageUrl":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.2.imageUrl","typeLabel":"string"},"imageAltText":{"type":"object","description":"Text alternative for `imageUrl`, read by screen readers. Omit or leave empty for a decorative image (rendered as `alt=\"\"`).","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.2.imageAltText.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.2.imageAltText","typeLabel":"object"},"videoUrl":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.2.videoUrl","typeLabel":"string"},"isDraft":{"type":"boolean","description":"Draft marker used by the editor and future update rules.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.2.isDraft","typeLabel":"boolean"},"showIf":{"type":"object","description":"Show-if: the element is shown only when this condition group matches, re-evaluated live as answers above it on the same page change. A hidden element is not validated (a hidden required element never blocks submission) and its answer is not submitted. Conditions use the same operands and operators as block `logic`. Reference rule: an element's show-if may use answers from earlier blocks and from elements above it in the same block, never itself or anything below it; a violation fails with `misordered_reference` at the exact condition path. Omit it, or send an empty group, for an element that is always shown.","required":["id","connector","conditions"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.2.showIf.id","typeLabel":"string\u003ccuid2>"},"connector":{"type":"string","enum":["and","or"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.2.showIf.connector","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","items":{"oneOf":[{"type":"object","description":"Single condition. Operators such as `isSubmitted`, `isSkipped`, `isClicked`, `isAccepted`,\n`isBooked`, `isSet`, and `isEmpty` do not use `rightOperand`; comparison operators do.\n","required":["id","leftOperand","operator"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.2.showIf.conditions.items.[INDEX].oneOf.0.id","typeLabel":"string\u003ccuid2>"},"leftOperand":{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.2.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.2.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.2.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.2.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.2.showIf.conditions.items.[INDEX].oneOf.0.leftOperand","typeLabel":"object"},"operator":{"type":"string","enum":["equals","doesNotEqual","contains","doesNotContain","startsWith","doesNotStartWith","endsWith","doesNotEndWith","isSubmitted","isSkipped","isGreaterThan","isLessThan","isGreaterThanOrEqual","isLessThanOrEqual","equalsOneOf","includesAllOf","includesOneOf","doesNotIncludeOneOf","doesNotIncludeAllOf","isClicked","isNotClicked","isAccepted","isBefore","isAfter","isBooked","isPartiallySubmitted","isCompletelySubmitted","isSet","isNotSet","isEmpty","isNotEmpty","isAnyOf"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.2.showIf.conditions.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"rightOperand":{"oneOf":[{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.2.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.2.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.2.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.1","typeLabel":"number"},{"type":"array","items":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.2.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.2.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.2.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value","typeLabel":"string | number | string[]"},"columnId":{"type":"string","minLength":1,"description":"On a matrix row condition, the id of the column. Read before `value` and wins when the two disagree, so the condition survives reordering. Must be a column of the matrix. Optional: when only `value` is sent, the id is filled in from the position on write.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.2.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnId","typeLabel":"string"},"columnIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.2.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition with `isAnyOf`, the ids of the columns `value` lists. Read before `value`, like `columnId`.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.2.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.2.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0","typeLabel":"object"},{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.2.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.2.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.2.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.2.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.2.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1","typeLabel":"object"}],"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.2.showIf.conditions.items.[INDEX].oneOf.0.rightOperand","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.2.showIf.conditions.items.[INDEX].oneOf.0","typeLabel":"object"},{}],"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.2.showIf.conditions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.2.showIf.conditions","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.2.showIf","typeLabel":"object"},"code":{"type":"string","maxLength":30,"pattern":"^[a-z][a-z0-9_]*$","description":"Question code, the name the question carries in exports, webhooks and links. Optional. Starts with a lowercase letter, then lowercase letters, digits and `_`; no `__`, no trailing `_`, at most 30 characters. It must not be an SPSS reserved word (`all`, `and`, `by`, `eq`, `ge`, `gt`, `le`, `lt`, `ne`, `not`, `or`, `to`, `with`) or an export column name (`response_id`, `language`, `outcome`, ...), and must be unique among the survey's question codes, Embedded Data names and the Question IDs of other questions, ignoring case. CTA elements have no code.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.2.code","typeLabel":"string"},"optionsCopiedFrom":{"type":"string","minLength":1,"description":"Copied options: the id of an earlier element whose options this element copies (\"only the brands you know\"). Choices copy from a single select, multi select or ranking; pictures from a picture selection (matrix rows are not copied: give rows a `showIf` on the source instead). Write the copies yourself: each copied option keeps the source option's `id` and `code`, and carries a `showIf` \"picked in the source\" (`includesOneOf` with its own id, or `equals` when the source is a single select), so the element offers exactly the options picked there. Copied codes follow the source's: a code sent for a copy is replaced by the source option's. Fixed options next to the copies (such as \"None of these\", id `none`) get the next code free in every linked element. The source must exist (`dangling_reference`), sit in an earlier block or above this element on its block (`misordered_reference`), and have options of the same kind (`invalid_reference`). To bring in options the source gained later, add them the same way.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.2.optionsCopiedFrom","typeLabel":"string"},"shuffleOption":{"type":"string","enum":["none","all","exceptLast","reverseOrderOccasionally","reverseOrderExceptLast"],"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.2.shuffleOption","typeLabel":"enum\u003cstring>"},"otherOptionPlaceholder":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.2.otherOptionPlaceholder.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.2.otherOptionPlaceholder","typeLabel":"object"},"displayType":{"type":"string","enum":["list","row","dropdown"],"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.2.displayType","typeLabel":"enum\u003cstring>"}},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.2","typeLabel":"object"},{"type":"object","description":"Survey element/question inside a block. Element ids are stable public identifiers used by\nlogic, recall strings, response data, quotas, integrations, and analysis. `type` selects the\nallowed shape; unsupported fields are rejected instead of ignored.\n","required":["choices","id","type","headline","required"],"properties":{"id":{"type":"string","pattern":"^[a-zA-Z0-9_-]+$","description":"Stable element id. Avoid spaces and reserved ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.id","typeLabel":"string"},"type":{"type":"string","enum":["multipleChoiceMulti"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.type","typeLabel":"enum\u003cstring>"},"headline":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.headline.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.headline","typeLabel":"object"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.required","typeLabel":"boolean"},"choices":{"type":"array","minItems":2,"items":{"type":"object","required":["id","label"],"properties":{"id":{"type":"string","description":"Stable choice id.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.choices.items.[INDEX].id","typeLabel":"string"},"label":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.choices.items.[INDEX].label.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.choices.items.[INDEX].label","typeLabel":"object"},"code":{"type":"string","maxLength":20,"pattern":"^[a-z0-9][a-z0-9_]*$","description":"Answer code of an option, a matrix row or a matrix column. Optional. Lowercase letters, digits and `_`; it may start with a digit, but not with `_`; no `__`, no trailing `_`, at most 20 characters. It must not be an SPSS reserved word or an export column name, and must be unique within its question (a matrix's rows and columns are checked separately), ignoring case.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.choices.items.[INDEX].code","typeLabel":"string"},"showIf":{"type":"object","description":"Option show-if: the option (or matrix row or column) is offered only when this condition group matches, re-evaluated live as earlier answers change. It may use what its element's show-if may use: answers from earlier blocks and from elements above its element in the same block, never its own element or anything below (`misordered_reference` at the exact condition path). A question left with no option to offer is skipped and recorded as not shown. Omit it, or send an empty group, for an option that is always offered. Allowed on published surveys.","required":["id","connector","conditions"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf.id","typeLabel":"string\u003ccuid2>"},"connector":{"type":"string","enum":["and","or"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf.connector","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","items":{"oneOf":[{"type":"object","description":"Single condition. Operators such as `isSubmitted`, `isSkipped`, `isClicked`, `isAccepted`,\n`isBooked`, `isSet`, and `isEmpty` do not use `rightOperand`; comparison operators do.\n","required":["id","leftOperand","operator"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.id","typeLabel":"string\u003ccuid2>"},"leftOperand":{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand","typeLabel":"object"},"operator":{"type":"string","enum":["equals","doesNotEqual","contains","doesNotContain","startsWith","doesNotStartWith","endsWith","doesNotEndWith","isSubmitted","isSkipped","isGreaterThan","isLessThan","isGreaterThanOrEqual","isLessThanOrEqual","equalsOneOf","includesAllOf","includesOneOf","doesNotIncludeOneOf","doesNotIncludeAllOf","isClicked","isNotClicked","isAccepted","isBefore","isAfter","isBooked","isPartiallySubmitted","isCompletelySubmitted","isSet","isNotSet","isEmpty","isNotEmpty","isAnyOf"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"rightOperand":{"oneOf":[{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.1","typeLabel":"number"},{"type":"array","items":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value","typeLabel":"string | number | string[]"},"columnId":{"type":"string","minLength":1,"description":"On a matrix row condition, the id of the column. Read before `value` and wins when the two disagree, so the condition survives reordering. Must be a column of the matrix. Optional: when only `value` is sent, the id is filled in from the position on write.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnId","typeLabel":"string"},"columnIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition with `isAnyOf`, the ids of the columns `value` lists. Read before `value`, like `columnId`.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0","typeLabel":"object"},{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1","typeLabel":"object"}],"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0","typeLabel":"object"},{}],"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf.conditions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf.conditions","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf","typeLabel":"object"},"hidden":{"type":"boolean","description":"Hidden: the option is never offered, whatever its `showIf` says, and is recorded as not shown. Use it to retire an option on a published survey instead of deleting it (deleting an option that existed at launch is refused): it keeps its id, answer code and earlier answers, and stays in results labelled Hidden.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.choices.items.[INDEX].hidden","typeLabel":"boolean"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.choices.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.choices","typeLabel":"object[]"},"subheader":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.subheader.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.subheader","typeLabel":"object"},"imageUrl":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.imageUrl","typeLabel":"string"},"imageAltText":{"type":"object","description":"Text alternative for `imageUrl`, read by screen readers. Omit or leave empty for a decorative image (rendered as `alt=\"\"`).","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.imageAltText.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.imageAltText","typeLabel":"object"},"videoUrl":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.videoUrl","typeLabel":"string"},"isDraft":{"type":"boolean","description":"Draft marker used by the editor and future update rules.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.isDraft","typeLabel":"boolean"},"showIf":{"type":"object","description":"Show-if: the element is shown only when this condition group matches, re-evaluated live as answers above it on the same page change. A hidden element is not validated (a hidden required element never blocks submission) and its answer is not submitted. Conditions use the same operands and operators as block `logic`. Reference rule: an element's show-if may use answers from earlier blocks and from elements above it in the same block, never itself or anything below it; a violation fails with `misordered_reference` at the exact condition path. Omit it, or send an empty group, for an element that is always shown.","required":["id","connector","conditions"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.showIf.id","typeLabel":"string\u003ccuid2>"},"connector":{"type":"string","enum":["and","or"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.showIf.connector","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","items":{"oneOf":[{"type":"object","description":"Single condition. Operators such as `isSubmitted`, `isSkipped`, `isClicked`, `isAccepted`,\n`isBooked`, `isSet`, and `isEmpty` do not use `rightOperand`; comparison operators do.\n","required":["id","leftOperand","operator"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.showIf.conditions.items.[INDEX].oneOf.0.id","typeLabel":"string\u003ccuid2>"},"leftOperand":{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.showIf.conditions.items.[INDEX].oneOf.0.leftOperand","typeLabel":"object"},"operator":{"type":"string","enum":["equals","doesNotEqual","contains","doesNotContain","startsWith","doesNotStartWith","endsWith","doesNotEndWith","isSubmitted","isSkipped","isGreaterThan","isLessThan","isGreaterThanOrEqual","isLessThanOrEqual","equalsOneOf","includesAllOf","includesOneOf","doesNotIncludeOneOf","doesNotIncludeAllOf","isClicked","isNotClicked","isAccepted","isBefore","isAfter","isBooked","isPartiallySubmitted","isCompletelySubmitted","isSet","isNotSet","isEmpty","isNotEmpty","isAnyOf"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.showIf.conditions.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"rightOperand":{"oneOf":[{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.1","typeLabel":"number"},{"type":"array","items":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value","typeLabel":"string | number | string[]"},"columnId":{"type":"string","minLength":1,"description":"On a matrix row condition, the id of the column. Read before `value` and wins when the two disagree, so the condition survives reordering. Must be a column of the matrix. Optional: when only `value` is sent, the id is filled in from the position on write.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnId","typeLabel":"string"},"columnIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition with `isAnyOf`, the ids of the columns `value` lists. Read before `value`, like `columnId`.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0","typeLabel":"object"},{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1","typeLabel":"object"}],"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.showIf.conditions.items.[INDEX].oneOf.0.rightOperand","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.showIf.conditions.items.[INDEX].oneOf.0","typeLabel":"object"},{}],"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.showIf.conditions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.showIf.conditions","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.showIf","typeLabel":"object"},"code":{"type":"string","maxLength":30,"pattern":"^[a-z][a-z0-9_]*$","description":"Question code, the name the question carries in exports, webhooks and links. Optional. Starts with a lowercase letter, then lowercase letters, digits and `_`; no `__`, no trailing `_`, at most 30 characters. It must not be an SPSS reserved word (`all`, `and`, `by`, `eq`, `ge`, `gt`, `le`, `lt`, `ne`, `not`, `or`, `to`, `with`) or an export column name (`response_id`, `language`, `outcome`, ...), and must be unique among the survey's question codes, Embedded Data names and the Question IDs of other questions, ignoring case. CTA elements have no code.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.code","typeLabel":"string"},"optionsCopiedFrom":{"type":"string","minLength":1,"description":"Copied options: the id of an earlier element whose options this element copies (\"only the brands you know\"). Choices copy from a single select, multi select or ranking; pictures from a picture selection (matrix rows are not copied: give rows a `showIf` on the source instead). Write the copies yourself: each copied option keeps the source option's `id` and `code`, and carries a `showIf` \"picked in the source\" (`includesOneOf` with its own id, or `equals` when the source is a single select), so the element offers exactly the options picked there. Copied codes follow the source's: a code sent for a copy is replaced by the source option's. Fixed options next to the copies (such as \"None of these\", id `none`) get the next code free in every linked element. The source must exist (`dangling_reference`), sit in an earlier block or above this element on its block (`misordered_reference`), and have options of the same kind (`invalid_reference`). To bring in options the source gained later, add them the same way.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.optionsCopiedFrom","typeLabel":"string"},"shuffleOption":{"type":"string","enum":["none","all","exceptLast","reverseOrderOccasionally","reverseOrderExceptLast"],"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.shuffleOption","typeLabel":"enum\u003cstring>"},"otherOptionPlaceholder":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.otherOptionPlaceholder.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.otherOptionPlaceholder","typeLabel":"object"},"validation":{"type":"object","description":"Optional element-level validation rules.","required":["rules"],"properties":{"rules":{"type":"array","items":{"type":"object","required":["id","type","params"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.validation.rules.items.[INDEX].id","typeLabel":"string"},"type":{"type":"string","enum":["minLength","maxLength","pattern","email","url","phone","equals","doesNotEqual","contains","doesNotContain","minValue","maxValue","isGreaterThan","isLessThan","minSelections","maxSelections","minRanked","rankAll","minRowsAnswered","answerAllRows","isLaterThan","isEarlierThan","isBetween","isNotBetween","fileExtensionIs","fileExtensionIsNot"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.validation.rules.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"params":{"type":"object","additionalProperties":true,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.validation.rules.items.[INDEX].params","typeLabel":"object"},"field":{"type":"string","enum":["addressLine1","addressLine2","city","state","zip","country","firstName","lastName","email","phone","company"],"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.validation.rules.items.[INDEX].field","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.validation.rules.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.validation.rules","typeLabel":"object[]"},"logic":{"type":"string","enum":["and","or"],"default":"and","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.validation.logic","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.validation","typeLabel":"object"},"displayType":{"type":"string","enum":["list","row","dropdown"],"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3.displayType","typeLabel":"enum\u003cstring>"}},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.3","typeLabel":"object"},{"type":"object","description":"Survey element/question inside a block. Element ids are stable public identifiers used by\nlogic, recall strings, response data, quotas, integrations, and analysis. `type` selects the\nallowed shape; unsupported fields are rejected instead of ignored.\n","required":["id","type","headline","required"],"properties":{"id":{"type":"string","pattern":"^[a-zA-Z0-9_-]+$","description":"Stable element id. Avoid spaces and reserved ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.4.id","typeLabel":"string"},"type":{"type":"string","enum":["nps"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.4.type","typeLabel":"enum\u003cstring>"},"headline":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.4.headline.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.4.headline","typeLabel":"object"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.4.required","typeLabel":"boolean"},"subheader":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.4.subheader.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.4.subheader","typeLabel":"object"},"imageUrl":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.4.imageUrl","typeLabel":"string"},"imageAltText":{"type":"object","description":"Text alternative for `imageUrl`, read by screen readers. Omit or leave empty for a decorative image (rendered as `alt=\"\"`).","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.4.imageAltText.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.4.imageAltText","typeLabel":"object"},"videoUrl":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.4.videoUrl","typeLabel":"string"},"isDraft":{"type":"boolean","description":"Draft marker used by the editor and future update rules.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.4.isDraft","typeLabel":"boolean"},"showIf":{"type":"object","description":"Show-if: the element is shown only when this condition group matches, re-evaluated live as answers above it on the same page change. A hidden element is not validated (a hidden required element never blocks submission) and its answer is not submitted. Conditions use the same operands and operators as block `logic`. Reference rule: an element's show-if may use answers from earlier blocks and from elements above it in the same block, never itself or anything below it; a violation fails with `misordered_reference` at the exact condition path. Omit it, or send an empty group, for an element that is always shown.","required":["id","connector","conditions"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.4.showIf.id","typeLabel":"string\u003ccuid2>"},"connector":{"type":"string","enum":["and","or"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.4.showIf.connector","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","items":{"oneOf":[{"type":"object","description":"Single condition. Operators such as `isSubmitted`, `isSkipped`, `isClicked`, `isAccepted`,\n`isBooked`, `isSet`, and `isEmpty` do not use `rightOperand`; comparison operators do.\n","required":["id","leftOperand","operator"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.4.showIf.conditions.items.[INDEX].oneOf.0.id","typeLabel":"string\u003ccuid2>"},"leftOperand":{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.4.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.4.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.4.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.4.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.4.showIf.conditions.items.[INDEX].oneOf.0.leftOperand","typeLabel":"object"},"operator":{"type":"string","enum":["equals","doesNotEqual","contains","doesNotContain","startsWith","doesNotStartWith","endsWith","doesNotEndWith","isSubmitted","isSkipped","isGreaterThan","isLessThan","isGreaterThanOrEqual","isLessThanOrEqual","equalsOneOf","includesAllOf","includesOneOf","doesNotIncludeOneOf","doesNotIncludeAllOf","isClicked","isNotClicked","isAccepted","isBefore","isAfter","isBooked","isPartiallySubmitted","isCompletelySubmitted","isSet","isNotSet","isEmpty","isNotEmpty","isAnyOf"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.4.showIf.conditions.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"rightOperand":{"oneOf":[{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.4.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.4.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.4.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.1","typeLabel":"number"},{"type":"array","items":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.4.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.4.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.4.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value","typeLabel":"string | number | string[]"},"columnId":{"type":"string","minLength":1,"description":"On a matrix row condition, the id of the column. Read before `value` and wins when the two disagree, so the condition survives reordering. Must be a column of the matrix. Optional: when only `value` is sent, the id is filled in from the position on write.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.4.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnId","typeLabel":"string"},"columnIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.4.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition with `isAnyOf`, the ids of the columns `value` lists. Read before `value`, like `columnId`.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.4.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.4.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0","typeLabel":"object"},{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.4.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.4.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.4.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.4.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.4.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1","typeLabel":"object"}],"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.4.showIf.conditions.items.[INDEX].oneOf.0.rightOperand","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.4.showIf.conditions.items.[INDEX].oneOf.0","typeLabel":"object"},{}],"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.4.showIf.conditions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.4.showIf.conditions","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.4.showIf","typeLabel":"object"},"code":{"type":"string","maxLength":30,"pattern":"^[a-z][a-z0-9_]*$","description":"Question code, the name the question carries in exports, webhooks and links. Optional. Starts with a lowercase letter, then lowercase letters, digits and `_`; no `__`, no trailing `_`, at most 30 characters. It must not be an SPSS reserved word (`all`, `and`, `by`, `eq`, `ge`, `gt`, `le`, `lt`, `ne`, `not`, `or`, `to`, `with`) or an export column name (`response_id`, `language`, `outcome`, ...), and must be unique among the survey's question codes, Embedded Data names and the Question IDs of other questions, ignoring case. CTA elements have no code.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.4.code","typeLabel":"string"},"lowerLabel":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.4.lowerLabel.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.4.lowerLabel","typeLabel":"object"},"upperLabel":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.4.upperLabel.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.4.upperLabel","typeLabel":"object"},"isColorCodingEnabled":{"type":"boolean","default":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.4.isColorCodingEnabled","typeLabel":"boolean"}},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.4","typeLabel":"object"},{"type":"object","description":"Survey element/question inside a block. Element ids are stable public identifiers used by\nlogic, recall strings, response data, quotas, integrations, and analysis. `type` selects the\nallowed shape; unsupported fields are rejected instead of ignored.\n","required":["id","type","headline","required"],"conditionallyRequiredProperties":{"buttonUrl":[{"when":[[{"property":"buttonExternal","values":[true]}]]}],"ctaButtonLabel":[{"when":[[{"property":"buttonExternal","values":[true]}]]}]},"properties":{"id":{"type":"string","pattern":"^[a-zA-Z0-9_-]+$","description":"Stable element id. Avoid spaces and reserved ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.5.id","typeLabel":"string"},"type":{"type":"string","enum":["cta"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.5.type","typeLabel":"enum\u003cstring>"},"headline":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.5.headline.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.5.headline","typeLabel":"object"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.5.required","typeLabel":"boolean"},"subheader":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.5.subheader.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.5.subheader","typeLabel":"object"},"imageUrl":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.5.imageUrl","typeLabel":"string"},"imageAltText":{"type":"object","description":"Text alternative for `imageUrl`, read by screen readers. Omit or leave empty for a decorative image (rendered as `alt=\"\"`).","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.5.imageAltText.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.5.imageAltText","typeLabel":"object"},"videoUrl":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.5.videoUrl","typeLabel":"string"},"isDraft":{"type":"boolean","description":"Draft marker used by the editor and future update rules.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.5.isDraft","typeLabel":"boolean"},"showIf":{"type":"object","description":"Show-if: the element is shown only when this condition group matches, re-evaluated live as answers above it on the same page change. A hidden element is not validated (a hidden required element never blocks submission) and its answer is not submitted. Conditions use the same operands and operators as block `logic`. Reference rule: an element's show-if may use answers from earlier blocks and from elements above it in the same block, never itself or anything below it; a violation fails with `misordered_reference` at the exact condition path. Omit it, or send an empty group, for an element that is always shown.","required":["id","connector","conditions"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.5.showIf.id","typeLabel":"string\u003ccuid2>"},"connector":{"type":"string","enum":["and","or"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.5.showIf.connector","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","items":{"oneOf":[{"type":"object","description":"Single condition. Operators such as `isSubmitted`, `isSkipped`, `isClicked`, `isAccepted`,\n`isBooked`, `isSet`, and `isEmpty` do not use `rightOperand`; comparison operators do.\n","required":["id","leftOperand","operator"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.5.showIf.conditions.items.[INDEX].oneOf.0.id","typeLabel":"string\u003ccuid2>"},"leftOperand":{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.5.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.5.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.5.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.5.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.5.showIf.conditions.items.[INDEX].oneOf.0.leftOperand","typeLabel":"object"},"operator":{"type":"string","enum":["equals","doesNotEqual","contains","doesNotContain","startsWith","doesNotStartWith","endsWith","doesNotEndWith","isSubmitted","isSkipped","isGreaterThan","isLessThan","isGreaterThanOrEqual","isLessThanOrEqual","equalsOneOf","includesAllOf","includesOneOf","doesNotIncludeOneOf","doesNotIncludeAllOf","isClicked","isNotClicked","isAccepted","isBefore","isAfter","isBooked","isPartiallySubmitted","isCompletelySubmitted","isSet","isNotSet","isEmpty","isNotEmpty","isAnyOf"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.5.showIf.conditions.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"rightOperand":{"oneOf":[{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.5.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.5.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.5.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.1","typeLabel":"number"},{"type":"array","items":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.5.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.5.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.5.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value","typeLabel":"string | number | string[]"},"columnId":{"type":"string","minLength":1,"description":"On a matrix row condition, the id of the column. Read before `value` and wins when the two disagree, so the condition survives reordering. Must be a column of the matrix. Optional: when only `value` is sent, the id is filled in from the position on write.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.5.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnId","typeLabel":"string"},"columnIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.5.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition with `isAnyOf`, the ids of the columns `value` lists. Read before `value`, like `columnId`.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.5.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.5.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0","typeLabel":"object"},{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.5.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.5.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.5.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.5.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.5.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1","typeLabel":"object"}],"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.5.showIf.conditions.items.[INDEX].oneOf.0.rightOperand","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.5.showIf.conditions.items.[INDEX].oneOf.0","typeLabel":"object"},{}],"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.5.showIf.conditions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.5.showIf.conditions","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.5.showIf","typeLabel":"object"},"buttonExternal":{"type":"boolean","default":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.5.buttonExternal","typeLabel":"boolean"},"buttonUrl":{"type":"string","conditionalRequirements":[{"when":[[{"property":"buttonExternal","values":[true]}]]}],"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.5.buttonUrl","typeLabel":"string"},"ctaButtonLabel":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.5.ctaButtonLabel.additionalProperties","typeLabel":"string"},"conditionalRequirements":[{"when":[[{"property":"buttonExternal","values":[true]}]]}],"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.5.ctaButtonLabel","typeLabel":"object"}},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.5","typeLabel":"object"},{"type":"object","description":"Survey element/question inside a block. Element ids are stable public identifiers used by\nlogic, recall strings, response data, quotas, integrations, and analysis. `type` selects the\nallowed shape; unsupported fields are rejected instead of ignored.\n","required":["scale","range","id","type","headline","required"],"properties":{"id":{"type":"string","pattern":"^[a-zA-Z0-9_-]+$","description":"Stable element id. Avoid spaces and reserved ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.6.id","typeLabel":"string"},"type":{"type":"string","enum":["rating"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.6.type","typeLabel":"enum\u003cstring>"},"headline":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.6.headline.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.6.headline","typeLabel":"object"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.6.required","typeLabel":"boolean"},"scale":{"type":"string","enum":["number","smiley","star"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.6.scale","typeLabel":"enum\u003cstring>"},"range":{"type":"integer","enum":[3,4,5,6,7,10],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.6.range","typeLabel":"enum\u003cinteger>"},"subheader":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.6.subheader.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.6.subheader","typeLabel":"object"},"imageUrl":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.6.imageUrl","typeLabel":"string"},"imageAltText":{"type":"object","description":"Text alternative for `imageUrl`, read by screen readers. Omit or leave empty for a decorative image (rendered as `alt=\"\"`).","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.6.imageAltText.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.6.imageAltText","typeLabel":"object"},"videoUrl":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.6.videoUrl","typeLabel":"string"},"isDraft":{"type":"boolean","description":"Draft marker used by the editor and future update rules.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.6.isDraft","typeLabel":"boolean"},"showIf":{"type":"object","description":"Show-if: the element is shown only when this condition group matches, re-evaluated live as answers above it on the same page change. A hidden element is not validated (a hidden required element never blocks submission) and its answer is not submitted. Conditions use the same operands and operators as block `logic`. Reference rule: an element's show-if may use answers from earlier blocks and from elements above it in the same block, never itself or anything below it; a violation fails with `misordered_reference` at the exact condition path. Omit it, or send an empty group, for an element that is always shown.","required":["id","connector","conditions"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.6.showIf.id","typeLabel":"string\u003ccuid2>"},"connector":{"type":"string","enum":["and","or"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.6.showIf.connector","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","items":{"oneOf":[{"type":"object","description":"Single condition. Operators such as `isSubmitted`, `isSkipped`, `isClicked`, `isAccepted`,\n`isBooked`, `isSet`, and `isEmpty` do not use `rightOperand`; comparison operators do.\n","required":["id","leftOperand","operator"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.6.showIf.conditions.items.[INDEX].oneOf.0.id","typeLabel":"string\u003ccuid2>"},"leftOperand":{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.6.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.6.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.6.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.6.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.6.showIf.conditions.items.[INDEX].oneOf.0.leftOperand","typeLabel":"object"},"operator":{"type":"string","enum":["equals","doesNotEqual","contains","doesNotContain","startsWith","doesNotStartWith","endsWith","doesNotEndWith","isSubmitted","isSkipped","isGreaterThan","isLessThan","isGreaterThanOrEqual","isLessThanOrEqual","equalsOneOf","includesAllOf","includesOneOf","doesNotIncludeOneOf","doesNotIncludeAllOf","isClicked","isNotClicked","isAccepted","isBefore","isAfter","isBooked","isPartiallySubmitted","isCompletelySubmitted","isSet","isNotSet","isEmpty","isNotEmpty","isAnyOf"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.6.showIf.conditions.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"rightOperand":{"oneOf":[{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.6.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.6.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.6.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.1","typeLabel":"number"},{"type":"array","items":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.6.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.6.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.6.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value","typeLabel":"string | number | string[]"},"columnId":{"type":"string","minLength":1,"description":"On a matrix row condition, the id of the column. Read before `value` and wins when the two disagree, so the condition survives reordering. Must be a column of the matrix. Optional: when only `value` is sent, the id is filled in from the position on write.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.6.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnId","typeLabel":"string"},"columnIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.6.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition with `isAnyOf`, the ids of the columns `value` lists. Read before `value`, like `columnId`.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.6.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.6.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0","typeLabel":"object"},{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.6.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.6.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.6.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.6.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.6.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1","typeLabel":"object"}],"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.6.showIf.conditions.items.[INDEX].oneOf.0.rightOperand","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.6.showIf.conditions.items.[INDEX].oneOf.0","typeLabel":"object"},{}],"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.6.showIf.conditions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.6.showIf.conditions","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.6.showIf","typeLabel":"object"},"code":{"type":"string","maxLength":30,"pattern":"^[a-z][a-z0-9_]*$","description":"Question code, the name the question carries in exports, webhooks and links. Optional. Starts with a lowercase letter, then lowercase letters, digits and `_`; no `__`, no trailing `_`, at most 30 characters. It must not be an SPSS reserved word (`all`, `and`, `by`, `eq`, `ge`, `gt`, `le`, `lt`, `ne`, `not`, `or`, `to`, `with`) or an export column name (`response_id`, `language`, `outcome`, ...), and must be unique among the survey's question codes, Embedded Data names and the Question IDs of other questions, ignoring case. CTA elements have no code.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.6.code","typeLabel":"string"},"lowerLabel":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.6.lowerLabel.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.6.lowerLabel","typeLabel":"object"},"upperLabel":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.6.upperLabel.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.6.upperLabel","typeLabel":"object"},"isColorCodingEnabled":{"type":"boolean","default":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.6.isColorCodingEnabled","typeLabel":"boolean"}},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.6","typeLabel":"object"},{"type":"object","description":"Survey element/question inside a block. Element ids are stable public identifiers used by\nlogic, recall strings, response data, quotas, integrations, and analysis. `type` selects the\nallowed shape; unsupported fields are rejected instead of ignored.\n","required":["choices","id","type","headline","required"],"properties":{"id":{"type":"string","pattern":"^[a-zA-Z0-9_-]+$","description":"Stable element id. Avoid spaces and reserved ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.id","typeLabel":"string"},"type":{"type":"string","enum":["pictureSelection"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.type","typeLabel":"enum\u003cstring>"},"headline":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.headline.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.headline","typeLabel":"object"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.required","typeLabel":"boolean"},"choices":{"type":"array","minItems":2,"items":{"type":"object","required":["id","imageUrl"],"properties":{"id":{"type":"string","description":"Stable picture choice id.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.choices.items.[INDEX].id","typeLabel":"string"},"imageUrl":{"type":"string","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.choices.items.[INDEX].imageUrl","typeLabel":"string"},"code":{"type":"string","maxLength":20,"pattern":"^[a-z0-9][a-z0-9_]*$","description":"Answer code of an option, a matrix row or a matrix column. Optional. Lowercase letters, digits and `_`; it may start with a digit, but not with `_`; no `__`, no trailing `_`, at most 20 characters. It must not be an SPSS reserved word or an export column name, and must be unique within its question (a matrix's rows and columns are checked separately), ignoring case.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.choices.items.[INDEX].code","typeLabel":"string"},"imageAltText":{"type":"object","description":"Text alternative for `imageUrl`, read by screen readers. Omit or leave empty to fall back to the positional label (\"Option 1\", \"Option 2\", …); a choice image is never decorative, since the respondent selects it.","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.choices.items.[INDEX].imageAltText.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.choices.items.[INDEX].imageAltText","typeLabel":"object"},"showIf":{"type":"object","description":"Option show-if: the option (or matrix row or column) is offered only when this condition group matches, re-evaluated live as earlier answers change. It may use what its element's show-if may use: answers from earlier blocks and from elements above its element in the same block, never its own element or anything below (`misordered_reference` at the exact condition path). A question left with no option to offer is skipped and recorded as not shown. Omit it, or send an empty group, for an option that is always offered. Allowed on published surveys.","required":["id","connector","conditions"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf.id","typeLabel":"string\u003ccuid2>"},"connector":{"type":"string","enum":["and","or"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf.connector","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","items":{"oneOf":[{"type":"object","description":"Single condition. Operators such as `isSubmitted`, `isSkipped`, `isClicked`, `isAccepted`,\n`isBooked`, `isSet`, and `isEmpty` do not use `rightOperand`; comparison operators do.\n","required":["id","leftOperand","operator"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.id","typeLabel":"string\u003ccuid2>"},"leftOperand":{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand","typeLabel":"object"},"operator":{"type":"string","enum":["equals","doesNotEqual","contains","doesNotContain","startsWith","doesNotStartWith","endsWith","doesNotEndWith","isSubmitted","isSkipped","isGreaterThan","isLessThan","isGreaterThanOrEqual","isLessThanOrEqual","equalsOneOf","includesAllOf","includesOneOf","doesNotIncludeOneOf","doesNotIncludeAllOf","isClicked","isNotClicked","isAccepted","isBefore","isAfter","isBooked","isPartiallySubmitted","isCompletelySubmitted","isSet","isNotSet","isEmpty","isNotEmpty","isAnyOf"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"rightOperand":{"oneOf":[{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.1","typeLabel":"number"},{"type":"array","items":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value","typeLabel":"string | number | string[]"},"columnId":{"type":"string","minLength":1,"description":"On a matrix row condition, the id of the column. Read before `value` and wins when the two disagree, so the condition survives reordering. Must be a column of the matrix. Optional: when only `value` is sent, the id is filled in from the position on write.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnId","typeLabel":"string"},"columnIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition with `isAnyOf`, the ids of the columns `value` lists. Read before `value`, like `columnId`.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0","typeLabel":"object"},{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1","typeLabel":"object"}],"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0","typeLabel":"object"},{}],"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf.conditions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf.conditions","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf","typeLabel":"object"},"hidden":{"type":"boolean","description":"Hidden: the option is never offered, whatever its `showIf` says, and is recorded as not shown. Use it to retire an option on a published survey instead of deleting it (deleting an option that existed at launch is refused): it keeps its id, answer code and earlier answers, and stays in results labelled Hidden.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.choices.items.[INDEX].hidden","typeLabel":"boolean"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.choices.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.choices","typeLabel":"object[]"},"subheader":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.subheader.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.subheader","typeLabel":"object"},"imageUrl":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.imageUrl","typeLabel":"string"},"imageAltText":{"type":"object","description":"Text alternative for `imageUrl`, read by screen readers. Omit or leave empty for a decorative image (rendered as `alt=\"\"`).","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.imageAltText.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.imageAltText","typeLabel":"object"},"videoUrl":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.videoUrl","typeLabel":"string"},"isDraft":{"type":"boolean","description":"Draft marker used by the editor and future update rules.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.isDraft","typeLabel":"boolean"},"showIf":{"type":"object","description":"Show-if: the element is shown only when this condition group matches, re-evaluated live as answers above it on the same page change. A hidden element is not validated (a hidden required element never blocks submission) and its answer is not submitted. Conditions use the same operands and operators as block `logic`. Reference rule: an element's show-if may use answers from earlier blocks and from elements above it in the same block, never itself or anything below it; a violation fails with `misordered_reference` at the exact condition path. Omit it, or send an empty group, for an element that is always shown.","required":["id","connector","conditions"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.showIf.id","typeLabel":"string\u003ccuid2>"},"connector":{"type":"string","enum":["and","or"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.showIf.connector","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","items":{"oneOf":[{"type":"object","description":"Single condition. Operators such as `isSubmitted`, `isSkipped`, `isClicked`, `isAccepted`,\n`isBooked`, `isSet`, and `isEmpty` do not use `rightOperand`; comparison operators do.\n","required":["id","leftOperand","operator"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.showIf.conditions.items.[INDEX].oneOf.0.id","typeLabel":"string\u003ccuid2>"},"leftOperand":{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.showIf.conditions.items.[INDEX].oneOf.0.leftOperand","typeLabel":"object"},"operator":{"type":"string","enum":["equals","doesNotEqual","contains","doesNotContain","startsWith","doesNotStartWith","endsWith","doesNotEndWith","isSubmitted","isSkipped","isGreaterThan","isLessThan","isGreaterThanOrEqual","isLessThanOrEqual","equalsOneOf","includesAllOf","includesOneOf","doesNotIncludeOneOf","doesNotIncludeAllOf","isClicked","isNotClicked","isAccepted","isBefore","isAfter","isBooked","isPartiallySubmitted","isCompletelySubmitted","isSet","isNotSet","isEmpty","isNotEmpty","isAnyOf"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.showIf.conditions.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"rightOperand":{"oneOf":[{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.1","typeLabel":"number"},{"type":"array","items":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value","typeLabel":"string | number | string[]"},"columnId":{"type":"string","minLength":1,"description":"On a matrix row condition, the id of the column. Read before `value` and wins when the two disagree, so the condition survives reordering. Must be a column of the matrix. Optional: when only `value` is sent, the id is filled in from the position on write.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnId","typeLabel":"string"},"columnIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition with `isAnyOf`, the ids of the columns `value` lists. Read before `value`, like `columnId`.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0","typeLabel":"object"},{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1","typeLabel":"object"}],"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.showIf.conditions.items.[INDEX].oneOf.0.rightOperand","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.showIf.conditions.items.[INDEX].oneOf.0","typeLabel":"object"},{}],"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.showIf.conditions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.showIf.conditions","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.showIf","typeLabel":"object"},"code":{"type":"string","maxLength":30,"pattern":"^[a-z][a-z0-9_]*$","description":"Question code, the name the question carries in exports, webhooks and links. Optional. Starts with a lowercase letter, then lowercase letters, digits and `_`; no `__`, no trailing `_`, at most 30 characters. It must not be an SPSS reserved word (`all`, `and`, `by`, `eq`, `ge`, `gt`, `le`, `lt`, `ne`, `not`, `or`, `to`, `with`) or an export column name (`response_id`, `language`, `outcome`, ...), and must be unique among the survey's question codes, Embedded Data names and the Question IDs of other questions, ignoring case. CTA elements have no code.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.code","typeLabel":"string"},"allowMulti":{"type":"boolean","default":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.allowMulti","typeLabel":"boolean"},"optionsCopiedFrom":{"type":"string","minLength":1,"description":"Copied options: the id of an earlier element whose options this element copies (\"only the brands you know\"). Choices copy from a single select, multi select or ranking; pictures from a picture selection (matrix rows are not copied: give rows a `showIf` on the source instead). Write the copies yourself: each copied option keeps the source option's `id` and `code`, and carries a `showIf` \"picked in the source\" (`includesOneOf` with its own id, or `equals` when the source is a single select), so the element offers exactly the options picked there. Copied codes follow the source's: a code sent for a copy is replaced by the source option's. Fixed options next to the copies (such as \"None of these\", id `none`) get the next code free in every linked element. The source must exist (`dangling_reference`), sit in an earlier block or above this element on its block (`misordered_reference`), and have options of the same kind (`invalid_reference`). To bring in options the source gained later, add them the same way.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.optionsCopiedFrom","typeLabel":"string"},"validation":{"type":"object","description":"Optional element-level validation rules.","required":["rules"],"properties":{"rules":{"type":"array","items":{"type":"object","required":["id","type","params"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.validation.rules.items.[INDEX].id","typeLabel":"string"},"type":{"type":"string","enum":["minLength","maxLength","pattern","email","url","phone","equals","doesNotEqual","contains","doesNotContain","minValue","maxValue","isGreaterThan","isLessThan","minSelections","maxSelections","minRanked","rankAll","minRowsAnswered","answerAllRows","isLaterThan","isEarlierThan","isBetween","isNotBetween","fileExtensionIs","fileExtensionIsNot"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.validation.rules.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"params":{"type":"object","additionalProperties":true,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.validation.rules.items.[INDEX].params","typeLabel":"object"},"field":{"type":"string","enum":["addressLine1","addressLine2","city","state","zip","country","firstName","lastName","email","phone","company"],"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.validation.rules.items.[INDEX].field","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.validation.rules.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.validation.rules","typeLabel":"object[]"},"logic":{"type":"string","enum":["and","or"],"default":"and","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.validation.logic","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7.validation","typeLabel":"object"}},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.7","typeLabel":"object"},{"type":"object","description":"Survey element/question inside a block. Element ids are stable public identifiers used by\nlogic, recall strings, response data, quotas, integrations, and analysis. `type` selects the\nallowed shape; unsupported fields are rejected instead of ignored.\n","required":["format","id","type","headline","required"],"properties":{"id":{"type":"string","pattern":"^[a-zA-Z0-9_-]+$","description":"Stable element id. Avoid spaces and reserved ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.8.id","typeLabel":"string"},"type":{"type":"string","enum":["date"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.8.type","typeLabel":"enum\u003cstring>"},"headline":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.8.headline.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.8.headline","typeLabel":"object"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.8.required","typeLabel":"boolean"},"format":{"type":"string","enum":["M-d-y","d-M-y","y-M-d"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.8.format","typeLabel":"enum\u003cstring>"},"subheader":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.8.subheader.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.8.subheader","typeLabel":"object"},"imageUrl":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.8.imageUrl","typeLabel":"string"},"imageAltText":{"type":"object","description":"Text alternative for `imageUrl`, read by screen readers. Omit or leave empty for a decorative image (rendered as `alt=\"\"`).","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.8.imageAltText.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.8.imageAltText","typeLabel":"object"},"videoUrl":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.8.videoUrl","typeLabel":"string"},"isDraft":{"type":"boolean","description":"Draft marker used by the editor and future update rules.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.8.isDraft","typeLabel":"boolean"},"showIf":{"type":"object","description":"Show-if: the element is shown only when this condition group matches, re-evaluated live as answers above it on the same page change. A hidden element is not validated (a hidden required element never blocks submission) and its answer is not submitted. Conditions use the same operands and operators as block `logic`. Reference rule: an element's show-if may use answers from earlier blocks and from elements above it in the same block, never itself or anything below it; a violation fails with `misordered_reference` at the exact condition path. Omit it, or send an empty group, for an element that is always shown.","required":["id","connector","conditions"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.8.showIf.id","typeLabel":"string\u003ccuid2>"},"connector":{"type":"string","enum":["and","or"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.8.showIf.connector","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","items":{"oneOf":[{"type":"object","description":"Single condition. Operators such as `isSubmitted`, `isSkipped`, `isClicked`, `isAccepted`,\n`isBooked`, `isSet`, and `isEmpty` do not use `rightOperand`; comparison operators do.\n","required":["id","leftOperand","operator"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.8.showIf.conditions.items.[INDEX].oneOf.0.id","typeLabel":"string\u003ccuid2>"},"leftOperand":{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.8.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.8.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.8.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.8.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.8.showIf.conditions.items.[INDEX].oneOf.0.leftOperand","typeLabel":"object"},"operator":{"type":"string","enum":["equals","doesNotEqual","contains","doesNotContain","startsWith","doesNotStartWith","endsWith","doesNotEndWith","isSubmitted","isSkipped","isGreaterThan","isLessThan","isGreaterThanOrEqual","isLessThanOrEqual","equalsOneOf","includesAllOf","includesOneOf","doesNotIncludeOneOf","doesNotIncludeAllOf","isClicked","isNotClicked","isAccepted","isBefore","isAfter","isBooked","isPartiallySubmitted","isCompletelySubmitted","isSet","isNotSet","isEmpty","isNotEmpty","isAnyOf"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.8.showIf.conditions.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"rightOperand":{"oneOf":[{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.8.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.8.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.8.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.1","typeLabel":"number"},{"type":"array","items":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.8.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.8.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.8.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value","typeLabel":"string | number | string[]"},"columnId":{"type":"string","minLength":1,"description":"On a matrix row condition, the id of the column. Read before `value` and wins when the two disagree, so the condition survives reordering. Must be a column of the matrix. Optional: when only `value` is sent, the id is filled in from the position on write.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.8.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnId","typeLabel":"string"},"columnIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.8.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition with `isAnyOf`, the ids of the columns `value` lists. Read before `value`, like `columnId`.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.8.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.8.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0","typeLabel":"object"},{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.8.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.8.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.8.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.8.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.8.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1","typeLabel":"object"}],"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.8.showIf.conditions.items.[INDEX].oneOf.0.rightOperand","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.8.showIf.conditions.items.[INDEX].oneOf.0","typeLabel":"object"},{}],"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.8.showIf.conditions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.8.showIf.conditions","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.8.showIf","typeLabel":"object"},"code":{"type":"string","maxLength":30,"pattern":"^[a-z][a-z0-9_]*$","description":"Question code, the name the question carries in exports, webhooks and links. Optional. Starts with a lowercase letter, then lowercase letters, digits and `_`; no `__`, no trailing `_`, at most 30 characters. It must not be an SPSS reserved word (`all`, `and`, `by`, `eq`, `ge`, `gt`, `le`, `lt`, `ne`, `not`, `or`, `to`, `with`) or an export column name (`response_id`, `language`, `outcome`, ...), and must be unique among the survey's question codes, Embedded Data names and the Question IDs of other questions, ignoring case. CTA elements have no code.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.8.code","typeLabel":"string"},"html":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.8.html.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.8.html","typeLabel":"object"},"validation":{"type":"object","description":"Optional element-level validation rules.","required":["rules"],"properties":{"rules":{"type":"array","items":{"type":"object","required":["id","type","params"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.8.validation.rules.items.[INDEX].id","typeLabel":"string"},"type":{"type":"string","enum":["minLength","maxLength","pattern","email","url","phone","equals","doesNotEqual","contains","doesNotContain","minValue","maxValue","isGreaterThan","isLessThan","minSelections","maxSelections","minRanked","rankAll","minRowsAnswered","answerAllRows","isLaterThan","isEarlierThan","isBetween","isNotBetween","fileExtensionIs","fileExtensionIsNot"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.8.validation.rules.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"params":{"type":"object","additionalProperties":true,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.8.validation.rules.items.[INDEX].params","typeLabel":"object"},"field":{"type":"string","enum":["addressLine1","addressLine2","city","state","zip","country","firstName","lastName","email","phone","company"],"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.8.validation.rules.items.[INDEX].field","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.8.validation.rules.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.8.validation.rules","typeLabel":"object[]"},"logic":{"type":"string","enum":["and","or"],"default":"and","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.8.validation.logic","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.8.validation","typeLabel":"object"}},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.8","typeLabel":"object"},{"type":"object","description":"Survey element/question inside a block. Element ids are stable public identifiers used by\nlogic, recall strings, response data, quotas, integrations, and analysis. `type` selects the\nallowed shape; unsupported fields are rejected instead of ignored.\n","required":["allowMultipleFiles","id","type","headline","required"],"properties":{"id":{"type":"string","pattern":"^[a-zA-Z0-9_-]+$","description":"Stable element id. Avoid spaces and reserved ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.9.id","typeLabel":"string"},"type":{"type":"string","enum":["fileUpload"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.9.type","typeLabel":"enum\u003cstring>"},"headline":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.9.headline.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.9.headline","typeLabel":"object"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.9.required","typeLabel":"boolean"},"allowMultipleFiles":{"type":"boolean","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.9.allowMultipleFiles","typeLabel":"boolean"},"subheader":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.9.subheader.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.9.subheader","typeLabel":"object"},"imageUrl":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.9.imageUrl","typeLabel":"string"},"imageAltText":{"type":"object","description":"Text alternative for `imageUrl`, read by screen readers. Omit or leave empty for a decorative image (rendered as `alt=\"\"`).","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.9.imageAltText.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.9.imageAltText","typeLabel":"object"},"videoUrl":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.9.videoUrl","typeLabel":"string"},"isDraft":{"type":"boolean","description":"Draft marker used by the editor and future update rules.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.9.isDraft","typeLabel":"boolean"},"showIf":{"type":"object","description":"Show-if: the element is shown only when this condition group matches, re-evaluated live as answers above it on the same page change. A hidden element is not validated (a hidden required element never blocks submission) and its answer is not submitted. Conditions use the same operands and operators as block `logic`. Reference rule: an element's show-if may use answers from earlier blocks and from elements above it in the same block, never itself or anything below it; a violation fails with `misordered_reference` at the exact condition path. Omit it, or send an empty group, for an element that is always shown.","required":["id","connector","conditions"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.9.showIf.id","typeLabel":"string\u003ccuid2>"},"connector":{"type":"string","enum":["and","or"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.9.showIf.connector","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","items":{"oneOf":[{"type":"object","description":"Single condition. Operators such as `isSubmitted`, `isSkipped`, `isClicked`, `isAccepted`,\n`isBooked`, `isSet`, and `isEmpty` do not use `rightOperand`; comparison operators do.\n","required":["id","leftOperand","operator"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.9.showIf.conditions.items.[INDEX].oneOf.0.id","typeLabel":"string\u003ccuid2>"},"leftOperand":{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.9.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.9.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.9.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.9.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.9.showIf.conditions.items.[INDEX].oneOf.0.leftOperand","typeLabel":"object"},"operator":{"type":"string","enum":["equals","doesNotEqual","contains","doesNotContain","startsWith","doesNotStartWith","endsWith","doesNotEndWith","isSubmitted","isSkipped","isGreaterThan","isLessThan","isGreaterThanOrEqual","isLessThanOrEqual","equalsOneOf","includesAllOf","includesOneOf","doesNotIncludeOneOf","doesNotIncludeAllOf","isClicked","isNotClicked","isAccepted","isBefore","isAfter","isBooked","isPartiallySubmitted","isCompletelySubmitted","isSet","isNotSet","isEmpty","isNotEmpty","isAnyOf"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.9.showIf.conditions.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"rightOperand":{"oneOf":[{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.9.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.9.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.9.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.1","typeLabel":"number"},{"type":"array","items":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.9.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.9.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.9.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value","typeLabel":"string | number | string[]"},"columnId":{"type":"string","minLength":1,"description":"On a matrix row condition, the id of the column. Read before `value` and wins when the two disagree, so the condition survives reordering. Must be a column of the matrix. Optional: when only `value` is sent, the id is filled in from the position on write.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.9.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnId","typeLabel":"string"},"columnIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.9.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition with `isAnyOf`, the ids of the columns `value` lists. Read before `value`, like `columnId`.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.9.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.9.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0","typeLabel":"object"},{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.9.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.9.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.9.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.9.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.9.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1","typeLabel":"object"}],"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.9.showIf.conditions.items.[INDEX].oneOf.0.rightOperand","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.9.showIf.conditions.items.[INDEX].oneOf.0","typeLabel":"object"},{}],"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.9.showIf.conditions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.9.showIf.conditions","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.9.showIf","typeLabel":"object"},"code":{"type":"string","maxLength":30,"pattern":"^[a-z][a-z0-9_]*$","description":"Question code, the name the question carries in exports, webhooks and links. Optional. Starts with a lowercase letter, then lowercase letters, digits and `_`; no `__`, no trailing `_`, at most 30 characters. It must not be an SPSS reserved word (`all`, `and`, `by`, `eq`, `ge`, `gt`, `le`, `lt`, `ne`, `not`, `or`, `to`, `with`) or an export column name (`response_id`, `language`, `outcome`, ...), and must be unique among the survey's question codes, Embedded Data names and the Question IDs of other questions, ignoring case. CTA elements have no code.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.9.code","typeLabel":"string"},"maxSizeInMB":{"type":"number","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.9.maxSizeInMB","typeLabel":"number"},"allowedFileExtensions":{"type":"array","items":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.9.allowedFileExtensions.items.[INDEX]","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.9.allowedFileExtensions","typeLabel":"string[]"},"validation":{"type":"object","description":"Optional element-level validation rules.","required":["rules"],"properties":{"rules":{"type":"array","items":{"type":"object","required":["id","type","params"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.9.validation.rules.items.[INDEX].id","typeLabel":"string"},"type":{"type":"string","enum":["minLength","maxLength","pattern","email","url","phone","equals","doesNotEqual","contains","doesNotContain","minValue","maxValue","isGreaterThan","isLessThan","minSelections","maxSelections","minRanked","rankAll","minRowsAnswered","answerAllRows","isLaterThan","isEarlierThan","isBetween","isNotBetween","fileExtensionIs","fileExtensionIsNot"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.9.validation.rules.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"params":{"type":"object","additionalProperties":true,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.9.validation.rules.items.[INDEX].params","typeLabel":"object"},"field":{"type":"string","enum":["addressLine1","addressLine2","city","state","zip","country","firstName","lastName","email","phone","company"],"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.9.validation.rules.items.[INDEX].field","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.9.validation.rules.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.9.validation.rules","typeLabel":"object[]"},"logic":{"type":"string","enum":["and","or"],"default":"and","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.9.validation.logic","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.9.validation","typeLabel":"object"}},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.9","typeLabel":"object"},{"type":"object","description":"Survey element/question inside a block. Element ids are stable public identifiers used by\nlogic, recall strings, response data, quotas, integrations, and analysis. `type` selects the\nallowed shape; unsupported fields are rejected instead of ignored.\n","required":["calUserName","id","type","headline","required"],"properties":{"id":{"type":"string","pattern":"^[a-zA-Z0-9_-]+$","description":"Stable element id. Avoid spaces and reserved ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.10.id","typeLabel":"string"},"type":{"type":"string","enum":["cal"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.10.type","typeLabel":"enum\u003cstring>"},"headline":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.10.headline.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.10.headline","typeLabel":"object"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.10.required","typeLabel":"boolean"},"calUserName":{"type":"string","minLength":1,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.10.calUserName","typeLabel":"string"},"subheader":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.10.subheader.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.10.subheader","typeLabel":"object"},"imageUrl":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.10.imageUrl","typeLabel":"string"},"imageAltText":{"type":"object","description":"Text alternative for `imageUrl`, read by screen readers. Omit or leave empty for a decorative image (rendered as `alt=\"\"`).","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.10.imageAltText.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.10.imageAltText","typeLabel":"object"},"videoUrl":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.10.videoUrl","typeLabel":"string"},"isDraft":{"type":"boolean","description":"Draft marker used by the editor and future update rules.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.10.isDraft","typeLabel":"boolean"},"showIf":{"type":"object","description":"Show-if: the element is shown only when this condition group matches, re-evaluated live as answers above it on the same page change. A hidden element is not validated (a hidden required element never blocks submission) and its answer is not submitted. Conditions use the same operands and operators as block `logic`. Reference rule: an element's show-if may use answers from earlier blocks and from elements above it in the same block, never itself or anything below it; a violation fails with `misordered_reference` at the exact condition path. Omit it, or send an empty group, for an element that is always shown.","required":["id","connector","conditions"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.10.showIf.id","typeLabel":"string\u003ccuid2>"},"connector":{"type":"string","enum":["and","or"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.10.showIf.connector","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","items":{"oneOf":[{"type":"object","description":"Single condition. Operators such as `isSubmitted`, `isSkipped`, `isClicked`, `isAccepted`,\n`isBooked`, `isSet`, and `isEmpty` do not use `rightOperand`; comparison operators do.\n","required":["id","leftOperand","operator"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.10.showIf.conditions.items.[INDEX].oneOf.0.id","typeLabel":"string\u003ccuid2>"},"leftOperand":{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.10.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.10.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.10.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.10.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.10.showIf.conditions.items.[INDEX].oneOf.0.leftOperand","typeLabel":"object"},"operator":{"type":"string","enum":["equals","doesNotEqual","contains","doesNotContain","startsWith","doesNotStartWith","endsWith","doesNotEndWith","isSubmitted","isSkipped","isGreaterThan","isLessThan","isGreaterThanOrEqual","isLessThanOrEqual","equalsOneOf","includesAllOf","includesOneOf","doesNotIncludeOneOf","doesNotIncludeAllOf","isClicked","isNotClicked","isAccepted","isBefore","isAfter","isBooked","isPartiallySubmitted","isCompletelySubmitted","isSet","isNotSet","isEmpty","isNotEmpty","isAnyOf"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.10.showIf.conditions.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"rightOperand":{"oneOf":[{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.10.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.10.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.10.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.1","typeLabel":"number"},{"type":"array","items":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.10.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.10.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.10.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value","typeLabel":"string | number | string[]"},"columnId":{"type":"string","minLength":1,"description":"On a matrix row condition, the id of the column. Read before `value` and wins when the two disagree, so the condition survives reordering. Must be a column of the matrix. Optional: when only `value` is sent, the id is filled in from the position on write.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.10.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnId","typeLabel":"string"},"columnIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.10.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition with `isAnyOf`, the ids of the columns `value` lists. Read before `value`, like `columnId`.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.10.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.10.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0","typeLabel":"object"},{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.10.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.10.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.10.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.10.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.10.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1","typeLabel":"object"}],"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.10.showIf.conditions.items.[INDEX].oneOf.0.rightOperand","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.10.showIf.conditions.items.[INDEX].oneOf.0","typeLabel":"object"},{}],"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.10.showIf.conditions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.10.showIf.conditions","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.10.showIf","typeLabel":"object"},"code":{"type":"string","maxLength":30,"pattern":"^[a-z][a-z0-9_]*$","description":"Question code, the name the question carries in exports, webhooks and links. Optional. Starts with a lowercase letter, then lowercase letters, digits and `_`; no `__`, no trailing `_`, at most 30 characters. It must not be an SPSS reserved word (`all`, `and`, `by`, `eq`, `ge`, `gt`, `le`, `lt`, `ne`, `not`, `or`, `to`, `with`) or an export column name (`response_id`, `language`, `outcome`, ...), and must be unique among the survey's question codes, Embedded Data names and the Question IDs of other questions, ignoring case. CTA elements have no code.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.10.code","typeLabel":"string"},"calHost":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.10.calHost","typeLabel":"string"}},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.10","typeLabel":"object"},{"type":"object","description":"Survey element/question inside a block. Element ids are stable public identifiers used by\nlogic, recall strings, response data, quotas, integrations, and analysis. `type` selects the\nallowed shape; unsupported fields are rejected instead of ignored.\n","required":["rows","columns","id","type","headline","required"],"properties":{"id":{"type":"string","pattern":"^[a-zA-Z0-9_-]+$","description":"Stable element id. Avoid spaces and reserved ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.id","typeLabel":"string"},"type":{"type":"string","enum":["matrix"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.type","typeLabel":"enum\u003cstring>"},"headline":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.headline.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.headline","typeLabel":"object"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.required","typeLabel":"boolean"},"rows":{"type":"array","items":{"type":"object","required":["id","label"],"properties":{"id":{"type":"string","description":"Stable choice id.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.rows.items.[INDEX].id","typeLabel":"string"},"label":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.rows.items.[INDEX].label.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.rows.items.[INDEX].label","typeLabel":"object"},"code":{"type":"string","maxLength":20,"pattern":"^[a-z0-9][a-z0-9_]*$","description":"Answer code of an option, a matrix row or a matrix column. Optional. Lowercase letters, digits and `_`; it may start with a digit, but not with `_`; no `__`, no trailing `_`, at most 20 characters. It must not be an SPSS reserved word or an export column name, and must be unique within its question (a matrix's rows and columns are checked separately), ignoring case.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.rows.items.[INDEX].code","typeLabel":"string"},"showIf":{"type":"object","description":"Option show-if: the option (or matrix row or column) is offered only when this condition group matches, re-evaluated live as earlier answers change. It may use what its element's show-if may use: answers from earlier blocks and from elements above its element in the same block, never its own element or anything below (`misordered_reference` at the exact condition path). A question left with no option to offer is skipped and recorded as not shown. Omit it, or send an empty group, for an option that is always offered. Allowed on published surveys.","required":["id","connector","conditions"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf.id","typeLabel":"string\u003ccuid2>"},"connector":{"type":"string","enum":["and","or"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf.connector","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","items":{"oneOf":[{"type":"object","description":"Single condition. Operators such as `isSubmitted`, `isSkipped`, `isClicked`, `isAccepted`,\n`isBooked`, `isSet`, and `isEmpty` do not use `rightOperand`; comparison operators do.\n","required":["id","leftOperand","operator"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.id","typeLabel":"string\u003ccuid2>"},"leftOperand":{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand","typeLabel":"object"},"operator":{"type":"string","enum":["equals","doesNotEqual","contains","doesNotContain","startsWith","doesNotStartWith","endsWith","doesNotEndWith","isSubmitted","isSkipped","isGreaterThan","isLessThan","isGreaterThanOrEqual","isLessThanOrEqual","equalsOneOf","includesAllOf","includesOneOf","doesNotIncludeOneOf","doesNotIncludeAllOf","isClicked","isNotClicked","isAccepted","isBefore","isAfter","isBooked","isPartiallySubmitted","isCompletelySubmitted","isSet","isNotSet","isEmpty","isNotEmpty","isAnyOf"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"rightOperand":{"oneOf":[{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.1","typeLabel":"number"},{"type":"array","items":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value","typeLabel":"string | number | string[]"},"columnId":{"type":"string","minLength":1,"description":"On a matrix row condition, the id of the column. Read before `value` and wins when the two disagree, so the condition survives reordering. Must be a column of the matrix. Optional: when only `value` is sent, the id is filled in from the position on write.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnId","typeLabel":"string"},"columnIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition with `isAnyOf`, the ids of the columns `value` lists. Read before `value`, like `columnId`.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0","typeLabel":"object"},{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1","typeLabel":"object"}],"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0","typeLabel":"object"},{}],"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf.conditions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf.conditions","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf","typeLabel":"object"},"hidden":{"type":"boolean","description":"Hidden: the option is never offered, whatever its `showIf` says, and is recorded as not shown. Use it to retire an option on a published survey instead of deleting it (deleting an option that existed at launch is refused): it keeps its id, answer code and earlier answers, and stays in results labelled Hidden.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.rows.items.[INDEX].hidden","typeLabel":"boolean"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.rows.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.rows","typeLabel":"object[]"},"columns":{"type":"array","items":{"type":"object","required":["id","label"],"properties":{"id":{"type":"string","description":"Stable choice id.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.columns.items.[INDEX].id","typeLabel":"string"},"label":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.columns.items.[INDEX].label.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.columns.items.[INDEX].label","typeLabel":"object"},"code":{"type":"string","maxLength":20,"pattern":"^[a-z0-9][a-z0-9_]*$","description":"Answer code of an option, a matrix row or a matrix column. Optional. Lowercase letters, digits and `_`; it may start with a digit, but not with `_`; no `__`, no trailing `_`, at most 20 characters. It must not be an SPSS reserved word or an export column name, and must be unique within its question (a matrix's rows and columns are checked separately), ignoring case.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.columns.items.[INDEX].code","typeLabel":"string"},"showIf":{"type":"object","description":"Option show-if: the option (or matrix row or column) is offered only when this condition group matches, re-evaluated live as earlier answers change. It may use what its element's show-if may use: answers from earlier blocks and from elements above its element in the same block, never its own element or anything below (`misordered_reference` at the exact condition path). A question left with no option to offer is skipped and recorded as not shown. Omit it, or send an empty group, for an option that is always offered. Allowed on published surveys.","required":["id","connector","conditions"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf.id","typeLabel":"string\u003ccuid2>"},"connector":{"type":"string","enum":["and","or"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf.connector","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","items":{"oneOf":[{"type":"object","description":"Single condition. Operators such as `isSubmitted`, `isSkipped`, `isClicked`, `isAccepted`,\n`isBooked`, `isSet`, and `isEmpty` do not use `rightOperand`; comparison operators do.\n","required":["id","leftOperand","operator"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.id","typeLabel":"string\u003ccuid2>"},"leftOperand":{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand","typeLabel":"object"},"operator":{"type":"string","enum":["equals","doesNotEqual","contains","doesNotContain","startsWith","doesNotStartWith","endsWith","doesNotEndWith","isSubmitted","isSkipped","isGreaterThan","isLessThan","isGreaterThanOrEqual","isLessThanOrEqual","equalsOneOf","includesAllOf","includesOneOf","doesNotIncludeOneOf","doesNotIncludeAllOf","isClicked","isNotClicked","isAccepted","isBefore","isAfter","isBooked","isPartiallySubmitted","isCompletelySubmitted","isSet","isNotSet","isEmpty","isNotEmpty","isAnyOf"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"rightOperand":{"oneOf":[{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.1","typeLabel":"number"},{"type":"array","items":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value","typeLabel":"string | number | string[]"},"columnId":{"type":"string","minLength":1,"description":"On a matrix row condition, the id of the column. Read before `value` and wins when the two disagree, so the condition survives reordering. Must be a column of the matrix. Optional: when only `value` is sent, the id is filled in from the position on write.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnId","typeLabel":"string"},"columnIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition with `isAnyOf`, the ids of the columns `value` lists. Read before `value`, like `columnId`.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0","typeLabel":"object"},{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1","typeLabel":"object"}],"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0","typeLabel":"object"},{}],"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf.conditions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf.conditions","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf","typeLabel":"object"},"hidden":{"type":"boolean","description":"Hidden: the option is never offered, whatever its `showIf` says, and is recorded as not shown. Use it to retire an option on a published survey instead of deleting it (deleting an option that existed at launch is refused): it keeps its id, answer code and earlier answers, and stays in results labelled Hidden.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.columns.items.[INDEX].hidden","typeLabel":"boolean"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.columns.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.columns","typeLabel":"object[]"},"subheader":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.subheader.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.subheader","typeLabel":"object"},"imageUrl":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.imageUrl","typeLabel":"string"},"imageAltText":{"type":"object","description":"Text alternative for `imageUrl`, read by screen readers. Omit or leave empty for a decorative image (rendered as `alt=\"\"`).","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.imageAltText.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.imageAltText","typeLabel":"object"},"videoUrl":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.videoUrl","typeLabel":"string"},"isDraft":{"type":"boolean","description":"Draft marker used by the editor and future update rules.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.isDraft","typeLabel":"boolean"},"showIf":{"type":"object","description":"Show-if: the element is shown only when this condition group matches, re-evaluated live as answers above it on the same page change. A hidden element is not validated (a hidden required element never blocks submission) and its answer is not submitted. Conditions use the same operands and operators as block `logic`. Reference rule: an element's show-if may use answers from earlier blocks and from elements above it in the same block, never itself or anything below it; a violation fails with `misordered_reference` at the exact condition path. Omit it, or send an empty group, for an element that is always shown.","required":["id","connector","conditions"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.showIf.id","typeLabel":"string\u003ccuid2>"},"connector":{"type":"string","enum":["and","or"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.showIf.connector","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","items":{"oneOf":[{"type":"object","description":"Single condition. Operators such as `isSubmitted`, `isSkipped`, `isClicked`, `isAccepted`,\n`isBooked`, `isSet`, and `isEmpty` do not use `rightOperand`; comparison operators do.\n","required":["id","leftOperand","operator"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.showIf.conditions.items.[INDEX].oneOf.0.id","typeLabel":"string\u003ccuid2>"},"leftOperand":{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.showIf.conditions.items.[INDEX].oneOf.0.leftOperand","typeLabel":"object"},"operator":{"type":"string","enum":["equals","doesNotEqual","contains","doesNotContain","startsWith","doesNotStartWith","endsWith","doesNotEndWith","isSubmitted","isSkipped","isGreaterThan","isLessThan","isGreaterThanOrEqual","isLessThanOrEqual","equalsOneOf","includesAllOf","includesOneOf","doesNotIncludeOneOf","doesNotIncludeAllOf","isClicked","isNotClicked","isAccepted","isBefore","isAfter","isBooked","isPartiallySubmitted","isCompletelySubmitted","isSet","isNotSet","isEmpty","isNotEmpty","isAnyOf"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.showIf.conditions.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"rightOperand":{"oneOf":[{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.1","typeLabel":"number"},{"type":"array","items":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value","typeLabel":"string | number | string[]"},"columnId":{"type":"string","minLength":1,"description":"On a matrix row condition, the id of the column. Read before `value` and wins when the two disagree, so the condition survives reordering. Must be a column of the matrix. Optional: when only `value` is sent, the id is filled in from the position on write.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnId","typeLabel":"string"},"columnIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition with `isAnyOf`, the ids of the columns `value` lists. Read before `value`, like `columnId`.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0","typeLabel":"object"},{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1","typeLabel":"object"}],"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.showIf.conditions.items.[INDEX].oneOf.0.rightOperand","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.showIf.conditions.items.[INDEX].oneOf.0","typeLabel":"object"},{}],"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.showIf.conditions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.showIf.conditions","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.showIf","typeLabel":"object"},"code":{"type":"string","maxLength":30,"pattern":"^[a-z][a-z0-9_]*$","description":"Question code, the name the question carries in exports, webhooks and links. Optional. Starts with a lowercase letter, then lowercase letters, digits and `_`; no `__`, no trailing `_`, at most 30 characters. It must not be an SPSS reserved word (`all`, `and`, `by`, `eq`, `ge`, `gt`, `le`, `lt`, `ne`, `not`, `or`, `to`, `with`) or an export column name (`response_id`, `language`, `outcome`, ...), and must be unique among the survey's question codes, Embedded Data names and the Question IDs of other questions, ignoring case. CTA elements have no code.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.code","typeLabel":"string"},"shuffleOption":{"type":"string","enum":["none","all","exceptLast","reverseOrderOccasionally","reverseOrderExceptLast"],"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.shuffleOption","typeLabel":"enum\u003cstring>"},"validation":{"type":"object","description":"Optional element-level validation rules.","required":["rules"],"properties":{"rules":{"type":"array","items":{"type":"object","required":["id","type","params"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.validation.rules.items.[INDEX].id","typeLabel":"string"},"type":{"type":"string","enum":["minLength","maxLength","pattern","email","url","phone","equals","doesNotEqual","contains","doesNotContain","minValue","maxValue","isGreaterThan","isLessThan","minSelections","maxSelections","minRanked","rankAll","minRowsAnswered","answerAllRows","isLaterThan","isEarlierThan","isBetween","isNotBetween","fileExtensionIs","fileExtensionIsNot"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.validation.rules.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"params":{"type":"object","additionalProperties":true,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.validation.rules.items.[INDEX].params","typeLabel":"object"},"field":{"type":"string","enum":["addressLine1","addressLine2","city","state","zip","country","firstName","lastName","email","phone","company"],"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.validation.rules.items.[INDEX].field","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.validation.rules.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.validation.rules","typeLabel":"object[]"},"logic":{"type":"string","enum":["and","or"],"default":"and","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.validation.logic","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11.validation","typeLabel":"object"}},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.11","typeLabel":"object"},{"type":"object","description":"Survey element/question inside a block. Element ids are stable public identifiers used by\nlogic, recall strings, response data, quotas, integrations, and analysis. `type` selects the\nallowed shape; unsupported fields are rejected instead of ignored.\n","required":["addressLine1","addressLine2","city","state","zip","country","id","type","headline","required"],"properties":{"id":{"type":"string","pattern":"^[a-zA-Z0-9_-]+$","description":"Stable element id. Avoid spaces and reserved ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.12.id","typeLabel":"string"},"type":{"type":"string","enum":["address"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.12.type","typeLabel":"enum\u003cstring>"},"headline":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.12.headline.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.12.headline","typeLabel":"object"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.12.required","typeLabel":"boolean"},"addressLine1":{"type":"object","description":"Field config for address and contact info elements.","required":["show","required","placeholder"],"properties":{"show":{"type":"boolean","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.12.addressLine1.show","typeLabel":"boolean"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.12.addressLine1.required","typeLabel":"boolean"},"placeholder":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.12.addressLine1.placeholder.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.12.addressLine1.placeholder","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.12.addressLine1","typeLabel":"object"},"addressLine2":{"type":"object","description":"Field config for address and contact info elements.","required":["show","required","placeholder"],"properties":{"show":{"type":"boolean","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.12.addressLine2.show","typeLabel":"boolean"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.12.addressLine2.required","typeLabel":"boolean"},"placeholder":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.12.addressLine2.placeholder.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.12.addressLine2.placeholder","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.12.addressLine2","typeLabel":"object"},"city":{"type":"object","description":"Field config for address and contact info elements.","required":["show","required","placeholder"],"properties":{"show":{"type":"boolean","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.12.city.show","typeLabel":"boolean"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.12.city.required","typeLabel":"boolean"},"placeholder":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.12.city.placeholder.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.12.city.placeholder","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.12.city","typeLabel":"object"},"state":{"type":"object","description":"Field config for address and contact info elements.","required":["show","required","placeholder"],"properties":{"show":{"type":"boolean","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.12.state.show","typeLabel":"boolean"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.12.state.required","typeLabel":"boolean"},"placeholder":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.12.state.placeholder.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.12.state.placeholder","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.12.state","typeLabel":"object"},"zip":{"type":"object","description":"Field config for address and contact info elements.","required":["show","required","placeholder"],"properties":{"show":{"type":"boolean","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.12.zip.show","typeLabel":"boolean"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.12.zip.required","typeLabel":"boolean"},"placeholder":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.12.zip.placeholder.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.12.zip.placeholder","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.12.zip","typeLabel":"object"},"country":{"type":"object","description":"Field config for address and contact info elements.","required":["show","required","placeholder"],"properties":{"show":{"type":"boolean","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.12.country.show","typeLabel":"boolean"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.12.country.required","typeLabel":"boolean"},"placeholder":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.12.country.placeholder.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.12.country.placeholder","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.12.country","typeLabel":"object"},"subheader":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.12.subheader.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.12.subheader","typeLabel":"object"},"imageUrl":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.12.imageUrl","typeLabel":"string"},"imageAltText":{"type":"object","description":"Text alternative for `imageUrl`, read by screen readers. Omit or leave empty for a decorative image (rendered as `alt=\"\"`).","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.12.imageAltText.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.12.imageAltText","typeLabel":"object"},"videoUrl":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.12.videoUrl","typeLabel":"string"},"isDraft":{"type":"boolean","description":"Draft marker used by the editor and future update rules.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.12.isDraft","typeLabel":"boolean"},"showIf":{"type":"object","description":"Show-if: the element is shown only when this condition group matches, re-evaluated live as answers above it on the same page change. A hidden element is not validated (a hidden required element never blocks submission) and its answer is not submitted. Conditions use the same operands and operators as block `logic`. Reference rule: an element's show-if may use answers from earlier blocks and from elements above it in the same block, never itself or anything below it; a violation fails with `misordered_reference` at the exact condition path. Omit it, or send an empty group, for an element that is always shown.","required":["id","connector","conditions"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.12.showIf.id","typeLabel":"string\u003ccuid2>"},"connector":{"type":"string","enum":["and","or"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.12.showIf.connector","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","items":{"oneOf":[{"type":"object","description":"Single condition. Operators such as `isSubmitted`, `isSkipped`, `isClicked`, `isAccepted`,\n`isBooked`, `isSet`, and `isEmpty` do not use `rightOperand`; comparison operators do.\n","required":["id","leftOperand","operator"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.12.showIf.conditions.items.[INDEX].oneOf.0.id","typeLabel":"string\u003ccuid2>"},"leftOperand":{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.12.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.12.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.12.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.12.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.12.showIf.conditions.items.[INDEX].oneOf.0.leftOperand","typeLabel":"object"},"operator":{"type":"string","enum":["equals","doesNotEqual","contains","doesNotContain","startsWith","doesNotStartWith","endsWith","doesNotEndWith","isSubmitted","isSkipped","isGreaterThan","isLessThan","isGreaterThanOrEqual","isLessThanOrEqual","equalsOneOf","includesAllOf","includesOneOf","doesNotIncludeOneOf","doesNotIncludeAllOf","isClicked","isNotClicked","isAccepted","isBefore","isAfter","isBooked","isPartiallySubmitted","isCompletelySubmitted","isSet","isNotSet","isEmpty","isNotEmpty","isAnyOf"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.12.showIf.conditions.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"rightOperand":{"oneOf":[{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.12.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.12.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.12.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.1","typeLabel":"number"},{"type":"array","items":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.12.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.12.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.12.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value","typeLabel":"string | number | string[]"},"columnId":{"type":"string","minLength":1,"description":"On a matrix row condition, the id of the column. Read before `value` and wins when the two disagree, so the condition survives reordering. Must be a column of the matrix. Optional: when only `value` is sent, the id is filled in from the position on write.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.12.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnId","typeLabel":"string"},"columnIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.12.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition with `isAnyOf`, the ids of the columns `value` lists. Read before `value`, like `columnId`.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.12.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.12.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0","typeLabel":"object"},{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.12.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.12.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.12.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.12.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.12.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1","typeLabel":"object"}],"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.12.showIf.conditions.items.[INDEX].oneOf.0.rightOperand","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.12.showIf.conditions.items.[INDEX].oneOf.0","typeLabel":"object"},{}],"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.12.showIf.conditions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.12.showIf.conditions","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.12.showIf","typeLabel":"object"},"code":{"type":"string","maxLength":30,"pattern":"^[a-z][a-z0-9_]*$","description":"Question code, the name the question carries in exports, webhooks and links. Optional. Starts with a lowercase letter, then lowercase letters, digits and `_`; no `__`, no trailing `_`, at most 30 characters. It must not be an SPSS reserved word (`all`, `and`, `by`, `eq`, `ge`, `gt`, `le`, `lt`, `ne`, `not`, `or`, `to`, `with`) or an export column name (`response_id`, `language`, `outcome`, ...), and must be unique among the survey's question codes, Embedded Data names and the Question IDs of other questions, ignoring case. CTA elements have no code.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.12.code","typeLabel":"string"},"validation":{"type":"object","description":"Optional element-level validation rules.","required":["rules"],"properties":{"rules":{"type":"array","items":{"type":"object","required":["id","type","params"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.12.validation.rules.items.[INDEX].id","typeLabel":"string"},"type":{"type":"string","enum":["minLength","maxLength","pattern","email","url","phone","equals","doesNotEqual","contains","doesNotContain","minValue","maxValue","isGreaterThan","isLessThan","minSelections","maxSelections","minRanked","rankAll","minRowsAnswered","answerAllRows","isLaterThan","isEarlierThan","isBetween","isNotBetween","fileExtensionIs","fileExtensionIsNot"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.12.validation.rules.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"params":{"type":"object","additionalProperties":true,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.12.validation.rules.items.[INDEX].params","typeLabel":"object"},"field":{"type":"string","enum":["addressLine1","addressLine2","city","state","zip","country","firstName","lastName","email","phone","company"],"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.12.validation.rules.items.[INDEX].field","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.12.validation.rules.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.12.validation.rules","typeLabel":"object[]"},"logic":{"type":"string","enum":["and","or"],"default":"and","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.12.validation.logic","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.12.validation","typeLabel":"object"}},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.12","typeLabel":"object"},{"type":"object","description":"Survey element/question inside a block. Element ids are stable public identifiers used by\nlogic, recall strings, response data, quotas, integrations, and analysis. `type` selects the\nallowed shape; unsupported fields are rejected instead of ignored.\n","required":["choices","id","type","headline","required"],"properties":{"id":{"type":"string","pattern":"^[a-zA-Z0-9_-]+$","description":"Stable element id. Avoid spaces and reserved ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.id","typeLabel":"string"},"type":{"type":"string","enum":["ranking"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.type","typeLabel":"enum\u003cstring>"},"headline":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.headline.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.headline","typeLabel":"object"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.required","typeLabel":"boolean"},"choices":{"type":"array","minItems":2,"maxItems":25,"items":{"type":"object","required":["id","label"],"properties":{"id":{"type":"string","description":"Stable choice id.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.choices.items.[INDEX].id","typeLabel":"string"},"label":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.choices.items.[INDEX].label.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.choices.items.[INDEX].label","typeLabel":"object"},"code":{"type":"string","maxLength":20,"pattern":"^[a-z0-9][a-z0-9_]*$","description":"Answer code of an option, a matrix row or a matrix column. Optional. Lowercase letters, digits and `_`; it may start with a digit, but not with `_`; no `__`, no trailing `_`, at most 20 characters. It must not be an SPSS reserved word or an export column name, and must be unique within its question (a matrix's rows and columns are checked separately), ignoring case.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.choices.items.[INDEX].code","typeLabel":"string"},"showIf":{"type":"object","description":"Option show-if: the option (or matrix row or column) is offered only when this condition group matches, re-evaluated live as earlier answers change. It may use what its element's show-if may use: answers from earlier blocks and from elements above its element in the same block, never its own element or anything below (`misordered_reference` at the exact condition path). A question left with no option to offer is skipped and recorded as not shown. Omit it, or send an empty group, for an option that is always offered. Allowed on published surveys.","required":["id","connector","conditions"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf.id","typeLabel":"string\u003ccuid2>"},"connector":{"type":"string","enum":["and","or"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf.connector","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","items":{"oneOf":[{"type":"object","description":"Single condition. Operators such as `isSubmitted`, `isSkipped`, `isClicked`, `isAccepted`,\n`isBooked`, `isSet`, and `isEmpty` do not use `rightOperand`; comparison operators do.\n","required":["id","leftOperand","operator"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.id","typeLabel":"string\u003ccuid2>"},"leftOperand":{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand","typeLabel":"object"},"operator":{"type":"string","enum":["equals","doesNotEqual","contains","doesNotContain","startsWith","doesNotStartWith","endsWith","doesNotEndWith","isSubmitted","isSkipped","isGreaterThan","isLessThan","isGreaterThanOrEqual","isLessThanOrEqual","equalsOneOf","includesAllOf","includesOneOf","doesNotIncludeOneOf","doesNotIncludeAllOf","isClicked","isNotClicked","isAccepted","isBefore","isAfter","isBooked","isPartiallySubmitted","isCompletelySubmitted","isSet","isNotSet","isEmpty","isNotEmpty","isAnyOf"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"rightOperand":{"oneOf":[{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.1","typeLabel":"number"},{"type":"array","items":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value","typeLabel":"string | number | string[]"},"columnId":{"type":"string","minLength":1,"description":"On a matrix row condition, the id of the column. Read before `value` and wins when the two disagree, so the condition survives reordering. Must be a column of the matrix. Optional: when only `value` is sent, the id is filled in from the position on write.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnId","typeLabel":"string"},"columnIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition with `isAnyOf`, the ids of the columns `value` lists. Read before `value`, like `columnId`.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0","typeLabel":"object"},{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1","typeLabel":"object"}],"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0","typeLabel":"object"},{}],"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf.conditions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf.conditions","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf","typeLabel":"object"},"hidden":{"type":"boolean","description":"Hidden: the option is never offered, whatever its `showIf` says, and is recorded as not shown. Use it to retire an option on a published survey instead of deleting it (deleting an option that existed at launch is refused): it keeps its id, answer code and earlier answers, and stays in results labelled Hidden.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.choices.items.[INDEX].hidden","typeLabel":"boolean"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.choices.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.choices","typeLabel":"object[]"},"subheader":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.subheader.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.subheader","typeLabel":"object"},"imageUrl":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.imageUrl","typeLabel":"string"},"imageAltText":{"type":"object","description":"Text alternative for `imageUrl`, read by screen readers. Omit or leave empty for a decorative image (rendered as `alt=\"\"`).","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.imageAltText.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.imageAltText","typeLabel":"object"},"videoUrl":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.videoUrl","typeLabel":"string"},"isDraft":{"type":"boolean","description":"Draft marker used by the editor and future update rules.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.isDraft","typeLabel":"boolean"},"showIf":{"type":"object","description":"Show-if: the element is shown only when this condition group matches, re-evaluated live as answers above it on the same page change. A hidden element is not validated (a hidden required element never blocks submission) and its answer is not submitted. Conditions use the same operands and operators as block `logic`. Reference rule: an element's show-if may use answers from earlier blocks and from elements above it in the same block, never itself or anything below it; a violation fails with `misordered_reference` at the exact condition path. Omit it, or send an empty group, for an element that is always shown.","required":["id","connector","conditions"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.showIf.id","typeLabel":"string\u003ccuid2>"},"connector":{"type":"string","enum":["and","or"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.showIf.connector","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","items":{"oneOf":[{"type":"object","description":"Single condition. Operators such as `isSubmitted`, `isSkipped`, `isClicked`, `isAccepted`,\n`isBooked`, `isSet`, and `isEmpty` do not use `rightOperand`; comparison operators do.\n","required":["id","leftOperand","operator"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.showIf.conditions.items.[INDEX].oneOf.0.id","typeLabel":"string\u003ccuid2>"},"leftOperand":{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.showIf.conditions.items.[INDEX].oneOf.0.leftOperand","typeLabel":"object"},"operator":{"type":"string","enum":["equals","doesNotEqual","contains","doesNotContain","startsWith","doesNotStartWith","endsWith","doesNotEndWith","isSubmitted","isSkipped","isGreaterThan","isLessThan","isGreaterThanOrEqual","isLessThanOrEqual","equalsOneOf","includesAllOf","includesOneOf","doesNotIncludeOneOf","doesNotIncludeAllOf","isClicked","isNotClicked","isAccepted","isBefore","isAfter","isBooked","isPartiallySubmitted","isCompletelySubmitted","isSet","isNotSet","isEmpty","isNotEmpty","isAnyOf"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.showIf.conditions.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"rightOperand":{"oneOf":[{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.1","typeLabel":"number"},{"type":"array","items":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value","typeLabel":"string | number | string[]"},"columnId":{"type":"string","minLength":1,"description":"On a matrix row condition, the id of the column. Read before `value` and wins when the two disagree, so the condition survives reordering. Must be a column of the matrix. Optional: when only `value` is sent, the id is filled in from the position on write.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnId","typeLabel":"string"},"columnIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition with `isAnyOf`, the ids of the columns `value` lists. Read before `value`, like `columnId`.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0","typeLabel":"object"},{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1","typeLabel":"object"}],"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.showIf.conditions.items.[INDEX].oneOf.0.rightOperand","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.showIf.conditions.items.[INDEX].oneOf.0","typeLabel":"object"},{}],"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.showIf.conditions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.showIf.conditions","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.showIf","typeLabel":"object"},"code":{"type":"string","maxLength":30,"pattern":"^[a-z][a-z0-9_]*$","description":"Question code, the name the question carries in exports, webhooks and links. Optional. Starts with a lowercase letter, then lowercase letters, digits and `_`; no `__`, no trailing `_`, at most 30 characters. It must not be an SPSS reserved word (`all`, `and`, `by`, `eq`, `ge`, `gt`, `le`, `lt`, `ne`, `not`, `or`, `to`, `with`) or an export column name (`response_id`, `language`, `outcome`, ...), and must be unique among the survey's question codes, Embedded Data names and the Question IDs of other questions, ignoring case. CTA elements have no code.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.code","typeLabel":"string"},"optionsCopiedFrom":{"type":"string","minLength":1,"description":"Copied options: the id of an earlier element whose options this element copies (\"only the brands you know\"). Choices copy from a single select, multi select or ranking; pictures from a picture selection (matrix rows are not copied: give rows a `showIf` on the source instead). Write the copies yourself: each copied option keeps the source option's `id` and `code`, and carries a `showIf` \"picked in the source\" (`includesOneOf` with its own id, or `equals` when the source is a single select), so the element offers exactly the options picked there. Copied codes follow the source's: a code sent for a copy is replaced by the source option's. Fixed options next to the copies (such as \"None of these\", id `none`) get the next code free in every linked element. The source must exist (`dangling_reference`), sit in an earlier block or above this element on its block (`misordered_reference`), and have options of the same kind (`invalid_reference`). To bring in options the source gained later, add them the same way.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.optionsCopiedFrom","typeLabel":"string"},"otherOptionPlaceholder":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.otherOptionPlaceholder.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.otherOptionPlaceholder","typeLabel":"object"},"shuffleOption":{"type":"string","enum":["none","all","exceptLast","reverseOrderOccasionally","reverseOrderExceptLast"],"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.shuffleOption","typeLabel":"enum\u003cstring>"},"validation":{"type":"object","description":"Optional element-level validation rules.","required":["rules"],"properties":{"rules":{"type":"array","items":{"type":"object","required":["id","type","params"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.validation.rules.items.[INDEX].id","typeLabel":"string"},"type":{"type":"string","enum":["minLength","maxLength","pattern","email","url","phone","equals","doesNotEqual","contains","doesNotContain","minValue","maxValue","isGreaterThan","isLessThan","minSelections","maxSelections","minRanked","rankAll","minRowsAnswered","answerAllRows","isLaterThan","isEarlierThan","isBetween","isNotBetween","fileExtensionIs","fileExtensionIsNot"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.validation.rules.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"params":{"type":"object","additionalProperties":true,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.validation.rules.items.[INDEX].params","typeLabel":"object"},"field":{"type":"string","enum":["addressLine1","addressLine2","city","state","zip","country","firstName","lastName","email","phone","company"],"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.validation.rules.items.[INDEX].field","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.validation.rules.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.validation.rules","typeLabel":"object[]"},"logic":{"type":"string","enum":["and","or"],"default":"and","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.validation.logic","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13.validation","typeLabel":"object"}},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.13","typeLabel":"object"},{"type":"object","description":"Survey element/question inside a block. Element ids are stable public identifiers used by\nlogic, recall strings, response data, quotas, integrations, and analysis. `type` selects the\nallowed shape; unsupported fields are rejected instead of ignored.\n","required":["firstName","lastName","email","phone","company","id","type","headline","required"],"properties":{"id":{"type":"string","pattern":"^[a-zA-Z0-9_-]+$","description":"Stable element id. Avoid spaces and reserved ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.14.id","typeLabel":"string"},"type":{"type":"string","enum":["contactInfo"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.14.type","typeLabel":"enum\u003cstring>"},"headline":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.14.headline.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.14.headline","typeLabel":"object"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.14.required","typeLabel":"boolean"},"firstName":{"type":"object","description":"Field config for address and contact info elements.","required":["show","required","placeholder"],"properties":{"show":{"type":"boolean","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.14.firstName.show","typeLabel":"boolean"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.14.firstName.required","typeLabel":"boolean"},"placeholder":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.14.firstName.placeholder.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.14.firstName.placeholder","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.14.firstName","typeLabel":"object"},"lastName":{"type":"object","description":"Field config for address and contact info elements.","required":["show","required","placeholder"],"properties":{"show":{"type":"boolean","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.14.lastName.show","typeLabel":"boolean"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.14.lastName.required","typeLabel":"boolean"},"placeholder":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.14.lastName.placeholder.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.14.lastName.placeholder","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.14.lastName","typeLabel":"object"},"email":{"type":"object","description":"Field config for address and contact info elements.","required":["show","required","placeholder"],"properties":{"show":{"type":"boolean","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.14.email.show","typeLabel":"boolean"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.14.email.required","typeLabel":"boolean"},"placeholder":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.14.email.placeholder.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.14.email.placeholder","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.14.email","typeLabel":"object"},"phone":{"type":"object","description":"Field config for address and contact info elements.","required":["show","required","placeholder"],"properties":{"show":{"type":"boolean","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.14.phone.show","typeLabel":"boolean"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.14.phone.required","typeLabel":"boolean"},"placeholder":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.14.phone.placeholder.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.14.phone.placeholder","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.14.phone","typeLabel":"object"},"company":{"type":"object","description":"Field config for address and contact info elements.","required":["show","required","placeholder"],"properties":{"show":{"type":"boolean","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.14.company.show","typeLabel":"boolean"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.14.company.required","typeLabel":"boolean"},"placeholder":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.14.company.placeholder.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.14.company.placeholder","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.14.company","typeLabel":"object"},"subheader":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.14.subheader.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.14.subheader","typeLabel":"object"},"imageUrl":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.14.imageUrl","typeLabel":"string"},"imageAltText":{"type":"object","description":"Text alternative for `imageUrl`, read by screen readers. Omit or leave empty for a decorative image (rendered as `alt=\"\"`).","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.14.imageAltText.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.14.imageAltText","typeLabel":"object"},"videoUrl":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.14.videoUrl","typeLabel":"string"},"isDraft":{"type":"boolean","description":"Draft marker used by the editor and future update rules.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.14.isDraft","typeLabel":"boolean"},"showIf":{"type":"object","description":"Show-if: the element is shown only when this condition group matches, re-evaluated live as answers above it on the same page change. A hidden element is not validated (a hidden required element never blocks submission) and its answer is not submitted. Conditions use the same operands and operators as block `logic`. Reference rule: an element's show-if may use answers from earlier blocks and from elements above it in the same block, never itself or anything below it; a violation fails with `misordered_reference` at the exact condition path. Omit it, or send an empty group, for an element that is always shown.","required":["id","connector","conditions"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.14.showIf.id","typeLabel":"string\u003ccuid2>"},"connector":{"type":"string","enum":["and","or"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.14.showIf.connector","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","items":{"oneOf":[{"type":"object","description":"Single condition. Operators such as `isSubmitted`, `isSkipped`, `isClicked`, `isAccepted`,\n`isBooked`, `isSet`, and `isEmpty` do not use `rightOperand`; comparison operators do.\n","required":["id","leftOperand","operator"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.14.showIf.conditions.items.[INDEX].oneOf.0.id","typeLabel":"string\u003ccuid2>"},"leftOperand":{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.14.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.14.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.14.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.14.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.14.showIf.conditions.items.[INDEX].oneOf.0.leftOperand","typeLabel":"object"},"operator":{"type":"string","enum":["equals","doesNotEqual","contains","doesNotContain","startsWith","doesNotStartWith","endsWith","doesNotEndWith","isSubmitted","isSkipped","isGreaterThan","isLessThan","isGreaterThanOrEqual","isLessThanOrEqual","equalsOneOf","includesAllOf","includesOneOf","doesNotIncludeOneOf","doesNotIncludeAllOf","isClicked","isNotClicked","isAccepted","isBefore","isAfter","isBooked","isPartiallySubmitted","isCompletelySubmitted","isSet","isNotSet","isEmpty","isNotEmpty","isAnyOf"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.14.showIf.conditions.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"rightOperand":{"oneOf":[{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.14.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.14.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.14.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.1","typeLabel":"number"},{"type":"array","items":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.14.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.14.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.14.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value","typeLabel":"string | number | string[]"},"columnId":{"type":"string","minLength":1,"description":"On a matrix row condition, the id of the column. Read before `value` and wins when the two disagree, so the condition survives reordering. Must be a column of the matrix. Optional: when only `value` is sent, the id is filled in from the position on write.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.14.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnId","typeLabel":"string"},"columnIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.14.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition with `isAnyOf`, the ids of the columns `value` lists. Read before `value`, like `columnId`.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.14.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.14.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0","typeLabel":"object"},{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.14.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.14.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.14.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.14.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.14.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1","typeLabel":"object"}],"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.14.showIf.conditions.items.[INDEX].oneOf.0.rightOperand","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.14.showIf.conditions.items.[INDEX].oneOf.0","typeLabel":"object"},{}],"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.14.showIf.conditions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.14.showIf.conditions","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.14.showIf","typeLabel":"object"},"code":{"type":"string","maxLength":30,"pattern":"^[a-z][a-z0-9_]*$","description":"Question code, the name the question carries in exports, webhooks and links. Optional. Starts with a lowercase letter, then lowercase letters, digits and `_`; no `__`, no trailing `_`, at most 30 characters. It must not be an SPSS reserved word (`all`, `and`, `by`, `eq`, `ge`, `gt`, `le`, `lt`, `ne`, `not`, `or`, `to`, `with`) or an export column name (`response_id`, `language`, `outcome`, ...), and must be unique among the survey's question codes, Embedded Data names and the Question IDs of other questions, ignoring case. CTA elements have no code.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.14.code","typeLabel":"string"},"validation":{"type":"object","description":"Optional element-level validation rules.","required":["rules"],"properties":{"rules":{"type":"array","items":{"type":"object","required":["id","type","params"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.14.validation.rules.items.[INDEX].id","typeLabel":"string"},"type":{"type":"string","enum":["minLength","maxLength","pattern","email","url","phone","equals","doesNotEqual","contains","doesNotContain","minValue","maxValue","isGreaterThan","isLessThan","minSelections","maxSelections","minRanked","rankAll","minRowsAnswered","answerAllRows","isLaterThan","isEarlierThan","isBetween","isNotBetween","fileExtensionIs","fileExtensionIsNot"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.14.validation.rules.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"params":{"type":"object","additionalProperties":true,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.14.validation.rules.items.[INDEX].params","typeLabel":"object"},"field":{"type":"string","enum":["addressLine1","addressLine2","city","state","zip","country","firstName","lastName","email","phone","company"],"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.14.validation.rules.items.[INDEX].field","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.14.validation.rules.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.14.validation.rules","typeLabel":"object[]"},"logic":{"type":"string","enum":["and","or"],"default":"and","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.14.validation.logic","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.14.validation","typeLabel":"object"}},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.14","typeLabel":"object"},{"type":"object","description":"Survey element/question inside a block. Element ids are stable public identifiers used by\nlogic, recall strings, response data, quotas, integrations, and analysis. `type` selects the\nallowed shape; unsupported fields are rejected instead of ignored.\n","required":["scale","range","id","type","headline","required"],"properties":{"id":{"type":"string","pattern":"^[a-zA-Z0-9_-]+$","description":"Stable element id. Avoid spaces and reserved ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.15.id","typeLabel":"string"},"type":{"type":"string","enum":["csat"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.15.type","typeLabel":"enum\u003cstring>"},"headline":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.15.headline.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.15.headline","typeLabel":"object"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.15.required","typeLabel":"boolean"},"scale":{"type":"string","enum":["number","smiley","star"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.15.scale","typeLabel":"enum\u003cstring>"},"range":{"type":"integer","enum":[5],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.15.range","typeLabel":"enum\u003cinteger>"},"subheader":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.15.subheader.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.15.subheader","typeLabel":"object"},"imageUrl":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.15.imageUrl","typeLabel":"string"},"imageAltText":{"type":"object","description":"Text alternative for `imageUrl`, read by screen readers. Omit or leave empty for a decorative image (rendered as `alt=\"\"`).","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.15.imageAltText.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.15.imageAltText","typeLabel":"object"},"videoUrl":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.15.videoUrl","typeLabel":"string"},"isDraft":{"type":"boolean","description":"Draft marker used by the editor and future update rules.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.15.isDraft","typeLabel":"boolean"},"showIf":{"type":"object","description":"Show-if: the element is shown only when this condition group matches, re-evaluated live as answers above it on the same page change. A hidden element is not validated (a hidden required element never blocks submission) and its answer is not submitted. Conditions use the same operands and operators as block `logic`. Reference rule: an element's show-if may use answers from earlier blocks and from elements above it in the same block, never itself or anything below it; a violation fails with `misordered_reference` at the exact condition path. Omit it, or send an empty group, for an element that is always shown.","required":["id","connector","conditions"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.15.showIf.id","typeLabel":"string\u003ccuid2>"},"connector":{"type":"string","enum":["and","or"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.15.showIf.connector","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","items":{"oneOf":[{"type":"object","description":"Single condition. Operators such as `isSubmitted`, `isSkipped`, `isClicked`, `isAccepted`,\n`isBooked`, `isSet`, and `isEmpty` do not use `rightOperand`; comparison operators do.\n","required":["id","leftOperand","operator"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.15.showIf.conditions.items.[INDEX].oneOf.0.id","typeLabel":"string\u003ccuid2>"},"leftOperand":{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.15.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.15.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.15.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.15.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.15.showIf.conditions.items.[INDEX].oneOf.0.leftOperand","typeLabel":"object"},"operator":{"type":"string","enum":["equals","doesNotEqual","contains","doesNotContain","startsWith","doesNotStartWith","endsWith","doesNotEndWith","isSubmitted","isSkipped","isGreaterThan","isLessThan","isGreaterThanOrEqual","isLessThanOrEqual","equalsOneOf","includesAllOf","includesOneOf","doesNotIncludeOneOf","doesNotIncludeAllOf","isClicked","isNotClicked","isAccepted","isBefore","isAfter","isBooked","isPartiallySubmitted","isCompletelySubmitted","isSet","isNotSet","isEmpty","isNotEmpty","isAnyOf"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.15.showIf.conditions.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"rightOperand":{"oneOf":[{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.15.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.15.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.15.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.1","typeLabel":"number"},{"type":"array","items":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.15.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.15.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.15.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value","typeLabel":"string | number | string[]"},"columnId":{"type":"string","minLength":1,"description":"On a matrix row condition, the id of the column. Read before `value` and wins when the two disagree, so the condition survives reordering. Must be a column of the matrix. Optional: when only `value` is sent, the id is filled in from the position on write.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.15.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnId","typeLabel":"string"},"columnIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.15.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition with `isAnyOf`, the ids of the columns `value` lists. Read before `value`, like `columnId`.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.15.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.15.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0","typeLabel":"object"},{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.15.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.15.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.15.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.15.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.15.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1","typeLabel":"object"}],"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.15.showIf.conditions.items.[INDEX].oneOf.0.rightOperand","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.15.showIf.conditions.items.[INDEX].oneOf.0","typeLabel":"object"},{}],"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.15.showIf.conditions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.15.showIf.conditions","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.15.showIf","typeLabel":"object"},"code":{"type":"string","maxLength":30,"pattern":"^[a-z][a-z0-9_]*$","description":"Question code, the name the question carries in exports, webhooks and links. Optional. Starts with a lowercase letter, then lowercase letters, digits and `_`; no `__`, no trailing `_`, at most 30 characters. It must not be an SPSS reserved word (`all`, `and`, `by`, `eq`, `ge`, `gt`, `le`, `lt`, `ne`, `not`, `or`, `to`, `with`) or an export column name (`response_id`, `language`, `outcome`, ...), and must be unique among the survey's question codes, Embedded Data names and the Question IDs of other questions, ignoring case. CTA elements have no code.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.15.code","typeLabel":"string"},"lowerLabel":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.15.lowerLabel.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.15.lowerLabel","typeLabel":"object"},"upperLabel":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.15.upperLabel.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.15.upperLabel","typeLabel":"object"},"isColorCodingEnabled":{"type":"boolean","default":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.15.isColorCodingEnabled","typeLabel":"boolean"}},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.15","typeLabel":"object"},{"type":"object","description":"Survey element/question inside a block. Element ids are stable public identifiers used by\nlogic, recall strings, response data, quotas, integrations, and analysis. `type` selects the\nallowed shape; unsupported fields are rejected instead of ignored.\n","required":["scale","range","id","type","headline","required"],"properties":{"id":{"type":"string","pattern":"^[a-zA-Z0-9_-]+$","description":"Stable element id. Avoid spaces and reserved ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.16.id","typeLabel":"string"},"type":{"type":"string","enum":["ces"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.16.type","typeLabel":"enum\u003cstring>"},"headline":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.16.headline.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.16.headline","typeLabel":"object"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.16.required","typeLabel":"boolean"},"scale":{"type":"string","enum":["number","smiley","star"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.16.scale","typeLabel":"enum\u003cstring>"},"range":{"type":"integer","enum":[5,7],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.16.range","typeLabel":"enum\u003cinteger>"},"subheader":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.16.subheader.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.16.subheader","typeLabel":"object"},"imageUrl":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.16.imageUrl","typeLabel":"string"},"imageAltText":{"type":"object","description":"Text alternative for `imageUrl`, read by screen readers. Omit or leave empty for a decorative image (rendered as `alt=\"\"`).","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.16.imageAltText.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.16.imageAltText","typeLabel":"object"},"videoUrl":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.16.videoUrl","typeLabel":"string"},"isDraft":{"type":"boolean","description":"Draft marker used by the editor and future update rules.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.16.isDraft","typeLabel":"boolean"},"showIf":{"type":"object","description":"Show-if: the element is shown only when this condition group matches, re-evaluated live as answers above it on the same page change. A hidden element is not validated (a hidden required element never blocks submission) and its answer is not submitted. Conditions use the same operands and operators as block `logic`. Reference rule: an element's show-if may use answers from earlier blocks and from elements above it in the same block, never itself or anything below it; a violation fails with `misordered_reference` at the exact condition path. Omit it, or send an empty group, for an element that is always shown.","required":["id","connector","conditions"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.16.showIf.id","typeLabel":"string\u003ccuid2>"},"connector":{"type":"string","enum":["and","or"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.16.showIf.connector","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","items":{"oneOf":[{"type":"object","description":"Single condition. Operators such as `isSubmitted`, `isSkipped`, `isClicked`, `isAccepted`,\n`isBooked`, `isSet`, and `isEmpty` do not use `rightOperand`; comparison operators do.\n","required":["id","leftOperand","operator"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.16.showIf.conditions.items.[INDEX].oneOf.0.id","typeLabel":"string\u003ccuid2>"},"leftOperand":{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.16.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.16.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.16.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.16.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.16.showIf.conditions.items.[INDEX].oneOf.0.leftOperand","typeLabel":"object"},"operator":{"type":"string","enum":["equals","doesNotEqual","contains","doesNotContain","startsWith","doesNotStartWith","endsWith","doesNotEndWith","isSubmitted","isSkipped","isGreaterThan","isLessThan","isGreaterThanOrEqual","isLessThanOrEqual","equalsOneOf","includesAllOf","includesOneOf","doesNotIncludeOneOf","doesNotIncludeAllOf","isClicked","isNotClicked","isAccepted","isBefore","isAfter","isBooked","isPartiallySubmitted","isCompletelySubmitted","isSet","isNotSet","isEmpty","isNotEmpty","isAnyOf"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.16.showIf.conditions.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"rightOperand":{"oneOf":[{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.16.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.16.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.16.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.1","typeLabel":"number"},{"type":"array","items":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.16.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.16.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.16.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value","typeLabel":"string | number | string[]"},"columnId":{"type":"string","minLength":1,"description":"On a matrix row condition, the id of the column. Read before `value` and wins when the two disagree, so the condition survives reordering. Must be a column of the matrix. Optional: when only `value` is sent, the id is filled in from the position on write.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.16.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnId","typeLabel":"string"},"columnIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.16.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition with `isAnyOf`, the ids of the columns `value` lists. Read before `value`, like `columnId`.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.16.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.16.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0","typeLabel":"object"},{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.16.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.16.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.16.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.16.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.16.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1","typeLabel":"object"}],"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.16.showIf.conditions.items.[INDEX].oneOf.0.rightOperand","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.16.showIf.conditions.items.[INDEX].oneOf.0","typeLabel":"object"},{}],"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.16.showIf.conditions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.16.showIf.conditions","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.16.showIf","typeLabel":"object"},"code":{"type":"string","maxLength":30,"pattern":"^[a-z][a-z0-9_]*$","description":"Question code, the name the question carries in exports, webhooks and links. Optional. Starts with a lowercase letter, then lowercase letters, digits and `_`; no `__`, no trailing `_`, at most 30 characters. It must not be an SPSS reserved word (`all`, `and`, `by`, `eq`, `ge`, `gt`, `le`, `lt`, `ne`, `not`, `or`, `to`, `with`) or an export column name (`response_id`, `language`, `outcome`, ...), and must be unique among the survey's question codes, Embedded Data names and the Question IDs of other questions, ignoring case. CTA elements have no code.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.16.code","typeLabel":"string"},"lowerLabel":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.16.lowerLabel.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.16.lowerLabel","typeLabel":"object"},"upperLabel":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.16.upperLabel.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.16.upperLabel","typeLabel":"object"},"isColorCodingEnabled":{"type":"boolean","default":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.16.isColorCodingEnabled","typeLabel":"boolean"}},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.16","typeLabel":"object"},{"type":"object","description":"Survey element/question inside a block. Element ids are stable public identifiers used by\nlogic, recall strings, response data, quotas, integrations, and analysis. `type` selects the\nallowed shape; unsupported fields are rejected instead of ignored.\n","required":["id","type","headline","required"],"properties":{"id":{"type":"string","pattern":"^[a-zA-Z0-9_-]+$","description":"Stable element id. Avoid spaces and reserved ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.17.id","typeLabel":"string"},"type":{"type":"string","enum":["signature"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.17.type","typeLabel":"enum\u003cstring>"},"headline":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.17.headline.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.17.headline","typeLabel":"object"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.17.required","typeLabel":"boolean"},"subheader":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.17.subheader.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.17.subheader","typeLabel":"object"},"imageUrl":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.17.imageUrl","typeLabel":"string"},"imageAltText":{"type":"object","description":"Text alternative for `imageUrl`, read by screen readers. Omit or leave empty for a decorative image (rendered as `alt=\"\"`).","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.17.imageAltText.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.17.imageAltText","typeLabel":"object"},"videoUrl":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.17.videoUrl","typeLabel":"string"},"isDraft":{"type":"boolean","description":"Draft marker used by the editor and future update rules.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.17.isDraft","typeLabel":"boolean"},"showIf":{"type":"object","description":"Show-if: the element is shown only when this condition group matches, re-evaluated live as answers above it on the same page change. A hidden element is not validated (a hidden required element never blocks submission) and its answer is not submitted. Conditions use the same operands and operators as block `logic`. Reference rule: an element's show-if may use answers from earlier blocks and from elements above it in the same block, never itself or anything below it; a violation fails with `misordered_reference` at the exact condition path. Omit it, or send an empty group, for an element that is always shown.","required":["id","connector","conditions"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.17.showIf.id","typeLabel":"string\u003ccuid2>"},"connector":{"type":"string","enum":["and","or"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.17.showIf.connector","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","items":{"oneOf":[{"type":"object","description":"Single condition. Operators such as `isSubmitted`, `isSkipped`, `isClicked`, `isAccepted`,\n`isBooked`, `isSet`, and `isEmpty` do not use `rightOperand`; comparison operators do.\n","required":["id","leftOperand","operator"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.17.showIf.conditions.items.[INDEX].oneOf.0.id","typeLabel":"string\u003ccuid2>"},"leftOperand":{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.17.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.17.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.17.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.17.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.17.showIf.conditions.items.[INDEX].oneOf.0.leftOperand","typeLabel":"object"},"operator":{"type":"string","enum":["equals","doesNotEqual","contains","doesNotContain","startsWith","doesNotStartWith","endsWith","doesNotEndWith","isSubmitted","isSkipped","isGreaterThan","isLessThan","isGreaterThanOrEqual","isLessThanOrEqual","equalsOneOf","includesAllOf","includesOneOf","doesNotIncludeOneOf","doesNotIncludeAllOf","isClicked","isNotClicked","isAccepted","isBefore","isAfter","isBooked","isPartiallySubmitted","isCompletelySubmitted","isSet","isNotSet","isEmpty","isNotEmpty","isAnyOf"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.17.showIf.conditions.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"rightOperand":{"oneOf":[{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.17.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.17.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.17.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.1","typeLabel":"number"},{"type":"array","items":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.17.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.17.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.17.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value","typeLabel":"string | number | string[]"},"columnId":{"type":"string","minLength":1,"description":"On a matrix row condition, the id of the column. Read before `value` and wins when the two disagree, so the condition survives reordering. Must be a column of the matrix. Optional: when only `value` is sent, the id is filled in from the position on write.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.17.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnId","typeLabel":"string"},"columnIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.17.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition with `isAnyOf`, the ids of the columns `value` lists. Read before `value`, like `columnId`.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.17.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.17.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0","typeLabel":"object"},{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.17.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.17.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.17.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.17.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.17.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1","typeLabel":"object"}],"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.17.showIf.conditions.items.[INDEX].oneOf.0.rightOperand","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.17.showIf.conditions.items.[INDEX].oneOf.0","typeLabel":"object"},{}],"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.17.showIf.conditions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.17.showIf.conditions","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.17.showIf","typeLabel":"object"},"code":{"type":"string","maxLength":30,"pattern":"^[a-z][a-z0-9_]*$","description":"Question code, the name the question carries in exports, webhooks and links. Optional. Starts with a lowercase letter, then lowercase letters, digits and `_`; no `__`, no trailing `_`, at most 30 characters. It must not be an SPSS reserved word (`all`, `and`, `by`, `eq`, `ge`, `gt`, `le`, `lt`, `ne`, `not`, `or`, `to`, `with`) or an export column name (`response_id`, `language`, `outcome`, ...), and must be unique among the survey's question codes, Embedded Data names and the Question IDs of other questions, ignoring case. CTA elements have no code.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.17.code","typeLabel":"string"},"allowTypedSignature":{"type":"boolean","default":true,"description":"Whether the respondent may type their name instead of drawing. The signature is stored as a single PNG image either way.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.17.allowTypedSignature","typeLabel":"boolean"}},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX].oneOf.17","typeLabel":"object"}],"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.elements","typeLabel":"object[]"},"id":{"type":"string","format":"cuid2","description":"Optional stable block id. Generated when omitted.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.id","typeLabel":"string\u003ccuid2>"},"logic":{"type":"array","items":{"type":"object","description":"Conditional logic rule evaluated at block level.","required":["id","conditions","actions"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.logic.items.[INDEX].id","typeLabel":"string\u003ccuid2>"},"conditions":{"type":"object","required":["id","connector","conditions"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.logic.items.[INDEX].conditions.id","typeLabel":"string\u003ccuid2>"},"connector":{"type":"string","enum":["and","or"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.logic.items.[INDEX].conditions.connector","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","items":{"oneOf":[{"type":"object","description":"Single condition. Operators such as `isSubmitted`, `isSkipped`, `isClicked`, `isAccepted`,\n`isBooked`, `isSet`, and `isEmpty` do not use `rightOperand`; comparison operators do.\n","required":["id","leftOperand","operator"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.logic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.id","typeLabel":"string\u003ccuid2>"},"leftOperand":{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.logic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.leftOperand.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.logic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.leftOperand.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.logic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.leftOperand.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.logic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.leftOperand.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.logic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.leftOperand","typeLabel":"object"},"operator":{"type":"string","enum":["equals","doesNotEqual","contains","doesNotContain","startsWith","doesNotStartWith","endsWith","doesNotEndWith","isSubmitted","isSkipped","isGreaterThan","isLessThan","isGreaterThanOrEqual","isLessThanOrEqual","equalsOneOf","includesAllOf","includesOneOf","doesNotIncludeOneOf","doesNotIncludeAllOf","isClicked","isNotClicked","isAccepted","isBefore","isAfter","isBooked","isPartiallySubmitted","isCompletelySubmitted","isSet","isNotSet","isEmpty","isNotEmpty","isAnyOf"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.logic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"rightOperand":{"oneOf":[{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.logic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.logic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.logic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.1","typeLabel":"number"},{"type":"array","items":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.logic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.logic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.logic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value","typeLabel":"string | number | string[]"},"columnId":{"type":"string","minLength":1,"description":"On a matrix row condition, the id of the column. Read before `value` and wins when the two disagree, so the condition survives reordering. Must be a column of the matrix. Optional: when only `value` is sent, the id is filled in from the position on write.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.logic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnId","typeLabel":"string"},"columnIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.logic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition with `isAnyOf`, the ids of the columns `value` lists. Read before `value`, like `columnId`.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.logic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.logic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0","typeLabel":"object"},{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.logic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.logic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.logic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.logic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.logic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1","typeLabel":"object"}],"uniqueKey":"ops.items.[INDEX].oneOf.0.block.logic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.rightOperand","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.logic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0","typeLabel":"object"},{}],"uniqueKey":"ops.items.[INDEX].oneOf.0.block.logic.items.[INDEX].conditions.conditions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.logic.items.[INDEX].conditions.conditions","typeLabel":"object[]"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.logic.items.[INDEX].conditions","typeLabel":"object"},"actions":{"type":"array","items":{"oneOf":[{"type":"object","description":"Logic action. Keep referenced ids stable: `calculate.variableId` points to a variable id,\n`requireAnswer.target` points to an element id, and `jumpToBlock.target` points to a block id\nor ending id. `markLowQuality` takes no target: it marks the response Low quality when the rule fires.\n","required":["id","objective","variableId","operator","value"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.0.id","typeLabel":"string\u003ccuid2>"},"objective":{"type":"string","enum":["calculate"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.0.objective","typeLabel":"enum\u003cstring>"},"variableId":{"type":"string","format":"cuid2","description":"The computed field's `storageKey` (a legacy variable id).","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.0.variableId","typeLabel":"string\u003ccuid2>"},"operator":{"type":"string","enum":["assign","concat","add","subtract","multiply","divide"],"description":"An `expression` value takes `assign` only.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.0.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.0.value.oneOf.1","typeLabel":"number"},{"type":"array","items":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.0.value.oneOf.2.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.0.value.oneOf.2","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.0.value","typeLabel":"string | number | string[]"},"columnId":{"type":"string","minLength":1,"description":"On a matrix row condition, the id of the column. Read before `value` and wins when the two disagree, so the condition survives reordering. Must be a column of the matrix. Optional: when only `value` is sent, the id is filled in from the position on write.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.0.columnId","typeLabel":"string"},"columnIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.0.columnIds.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition with `isAnyOf`, the ids of the columns `value` lists. Read before `value`, like `columnId`.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.0.columnIds","typeLabel":"string[]"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.0","typeLabel":"object"},{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.1","typeLabel":"object"},{"type":"object","description":"The value of a Set value step: an expression tree, evaluated in the respondent's browser without `eval`. Validation refuses text in arithmetic, unknown functions, wrong argument counts, references that don't exist and a result type that doesn't match the target field, each at its exact path (`…value.value.args.1`). Trees are at most 12 levels deep and 200 nodes.\n","required":["type","value"],"example":{"type":"expression","value":{"type":"call","fn":"round","args":[{"type":"call","fn":"add","args":[{"type":"element","value":"q1"},{"type":"call","fn":"multiply","args":[{"type":"element","value":"q2"},{"type":"static","value":2}]}]}]}},"properties":{"type":{"type":"string","enum":["expression"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.2.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"object","description":"One node of a Set value expression: a fixed value, a reference, or a function call.\n\n**Leaves.** `static` is a number or text (a text `2026-03-01` counts as a date where one is expected). `element` is an answer, by element id: rating, NPS, CSAT, CES and number open text are numbers; other open text is text; a date question is a date; a single select yields its answer code as text. Other question types can't be used. `variable` is a computed field and `hiddenField` an ingested field, by storage key, typed by their `dataType`; `reserved` is a reserved field by name.\n\n**Functions** (`call`): `add`, `multiply`, `min`, `max` take 2–50 numbers; `subtract` and `divide` exactly 2 (÷ 0 gives empty); `round` a number and optional fixed decimals (0–10, rounding half away from zero); `abs` 1 number; `ifEmpty` a value and a fallback of the same type; `concat` 2–50 values of any type (numbers and dates become text); `now` none (the device clock as a UTC ISO timestamp); `daysBetween` 2 dates (UTC calendar days from the first to the second, negative allowed).\n\n**Empty values.** An unanswered question or unset field is empty, and so is a value that isn't a number where a number is needed; every function except `ifEmpty` then gives empty.\n","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.2.value.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.2.value.oneOf.0.value.oneOf.0","typeLabel":"number"},{"type":"string","maxLength":5000,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.2.value.oneOf.0.value.oneOf.1","typeLabel":"string"}],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.2.value.oneOf.0.value","typeLabel":"number | string"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.2.value.oneOf.0","typeLabel":"object"},{"type":"object","description":"One node of a Set value expression: a fixed value, a reference, or a function call.\n\n**Leaves.** `static` is a number or text (a text `2026-03-01` counts as a date where one is expected). `element` is an answer, by element id: rating, NPS, CSAT, CES and number open text are numbers; other open text is text; a date question is a date; a single select yields its answer code as text. Other question types can't be used. `variable` is a computed field and `hiddenField` an ingested field, by storage key, typed by their `dataType`; `reserved` is a reserved field by name.\n\n**Functions** (`call`): `add`, `multiply`, `min`, `max` take 2–50 numbers; `subtract` and `divide` exactly 2 (÷ 0 gives empty); `round` a number and optional fixed decimals (0–10, rounding half away from zero); `abs` 1 number; `ifEmpty` a value and a fallback of the same type; `concat` 2–50 values of any type (numbers and dates become text); `now` none (the device clock as a UTC ISO timestamp); `daysBetween` 2 dates (UTC calendar days from the first to the second, negative allowed).\n\n**Empty values.** An unanswered question or unset field is empty, and so is a value that isn't a number where a number is needed; every function except `ifEmpty` then gives empty.\n","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.2.value.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.2.value.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.2.value.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.2.value.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.2.value.oneOf.1","typeLabel":"object"},{"type":"object","description":"One node of a Set value expression: a fixed value, a reference, or a function call.\n\n**Leaves.** `static` is a number or text (a text `2026-03-01` counts as a date where one is expected). `element` is an answer, by element id: rating, NPS, CSAT, CES and number open text are numbers; other open text is text; a date question is a date; a single select yields its answer code as text. Other question types can't be used. `variable` is a computed field and `hiddenField` an ingested field, by storage key, typed by their `dataType`; `reserved` is a reserved field by name.\n\n**Functions** (`call`): `add`, `multiply`, `min`, `max` take 2–50 numbers; `subtract` and `divide` exactly 2 (÷ 0 gives empty); `round` a number and optional fixed decimals (0–10, rounding half away from zero); `abs` 1 number; `ifEmpty` a value and a fallback of the same type; `concat` 2–50 values of any type (numbers and dates become text); `now` none (the device clock as a UTC ISO timestamp); `daysBetween` 2 dates (UTC calendar days from the first to the second, negative allowed).\n\n**Empty values.** An unanswered question or unset field is empty, and so is a value that isn't a number where a number is needed; every function except `ifEmpty` then gives empty.\n","required":["type","fn","args"],"properties":{"type":{"type":"string","enum":["call"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.2.value.oneOf.2.type","typeLabel":"enum\u003cstring>"},"fn":{"type":"string","enum":["add","subtract","multiply","divide","round","min","max","abs","ifEmpty","concat","now","daysBetween"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.2.value.oneOf.2.fn","typeLabel":"enum\u003cstring>"},"args":{"type":"array","maxItems":50,"items":{"$circularRef":"05361453-d19c-419d-9183-f17ee4b34306"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.2.value.oneOf.2.args","typeLabel":"array"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.2.value.oneOf.2","typeLabel":"object"}],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.2.value","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.2","typeLabel":"object"}],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","description":"Logic action. Keep referenced ids stable: `calculate.variableId` points to a variable id,\n`requireAnswer.target` points to an element id, and `jumpToBlock.target` points to a block id\nor ending id. `markLowQuality` takes no target: it marks the response Low quality when the rule fires.\n","required":["id","objective","target"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.1.id","typeLabel":"string\u003ccuid2>"},"objective":{"type":"string","enum":["requireAnswer"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.1.objective","typeLabel":"enum\u003cstring>"},"target":{"type":"string","description":"Target element id.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.1.target","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.1","typeLabel":"object"},{"type":"object","description":"Logic action. Keep referenced ids stable: `calculate.variableId` points to a variable id,\n`requireAnswer.target` points to an element id, and `jumpToBlock.target` points to a block id\nor ending id. `markLowQuality` takes no target: it marks the response Low quality when the rule fires.\n","required":["id","objective","target"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.2.id","typeLabel":"string\u003ccuid2>"},"objective":{"type":"string","enum":["jumpToBlock"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.2.objective","typeLabel":"enum\u003cstring>"},"target":{"type":"string","format":"cuid2","description":"Target block id or ending id.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.2.target","typeLabel":"string\u003ccuid2>"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.2","typeLabel":"object"},{"type":"object","description":"Logic action. Keep referenced ids stable: `calculate.variableId` points to a variable id,\n`requireAnswer.target` points to an element id, and `jumpToBlock.target` points to a block id\nor ending id. `markLowQuality` takes no target: it marks the response Low quality when the rule fires.\n","required":["id","objective"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.3.id","typeLabel":"string\u003ccuid2>"},"objective":{"type":"string","enum":["markLowQuality"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.3.objective","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.3","typeLabel":"object"}],"uniqueKey":"ops.items.[INDEX].oneOf.0.block.logic.items.[INDEX].actions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.logic.items.[INDEX].actions","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.logic.items.[INDEX]","typeLabel":"object"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.logic","typeLabel":"object[]"},"logicFallback":{"type":"string","format":"cuid2","description":"Block or ending id used when no logic condition matches. Only valid when this same block\nhas at least one `logic` rule; omit it for normal sequential flow.\n","uniqueKey":"ops.items.[INDEX].oneOf.0.block.logicFallback","typeLabel":"string\u003ccuid2>"},"showIf":{"type":"object","description":"Show-if: the block is shown only when this condition group matches. A block whose show-if fails is skipped, and its `logic` still runs as if the block were submitted with no answers. A block whose elements are all hidden by their show-if is skipped the same way. Conditions use the same operands and operators as `logic`. Reference rule: a block's show-if may use answers from earlier blocks only (plus hidden fields, variables and reserved fields); a violation fails with `misordered_reference` at the exact condition path. Omit it, or send an empty group, for a block that is always shown.","required":["id","connector","conditions"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.showIf.id","typeLabel":"string\u003ccuid2>"},"connector":{"type":"string","enum":["and","or"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.showIf.connector","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","items":{"oneOf":[{"type":"object","description":"Single condition. Operators such as `isSubmitted`, `isSkipped`, `isClicked`, `isAccepted`,\n`isBooked`, `isSet`, and `isEmpty` do not use `rightOperand`; comparison operators do.\n","required":["id","leftOperand","operator"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.showIf.conditions.items.[INDEX].oneOf.0.id","typeLabel":"string\u003ccuid2>"},"leftOperand":{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.showIf.conditions.items.[INDEX].oneOf.0.leftOperand","typeLabel":"object"},"operator":{"type":"string","enum":["equals","doesNotEqual","contains","doesNotContain","startsWith","doesNotStartWith","endsWith","doesNotEndWith","isSubmitted","isSkipped","isGreaterThan","isLessThan","isGreaterThanOrEqual","isLessThanOrEqual","equalsOneOf","includesAllOf","includesOneOf","doesNotIncludeOneOf","doesNotIncludeAllOf","isClicked","isNotClicked","isAccepted","isBefore","isAfter","isBooked","isPartiallySubmitted","isCompletelySubmitted","isSet","isNotSet","isEmpty","isNotEmpty","isAnyOf"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.showIf.conditions.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"rightOperand":{"oneOf":[{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.1","typeLabel":"number"},{"type":"array","items":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value","typeLabel":"string | number | string[]"},"columnId":{"type":"string","minLength":1,"description":"On a matrix row condition, the id of the column. Read before `value` and wins when the two disagree, so the condition survives reordering. Must be a column of the matrix. Optional: when only `value` is sent, the id is filled in from the position on write.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnId","typeLabel":"string"},"columnIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition with `isAnyOf`, the ids of the columns `value` lists. Read before `value`, like `columnId`.","uniqueKey":"ops.items.[INDEX].oneOf.0.block.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0","typeLabel":"object"},{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1","typeLabel":"object"}],"uniqueKey":"ops.items.[INDEX].oneOf.0.block.showIf.conditions.items.[INDEX].oneOf.0.rightOperand","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.showIf.conditions.items.[INDEX].oneOf.0","typeLabel":"object"},{}],"uniqueKey":"ops.items.[INDEX].oneOf.0.block.showIf.conditions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.showIf.conditions","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0.block.showIf","typeLabel":"object"},"buttonLabel":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.buttonLabel.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.buttonLabel","typeLabel":"object"},"backButtonLabel":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.0.block.backButtonLabel.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.0.block.backButtonLabel","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.0.block","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","description":"A single block operation.","required":["op","block","position"],"properties":{"op":{"type":"string","enum":["insert"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.op","typeLabel":"enum\u003cstring>"},"block":{"type":"object","description":"New block. `id` is optional and generated when omitted, matching survey creation. Supply one only when a later operation in the same request anchors after it; if supplied it must not already exist on the survey.\n","required":["name","elements"],"properties":{"name":{"type":"string","minLength":1,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.name","typeLabel":"string"},"elements":{"type":"array","minItems":1,"items":{"oneOf":[{"type":"object","description":"Survey element/question inside a block. Element ids are stable public identifiers used by\nlogic, recall strings, response data, quotas, integrations, and analysis. `type` selects the\nallowed shape; unsupported fields are rejected instead of ignored.\n","required":["id","type","headline","required"],"properties":{"id":{"type":"string","pattern":"^[a-zA-Z0-9_-]+$","description":"Stable element id. Avoid spaces and reserved ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.0.id","typeLabel":"string"},"type":{"type":"string","enum":["openText"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.0.type","typeLabel":"enum\u003cstring>"},"headline":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.0.headline.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.0.headline","typeLabel":"object"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.0.required","typeLabel":"boolean"},"subheader":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.0.subheader.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.0.subheader","typeLabel":"object"},"imageUrl":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.0.imageUrl","typeLabel":"string"},"imageAltText":{"type":"object","description":"Text alternative for `imageUrl`, read by screen readers. Omit or leave empty for a decorative image (rendered as `alt=\"\"`).","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.0.imageAltText.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.0.imageAltText","typeLabel":"object"},"videoUrl":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.0.videoUrl","typeLabel":"string"},"isDraft":{"type":"boolean","description":"Draft marker used by the editor and future update rules.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.0.isDraft","typeLabel":"boolean"},"showIf":{"type":"object","description":"Show-if: the element is shown only when this condition group matches, re-evaluated live as answers above it on the same page change. A hidden element is not validated (a hidden required element never blocks submission) and its answer is not submitted. Conditions use the same operands and operators as block `logic`. Reference rule: an element's show-if may use answers from earlier blocks and from elements above it in the same block, never itself or anything below it; a violation fails with `misordered_reference` at the exact condition path. Omit it, or send an empty group, for an element that is always shown.","required":["id","connector","conditions"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.0.showIf.id","typeLabel":"string\u003ccuid2>"},"connector":{"type":"string","enum":["and","or"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.0.showIf.connector","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","items":{"oneOf":[{"type":"object","description":"Single condition. Operators such as `isSubmitted`, `isSkipped`, `isClicked`, `isAccepted`,\n`isBooked`, `isSet`, and `isEmpty` do not use `rightOperand`; comparison operators do.\n","required":["id","leftOperand","operator"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.0.showIf.conditions.items.[INDEX].oneOf.0.id","typeLabel":"string\u003ccuid2>"},"leftOperand":{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.0.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.0.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.0.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.0.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.0.showIf.conditions.items.[INDEX].oneOf.0.leftOperand","typeLabel":"object"},"operator":{"type":"string","enum":["equals","doesNotEqual","contains","doesNotContain","startsWith","doesNotStartWith","endsWith","doesNotEndWith","isSubmitted","isSkipped","isGreaterThan","isLessThan","isGreaterThanOrEqual","isLessThanOrEqual","equalsOneOf","includesAllOf","includesOneOf","doesNotIncludeOneOf","doesNotIncludeAllOf","isClicked","isNotClicked","isAccepted","isBefore","isAfter","isBooked","isPartiallySubmitted","isCompletelySubmitted","isSet","isNotSet","isEmpty","isNotEmpty","isAnyOf"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.0.showIf.conditions.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"rightOperand":{"oneOf":[{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.0.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.0.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.0.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.1","typeLabel":"number"},{"type":"array","items":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.0.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.0.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.0.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value","typeLabel":"string | number | string[]"},"columnId":{"type":"string","minLength":1,"description":"On a matrix row condition, the id of the column. Read before `value` and wins when the two disagree, so the condition survives reordering. Must be a column of the matrix. Optional: when only `value` is sent, the id is filled in from the position on write.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.0.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnId","typeLabel":"string"},"columnIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.0.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition with `isAnyOf`, the ids of the columns `value` lists. Read before `value`, like `columnId`.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.0.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.0.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0","typeLabel":"object"},{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.0.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.0.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.0.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.0.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.0.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1","typeLabel":"object"}],"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.0.showIf.conditions.items.[INDEX].oneOf.0.rightOperand","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.0.showIf.conditions.items.[INDEX].oneOf.0","typeLabel":"object"},{}],"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.0.showIf.conditions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.0.showIf.conditions","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.0.showIf","typeLabel":"object"},"code":{"type":"string","maxLength":30,"pattern":"^[a-z][a-z0-9_]*$","description":"Question code, the name the question carries in exports, webhooks and links. Optional. Starts with a lowercase letter, then lowercase letters, digits and `_`; no `__`, no trailing `_`, at most 30 characters. It must not be an SPSS reserved word (`all`, `and`, `by`, `eq`, `ge`, `gt`, `le`, `lt`, `ne`, `not`, `or`, `to`, `with`) or an export column name (`response_id`, `language`, `outcome`, ...), and must be unique among the survey's question codes, Embedded Data names and the Question IDs of other questions, ignoring case. CTA elements have no code.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.0.code","typeLabel":"string"},"placeholder":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.0.placeholder.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.0.placeholder","typeLabel":"object"},"longAnswer":{"type":"boolean","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.0.longAnswer","typeLabel":"boolean"},"inputType":{"type":"string","enum":["text","email","url","number","phone"],"default":"text","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.0.inputType","typeLabel":"enum\u003cstring>"},"insightsEnabled":{"type":"boolean","default":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.0.insightsEnabled","typeLabel":"boolean"},"charLimit":{"type":"object","description":"Optional `openText` character limit configuration.","properties":{"enabled":{"type":"boolean","default":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.0.charLimit.enabled","typeLabel":"boolean"},"min":{"type":"number","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.0.charLimit.min","typeLabel":"number"},"max":{"type":"number","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.0.charLimit.max","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.0.charLimit","typeLabel":"object"},"validation":{"type":"object","description":"Optional element-level validation rules.","required":["rules"],"properties":{"rules":{"type":"array","items":{"type":"object","required":["id","type","params"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.0.validation.rules.items.[INDEX].id","typeLabel":"string"},"type":{"type":"string","enum":["minLength","maxLength","pattern","email","url","phone","equals","doesNotEqual","contains","doesNotContain","minValue","maxValue","isGreaterThan","isLessThan","minSelections","maxSelections","minRanked","rankAll","minRowsAnswered","answerAllRows","isLaterThan","isEarlierThan","isBetween","isNotBetween","fileExtensionIs","fileExtensionIsNot"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.0.validation.rules.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"params":{"type":"object","additionalProperties":true,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.0.validation.rules.items.[INDEX].params","typeLabel":"object"},"field":{"type":"string","enum":["addressLine1","addressLine2","city","state","zip","country","firstName","lastName","email","phone","company"],"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.0.validation.rules.items.[INDEX].field","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.0.validation.rules.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.0.validation.rules","typeLabel":"object[]"},"logic":{"type":"string","enum":["and","or"],"default":"and","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.0.validation.logic","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.0.validation","typeLabel":"object"}},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","description":"Survey element/question inside a block. Element ids are stable public identifiers used by\nlogic, recall strings, response data, quotas, integrations, and analysis. `type` selects the\nallowed shape; unsupported fields are rejected instead of ignored.\n","required":["label","id","type","headline","required"],"properties":{"id":{"type":"string","pattern":"^[a-zA-Z0-9_-]+$","description":"Stable element id. Avoid spaces and reserved ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.1.id","typeLabel":"string"},"type":{"type":"string","enum":["consent"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.1.type","typeLabel":"enum\u003cstring>"},"headline":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.1.headline.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.1.headline","typeLabel":"object"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.1.required","typeLabel":"boolean"},"label":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.1.label.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.1.label","typeLabel":"object"},"subheader":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.1.subheader.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.1.subheader","typeLabel":"object"},"imageUrl":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.1.imageUrl","typeLabel":"string"},"imageAltText":{"type":"object","description":"Text alternative for `imageUrl`, read by screen readers. Omit or leave empty for a decorative image (rendered as `alt=\"\"`).","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.1.imageAltText.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.1.imageAltText","typeLabel":"object"},"videoUrl":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.1.videoUrl","typeLabel":"string"},"isDraft":{"type":"boolean","description":"Draft marker used by the editor and future update rules.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.1.isDraft","typeLabel":"boolean"},"showIf":{"type":"object","description":"Show-if: the element is shown only when this condition group matches, re-evaluated live as answers above it on the same page change. A hidden element is not validated (a hidden required element never blocks submission) and its answer is not submitted. Conditions use the same operands and operators as block `logic`. Reference rule: an element's show-if may use answers from earlier blocks and from elements above it in the same block, never itself or anything below it; a violation fails with `misordered_reference` at the exact condition path. Omit it, or send an empty group, for an element that is always shown.","required":["id","connector","conditions"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.1.showIf.id","typeLabel":"string\u003ccuid2>"},"connector":{"type":"string","enum":["and","or"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.1.showIf.connector","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","items":{"oneOf":[{"type":"object","description":"Single condition. Operators such as `isSubmitted`, `isSkipped`, `isClicked`, `isAccepted`,\n`isBooked`, `isSet`, and `isEmpty` do not use `rightOperand`; comparison operators do.\n","required":["id","leftOperand","operator"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.1.showIf.conditions.items.[INDEX].oneOf.0.id","typeLabel":"string\u003ccuid2>"},"leftOperand":{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.1.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.1.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.1.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.1.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.1.showIf.conditions.items.[INDEX].oneOf.0.leftOperand","typeLabel":"object"},"operator":{"type":"string","enum":["equals","doesNotEqual","contains","doesNotContain","startsWith","doesNotStartWith","endsWith","doesNotEndWith","isSubmitted","isSkipped","isGreaterThan","isLessThan","isGreaterThanOrEqual","isLessThanOrEqual","equalsOneOf","includesAllOf","includesOneOf","doesNotIncludeOneOf","doesNotIncludeAllOf","isClicked","isNotClicked","isAccepted","isBefore","isAfter","isBooked","isPartiallySubmitted","isCompletelySubmitted","isSet","isNotSet","isEmpty","isNotEmpty","isAnyOf"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.1.showIf.conditions.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"rightOperand":{"oneOf":[{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.1.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.1.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.1.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.1","typeLabel":"number"},{"type":"array","items":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.1.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.1.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.1.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value","typeLabel":"string | number | string[]"},"columnId":{"type":"string","minLength":1,"description":"On a matrix row condition, the id of the column. Read before `value` and wins when the two disagree, so the condition survives reordering. Must be a column of the matrix. Optional: when only `value` is sent, the id is filled in from the position on write.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.1.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnId","typeLabel":"string"},"columnIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.1.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition with `isAnyOf`, the ids of the columns `value` lists. Read before `value`, like `columnId`.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.1.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.1.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0","typeLabel":"object"},{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.1.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.1.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.1.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.1.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.1.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1","typeLabel":"object"}],"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.1.showIf.conditions.items.[INDEX].oneOf.0.rightOperand","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.1.showIf.conditions.items.[INDEX].oneOf.0","typeLabel":"object"},{}],"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.1.showIf.conditions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.1.showIf.conditions","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.1.showIf","typeLabel":"object"},"code":{"type":"string","maxLength":30,"pattern":"^[a-z][a-z0-9_]*$","description":"Question code, the name the question carries in exports, webhooks and links. Optional. Starts with a lowercase letter, then lowercase letters, digits and `_`; no `__`, no trailing `_`, at most 30 characters. It must not be an SPSS reserved word (`all`, `and`, `by`, `eq`, `ge`, `gt`, `le`, `lt`, `ne`, `not`, `or`, `to`, `with`) or an export column name (`response_id`, `language`, `outcome`, ...), and must be unique among the survey's question codes, Embedded Data names and the Question IDs of other questions, ignoring case. CTA elements have no code.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.1.code","typeLabel":"string"},"validation":{"type":"object","description":"Optional element-level validation rules.","required":["rules"],"properties":{"rules":{"type":"array","items":{"type":"object","required":["id","type","params"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.1.validation.rules.items.[INDEX].id","typeLabel":"string"},"type":{"type":"string","enum":["minLength","maxLength","pattern","email","url","phone","equals","doesNotEqual","contains","doesNotContain","minValue","maxValue","isGreaterThan","isLessThan","minSelections","maxSelections","minRanked","rankAll","minRowsAnswered","answerAllRows","isLaterThan","isEarlierThan","isBetween","isNotBetween","fileExtensionIs","fileExtensionIsNot"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.1.validation.rules.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"params":{"type":"object","additionalProperties":true,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.1.validation.rules.items.[INDEX].params","typeLabel":"object"},"field":{"type":"string","enum":["addressLine1","addressLine2","city","state","zip","country","firstName","lastName","email","phone","company"],"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.1.validation.rules.items.[INDEX].field","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.1.validation.rules.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.1.validation.rules","typeLabel":"object[]"},"logic":{"type":"string","enum":["and","or"],"default":"and","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.1.validation.logic","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.1.validation","typeLabel":"object"}},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.1","typeLabel":"object"},{"type":"object","description":"Survey element/question inside a block. Element ids are stable public identifiers used by\nlogic, recall strings, response data, quotas, integrations, and analysis. `type` selects the\nallowed shape; unsupported fields are rejected instead of ignored.\n","required":["choices","id","type","headline","required"],"properties":{"id":{"type":"string","pattern":"^[a-zA-Z0-9_-]+$","description":"Stable element id. Avoid spaces and reserved ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.2.id","typeLabel":"string"},"type":{"type":"string","enum":["multipleChoiceSingle"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.2.type","typeLabel":"enum\u003cstring>"},"headline":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.2.headline.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.2.headline","typeLabel":"object"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.2.required","typeLabel":"boolean"},"choices":{"type":"array","minItems":2,"items":{"type":"object","required":["id","label"],"properties":{"id":{"type":"string","description":"Stable choice id.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.2.choices.items.[INDEX].id","typeLabel":"string"},"label":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.2.choices.items.[INDEX].label.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.2.choices.items.[INDEX].label","typeLabel":"object"},"code":{"type":"string","maxLength":20,"pattern":"^[a-z0-9][a-z0-9_]*$","description":"Answer code of an option, a matrix row or a matrix column. Optional. Lowercase letters, digits and `_`; it may start with a digit, but not with `_`; no `__`, no trailing `_`, at most 20 characters. It must not be an SPSS reserved word or an export column name, and must be unique within its question (a matrix's rows and columns are checked separately), ignoring case.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.2.choices.items.[INDEX].code","typeLabel":"string"},"showIf":{"type":"object","description":"Option show-if: the option (or matrix row or column) is offered only when this condition group matches, re-evaluated live as earlier answers change. It may use what its element's show-if may use: answers from earlier blocks and from elements above its element in the same block, never its own element or anything below (`misordered_reference` at the exact condition path). A question left with no option to offer is skipped and recorded as not shown. Omit it, or send an empty group, for an option that is always offered. Allowed on published surveys.","required":["id","connector","conditions"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf.id","typeLabel":"string\u003ccuid2>"},"connector":{"type":"string","enum":["and","or"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf.connector","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","items":{"oneOf":[{"type":"object","description":"Single condition. Operators such as `isSubmitted`, `isSkipped`, `isClicked`, `isAccepted`,\n`isBooked`, `isSet`, and `isEmpty` do not use `rightOperand`; comparison operators do.\n","required":["id","leftOperand","operator"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.id","typeLabel":"string\u003ccuid2>"},"leftOperand":{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand","typeLabel":"object"},"operator":{"type":"string","enum":["equals","doesNotEqual","contains","doesNotContain","startsWith","doesNotStartWith","endsWith","doesNotEndWith","isSubmitted","isSkipped","isGreaterThan","isLessThan","isGreaterThanOrEqual","isLessThanOrEqual","equalsOneOf","includesAllOf","includesOneOf","doesNotIncludeOneOf","doesNotIncludeAllOf","isClicked","isNotClicked","isAccepted","isBefore","isAfter","isBooked","isPartiallySubmitted","isCompletelySubmitted","isSet","isNotSet","isEmpty","isNotEmpty","isAnyOf"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"rightOperand":{"oneOf":[{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.1","typeLabel":"number"},{"type":"array","items":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value","typeLabel":"string | number | string[]"},"columnId":{"type":"string","minLength":1,"description":"On a matrix row condition, the id of the column. Read before `value` and wins when the two disagree, so the condition survives reordering. Must be a column of the matrix. Optional: when only `value` is sent, the id is filled in from the position on write.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnId","typeLabel":"string"},"columnIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition with `isAnyOf`, the ids of the columns `value` lists. Read before `value`, like `columnId`.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0","typeLabel":"object"},{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1","typeLabel":"object"}],"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0","typeLabel":"object"},{}],"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf.conditions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf.conditions","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf","typeLabel":"object"},"hidden":{"type":"boolean","description":"Hidden: the option is never offered, whatever its `showIf` says, and is recorded as not shown. Use it to retire an option on a published survey instead of deleting it (deleting an option that existed at launch is refused): it keeps its id, answer code and earlier answers, and stays in results labelled Hidden.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.2.choices.items.[INDEX].hidden","typeLabel":"boolean"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.2.choices.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.2.choices","typeLabel":"object[]"},"subheader":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.2.subheader.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.2.subheader","typeLabel":"object"},"imageUrl":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.2.imageUrl","typeLabel":"string"},"imageAltText":{"type":"object","description":"Text alternative for `imageUrl`, read by screen readers. Omit or leave empty for a decorative image (rendered as `alt=\"\"`).","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.2.imageAltText.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.2.imageAltText","typeLabel":"object"},"videoUrl":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.2.videoUrl","typeLabel":"string"},"isDraft":{"type":"boolean","description":"Draft marker used by the editor and future update rules.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.2.isDraft","typeLabel":"boolean"},"showIf":{"type":"object","description":"Show-if: the element is shown only when this condition group matches, re-evaluated live as answers above it on the same page change. A hidden element is not validated (a hidden required element never blocks submission) and its answer is not submitted. Conditions use the same operands and operators as block `logic`. Reference rule: an element's show-if may use answers from earlier blocks and from elements above it in the same block, never itself or anything below it; a violation fails with `misordered_reference` at the exact condition path. Omit it, or send an empty group, for an element that is always shown.","required":["id","connector","conditions"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.2.showIf.id","typeLabel":"string\u003ccuid2>"},"connector":{"type":"string","enum":["and","or"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.2.showIf.connector","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","items":{"oneOf":[{"type":"object","description":"Single condition. Operators such as `isSubmitted`, `isSkipped`, `isClicked`, `isAccepted`,\n`isBooked`, `isSet`, and `isEmpty` do not use `rightOperand`; comparison operators do.\n","required":["id","leftOperand","operator"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.2.showIf.conditions.items.[INDEX].oneOf.0.id","typeLabel":"string\u003ccuid2>"},"leftOperand":{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.2.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.2.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.2.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.2.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.2.showIf.conditions.items.[INDEX].oneOf.0.leftOperand","typeLabel":"object"},"operator":{"type":"string","enum":["equals","doesNotEqual","contains","doesNotContain","startsWith","doesNotStartWith","endsWith","doesNotEndWith","isSubmitted","isSkipped","isGreaterThan","isLessThan","isGreaterThanOrEqual","isLessThanOrEqual","equalsOneOf","includesAllOf","includesOneOf","doesNotIncludeOneOf","doesNotIncludeAllOf","isClicked","isNotClicked","isAccepted","isBefore","isAfter","isBooked","isPartiallySubmitted","isCompletelySubmitted","isSet","isNotSet","isEmpty","isNotEmpty","isAnyOf"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.2.showIf.conditions.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"rightOperand":{"oneOf":[{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.2.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.2.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.2.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.1","typeLabel":"number"},{"type":"array","items":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.2.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.2.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.2.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value","typeLabel":"string | number | string[]"},"columnId":{"type":"string","minLength":1,"description":"On a matrix row condition, the id of the column. Read before `value` and wins when the two disagree, so the condition survives reordering. Must be a column of the matrix. Optional: when only `value` is sent, the id is filled in from the position on write.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.2.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnId","typeLabel":"string"},"columnIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.2.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition with `isAnyOf`, the ids of the columns `value` lists. Read before `value`, like `columnId`.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.2.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.2.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0","typeLabel":"object"},{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.2.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.2.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.2.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.2.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.2.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1","typeLabel":"object"}],"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.2.showIf.conditions.items.[INDEX].oneOf.0.rightOperand","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.2.showIf.conditions.items.[INDEX].oneOf.0","typeLabel":"object"},{}],"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.2.showIf.conditions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.2.showIf.conditions","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.2.showIf","typeLabel":"object"},"code":{"type":"string","maxLength":30,"pattern":"^[a-z][a-z0-9_]*$","description":"Question code, the name the question carries in exports, webhooks and links. Optional. Starts with a lowercase letter, then lowercase letters, digits and `_`; no `__`, no trailing `_`, at most 30 characters. It must not be an SPSS reserved word (`all`, `and`, `by`, `eq`, `ge`, `gt`, `le`, `lt`, `ne`, `not`, `or`, `to`, `with`) or an export column name (`response_id`, `language`, `outcome`, ...), and must be unique among the survey's question codes, Embedded Data names and the Question IDs of other questions, ignoring case. CTA elements have no code.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.2.code","typeLabel":"string"},"optionsCopiedFrom":{"type":"string","minLength":1,"description":"Copied options: the id of an earlier element whose options this element copies (\"only the brands you know\"). Choices copy from a single select, multi select or ranking; pictures from a picture selection (matrix rows are not copied: give rows a `showIf` on the source instead). Write the copies yourself: each copied option keeps the source option's `id` and `code`, and carries a `showIf` \"picked in the source\" (`includesOneOf` with its own id, or `equals` when the source is a single select), so the element offers exactly the options picked there. Copied codes follow the source's: a code sent for a copy is replaced by the source option's. Fixed options next to the copies (such as \"None of these\", id `none`) get the next code free in every linked element. The source must exist (`dangling_reference`), sit in an earlier block or above this element on its block (`misordered_reference`), and have options of the same kind (`invalid_reference`). To bring in options the source gained later, add them the same way.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.2.optionsCopiedFrom","typeLabel":"string"},"shuffleOption":{"type":"string","enum":["none","all","exceptLast","reverseOrderOccasionally","reverseOrderExceptLast"],"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.2.shuffleOption","typeLabel":"enum\u003cstring>"},"otherOptionPlaceholder":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.2.otherOptionPlaceholder.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.2.otherOptionPlaceholder","typeLabel":"object"},"displayType":{"type":"string","enum":["list","row","dropdown"],"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.2.displayType","typeLabel":"enum\u003cstring>"}},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.2","typeLabel":"object"},{"type":"object","description":"Survey element/question inside a block. Element ids are stable public identifiers used by\nlogic, recall strings, response data, quotas, integrations, and analysis. `type` selects the\nallowed shape; unsupported fields are rejected instead of ignored.\n","required":["choices","id","type","headline","required"],"properties":{"id":{"type":"string","pattern":"^[a-zA-Z0-9_-]+$","description":"Stable element id. Avoid spaces and reserved ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.id","typeLabel":"string"},"type":{"type":"string","enum":["multipleChoiceMulti"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.type","typeLabel":"enum\u003cstring>"},"headline":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.headline.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.headline","typeLabel":"object"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.required","typeLabel":"boolean"},"choices":{"type":"array","minItems":2,"items":{"type":"object","required":["id","label"],"properties":{"id":{"type":"string","description":"Stable choice id.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.choices.items.[INDEX].id","typeLabel":"string"},"label":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.choices.items.[INDEX].label.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.choices.items.[INDEX].label","typeLabel":"object"},"code":{"type":"string","maxLength":20,"pattern":"^[a-z0-9][a-z0-9_]*$","description":"Answer code of an option, a matrix row or a matrix column. Optional. Lowercase letters, digits and `_`; it may start with a digit, but not with `_`; no `__`, no trailing `_`, at most 20 characters. It must not be an SPSS reserved word or an export column name, and must be unique within its question (a matrix's rows and columns are checked separately), ignoring case.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.choices.items.[INDEX].code","typeLabel":"string"},"showIf":{"type":"object","description":"Option show-if: the option (or matrix row or column) is offered only when this condition group matches, re-evaluated live as earlier answers change. It may use what its element's show-if may use: answers from earlier blocks and from elements above its element in the same block, never its own element or anything below (`misordered_reference` at the exact condition path). A question left with no option to offer is skipped and recorded as not shown. Omit it, or send an empty group, for an option that is always offered. Allowed on published surveys.","required":["id","connector","conditions"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf.id","typeLabel":"string\u003ccuid2>"},"connector":{"type":"string","enum":["and","or"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf.connector","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","items":{"oneOf":[{"type":"object","description":"Single condition. Operators such as `isSubmitted`, `isSkipped`, `isClicked`, `isAccepted`,\n`isBooked`, `isSet`, and `isEmpty` do not use `rightOperand`; comparison operators do.\n","required":["id","leftOperand","operator"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.id","typeLabel":"string\u003ccuid2>"},"leftOperand":{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand","typeLabel":"object"},"operator":{"type":"string","enum":["equals","doesNotEqual","contains","doesNotContain","startsWith","doesNotStartWith","endsWith","doesNotEndWith","isSubmitted","isSkipped","isGreaterThan","isLessThan","isGreaterThanOrEqual","isLessThanOrEqual","equalsOneOf","includesAllOf","includesOneOf","doesNotIncludeOneOf","doesNotIncludeAllOf","isClicked","isNotClicked","isAccepted","isBefore","isAfter","isBooked","isPartiallySubmitted","isCompletelySubmitted","isSet","isNotSet","isEmpty","isNotEmpty","isAnyOf"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"rightOperand":{"oneOf":[{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.1","typeLabel":"number"},{"type":"array","items":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value","typeLabel":"string | number | string[]"},"columnId":{"type":"string","minLength":1,"description":"On a matrix row condition, the id of the column. Read before `value` and wins when the two disagree, so the condition survives reordering. Must be a column of the matrix. Optional: when only `value` is sent, the id is filled in from the position on write.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnId","typeLabel":"string"},"columnIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition with `isAnyOf`, the ids of the columns `value` lists. Read before `value`, like `columnId`.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0","typeLabel":"object"},{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1","typeLabel":"object"}],"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0","typeLabel":"object"},{}],"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf.conditions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf.conditions","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf","typeLabel":"object"},"hidden":{"type":"boolean","description":"Hidden: the option is never offered, whatever its `showIf` says, and is recorded as not shown. Use it to retire an option on a published survey instead of deleting it (deleting an option that existed at launch is refused): it keeps its id, answer code and earlier answers, and stays in results labelled Hidden.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.choices.items.[INDEX].hidden","typeLabel":"boolean"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.choices.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.choices","typeLabel":"object[]"},"subheader":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.subheader.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.subheader","typeLabel":"object"},"imageUrl":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.imageUrl","typeLabel":"string"},"imageAltText":{"type":"object","description":"Text alternative for `imageUrl`, read by screen readers. Omit or leave empty for a decorative image (rendered as `alt=\"\"`).","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.imageAltText.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.imageAltText","typeLabel":"object"},"videoUrl":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.videoUrl","typeLabel":"string"},"isDraft":{"type":"boolean","description":"Draft marker used by the editor and future update rules.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.isDraft","typeLabel":"boolean"},"showIf":{"type":"object","description":"Show-if: the element is shown only when this condition group matches, re-evaluated live as answers above it on the same page change. A hidden element is not validated (a hidden required element never blocks submission) and its answer is not submitted. Conditions use the same operands and operators as block `logic`. Reference rule: an element's show-if may use answers from earlier blocks and from elements above it in the same block, never itself or anything below it; a violation fails with `misordered_reference` at the exact condition path. Omit it, or send an empty group, for an element that is always shown.","required":["id","connector","conditions"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.showIf.id","typeLabel":"string\u003ccuid2>"},"connector":{"type":"string","enum":["and","or"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.showIf.connector","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","items":{"oneOf":[{"type":"object","description":"Single condition. Operators such as `isSubmitted`, `isSkipped`, `isClicked`, `isAccepted`,\n`isBooked`, `isSet`, and `isEmpty` do not use `rightOperand`; comparison operators do.\n","required":["id","leftOperand","operator"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.showIf.conditions.items.[INDEX].oneOf.0.id","typeLabel":"string\u003ccuid2>"},"leftOperand":{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.showIf.conditions.items.[INDEX].oneOf.0.leftOperand","typeLabel":"object"},"operator":{"type":"string","enum":["equals","doesNotEqual","contains","doesNotContain","startsWith","doesNotStartWith","endsWith","doesNotEndWith","isSubmitted","isSkipped","isGreaterThan","isLessThan","isGreaterThanOrEqual","isLessThanOrEqual","equalsOneOf","includesAllOf","includesOneOf","doesNotIncludeOneOf","doesNotIncludeAllOf","isClicked","isNotClicked","isAccepted","isBefore","isAfter","isBooked","isPartiallySubmitted","isCompletelySubmitted","isSet","isNotSet","isEmpty","isNotEmpty","isAnyOf"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.showIf.conditions.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"rightOperand":{"oneOf":[{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.1","typeLabel":"number"},{"type":"array","items":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value","typeLabel":"string | number | string[]"},"columnId":{"type":"string","minLength":1,"description":"On a matrix row condition, the id of the column. Read before `value` and wins when the two disagree, so the condition survives reordering. Must be a column of the matrix. Optional: when only `value` is sent, the id is filled in from the position on write.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnId","typeLabel":"string"},"columnIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition with `isAnyOf`, the ids of the columns `value` lists. Read before `value`, like `columnId`.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0","typeLabel":"object"},{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1","typeLabel":"object"}],"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.showIf.conditions.items.[INDEX].oneOf.0.rightOperand","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.showIf.conditions.items.[INDEX].oneOf.0","typeLabel":"object"},{}],"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.showIf.conditions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.showIf.conditions","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.showIf","typeLabel":"object"},"code":{"type":"string","maxLength":30,"pattern":"^[a-z][a-z0-9_]*$","description":"Question code, the name the question carries in exports, webhooks and links. Optional. Starts with a lowercase letter, then lowercase letters, digits and `_`; no `__`, no trailing `_`, at most 30 characters. It must not be an SPSS reserved word (`all`, `and`, `by`, `eq`, `ge`, `gt`, `le`, `lt`, `ne`, `not`, `or`, `to`, `with`) or an export column name (`response_id`, `language`, `outcome`, ...), and must be unique among the survey's question codes, Embedded Data names and the Question IDs of other questions, ignoring case. CTA elements have no code.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.code","typeLabel":"string"},"optionsCopiedFrom":{"type":"string","minLength":1,"description":"Copied options: the id of an earlier element whose options this element copies (\"only the brands you know\"). Choices copy from a single select, multi select or ranking; pictures from a picture selection (matrix rows are not copied: give rows a `showIf` on the source instead). Write the copies yourself: each copied option keeps the source option's `id` and `code`, and carries a `showIf` \"picked in the source\" (`includesOneOf` with its own id, or `equals` when the source is a single select), so the element offers exactly the options picked there. Copied codes follow the source's: a code sent for a copy is replaced by the source option's. Fixed options next to the copies (such as \"None of these\", id `none`) get the next code free in every linked element. The source must exist (`dangling_reference`), sit in an earlier block or above this element on its block (`misordered_reference`), and have options of the same kind (`invalid_reference`). To bring in options the source gained later, add them the same way.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.optionsCopiedFrom","typeLabel":"string"},"shuffleOption":{"type":"string","enum":["none","all","exceptLast","reverseOrderOccasionally","reverseOrderExceptLast"],"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.shuffleOption","typeLabel":"enum\u003cstring>"},"otherOptionPlaceholder":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.otherOptionPlaceholder.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.otherOptionPlaceholder","typeLabel":"object"},"validation":{"type":"object","description":"Optional element-level validation rules.","required":["rules"],"properties":{"rules":{"type":"array","items":{"type":"object","required":["id","type","params"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.validation.rules.items.[INDEX].id","typeLabel":"string"},"type":{"type":"string","enum":["minLength","maxLength","pattern","email","url","phone","equals","doesNotEqual","contains","doesNotContain","minValue","maxValue","isGreaterThan","isLessThan","minSelections","maxSelections","minRanked","rankAll","minRowsAnswered","answerAllRows","isLaterThan","isEarlierThan","isBetween","isNotBetween","fileExtensionIs","fileExtensionIsNot"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.validation.rules.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"params":{"type":"object","additionalProperties":true,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.validation.rules.items.[INDEX].params","typeLabel":"object"},"field":{"type":"string","enum":["addressLine1","addressLine2","city","state","zip","country","firstName","lastName","email","phone","company"],"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.validation.rules.items.[INDEX].field","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.validation.rules.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.validation.rules","typeLabel":"object[]"},"logic":{"type":"string","enum":["and","or"],"default":"and","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.validation.logic","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.validation","typeLabel":"object"},"displayType":{"type":"string","enum":["list","row","dropdown"],"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3.displayType","typeLabel":"enum\u003cstring>"}},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.3","typeLabel":"object"},{"type":"object","description":"Survey element/question inside a block. Element ids are stable public identifiers used by\nlogic, recall strings, response data, quotas, integrations, and analysis. `type` selects the\nallowed shape; unsupported fields are rejected instead of ignored.\n","required":["id","type","headline","required"],"properties":{"id":{"type":"string","pattern":"^[a-zA-Z0-9_-]+$","description":"Stable element id. Avoid spaces and reserved ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.4.id","typeLabel":"string"},"type":{"type":"string","enum":["nps"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.4.type","typeLabel":"enum\u003cstring>"},"headline":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.4.headline.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.4.headline","typeLabel":"object"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.4.required","typeLabel":"boolean"},"subheader":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.4.subheader.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.4.subheader","typeLabel":"object"},"imageUrl":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.4.imageUrl","typeLabel":"string"},"imageAltText":{"type":"object","description":"Text alternative for `imageUrl`, read by screen readers. Omit or leave empty for a decorative image (rendered as `alt=\"\"`).","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.4.imageAltText.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.4.imageAltText","typeLabel":"object"},"videoUrl":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.4.videoUrl","typeLabel":"string"},"isDraft":{"type":"boolean","description":"Draft marker used by the editor and future update rules.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.4.isDraft","typeLabel":"boolean"},"showIf":{"type":"object","description":"Show-if: the element is shown only when this condition group matches, re-evaluated live as answers above it on the same page change. A hidden element is not validated (a hidden required element never blocks submission) and its answer is not submitted. Conditions use the same operands and operators as block `logic`. Reference rule: an element's show-if may use answers from earlier blocks and from elements above it in the same block, never itself or anything below it; a violation fails with `misordered_reference` at the exact condition path. Omit it, or send an empty group, for an element that is always shown.","required":["id","connector","conditions"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.4.showIf.id","typeLabel":"string\u003ccuid2>"},"connector":{"type":"string","enum":["and","or"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.4.showIf.connector","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","items":{"oneOf":[{"type":"object","description":"Single condition. Operators such as `isSubmitted`, `isSkipped`, `isClicked`, `isAccepted`,\n`isBooked`, `isSet`, and `isEmpty` do not use `rightOperand`; comparison operators do.\n","required":["id","leftOperand","operator"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.4.showIf.conditions.items.[INDEX].oneOf.0.id","typeLabel":"string\u003ccuid2>"},"leftOperand":{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.4.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.4.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.4.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.4.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.4.showIf.conditions.items.[INDEX].oneOf.0.leftOperand","typeLabel":"object"},"operator":{"type":"string","enum":["equals","doesNotEqual","contains","doesNotContain","startsWith","doesNotStartWith","endsWith","doesNotEndWith","isSubmitted","isSkipped","isGreaterThan","isLessThan","isGreaterThanOrEqual","isLessThanOrEqual","equalsOneOf","includesAllOf","includesOneOf","doesNotIncludeOneOf","doesNotIncludeAllOf","isClicked","isNotClicked","isAccepted","isBefore","isAfter","isBooked","isPartiallySubmitted","isCompletelySubmitted","isSet","isNotSet","isEmpty","isNotEmpty","isAnyOf"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.4.showIf.conditions.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"rightOperand":{"oneOf":[{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.4.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.4.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.4.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.1","typeLabel":"number"},{"type":"array","items":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.4.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.4.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.4.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value","typeLabel":"string | number | string[]"},"columnId":{"type":"string","minLength":1,"description":"On a matrix row condition, the id of the column. Read before `value` and wins when the two disagree, so the condition survives reordering. Must be a column of the matrix. Optional: when only `value` is sent, the id is filled in from the position on write.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.4.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnId","typeLabel":"string"},"columnIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.4.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition with `isAnyOf`, the ids of the columns `value` lists. Read before `value`, like `columnId`.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.4.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.4.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0","typeLabel":"object"},{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.4.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.4.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.4.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.4.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.4.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1","typeLabel":"object"}],"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.4.showIf.conditions.items.[INDEX].oneOf.0.rightOperand","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.4.showIf.conditions.items.[INDEX].oneOf.0","typeLabel":"object"},{}],"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.4.showIf.conditions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.4.showIf.conditions","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.4.showIf","typeLabel":"object"},"code":{"type":"string","maxLength":30,"pattern":"^[a-z][a-z0-9_]*$","description":"Question code, the name the question carries in exports, webhooks and links. Optional. Starts with a lowercase letter, then lowercase letters, digits and `_`; no `__`, no trailing `_`, at most 30 characters. It must not be an SPSS reserved word (`all`, `and`, `by`, `eq`, `ge`, `gt`, `le`, `lt`, `ne`, `not`, `or`, `to`, `with`) or an export column name (`response_id`, `language`, `outcome`, ...), and must be unique among the survey's question codes, Embedded Data names and the Question IDs of other questions, ignoring case. CTA elements have no code.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.4.code","typeLabel":"string"},"lowerLabel":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.4.lowerLabel.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.4.lowerLabel","typeLabel":"object"},"upperLabel":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.4.upperLabel.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.4.upperLabel","typeLabel":"object"},"isColorCodingEnabled":{"type":"boolean","default":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.4.isColorCodingEnabled","typeLabel":"boolean"}},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.4","typeLabel":"object"},{"type":"object","description":"Survey element/question inside a block. Element ids are stable public identifiers used by\nlogic, recall strings, response data, quotas, integrations, and analysis. `type` selects the\nallowed shape; unsupported fields are rejected instead of ignored.\n","required":["id","type","headline","required"],"conditionallyRequiredProperties":{"buttonUrl":[{"when":[[{"property":"buttonExternal","values":[true]}]]}],"ctaButtonLabel":[{"when":[[{"property":"buttonExternal","values":[true]}]]}]},"properties":{"id":{"type":"string","pattern":"^[a-zA-Z0-9_-]+$","description":"Stable element id. Avoid spaces and reserved ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.5.id","typeLabel":"string"},"type":{"type":"string","enum":["cta"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.5.type","typeLabel":"enum\u003cstring>"},"headline":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.5.headline.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.5.headline","typeLabel":"object"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.5.required","typeLabel":"boolean"},"subheader":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.5.subheader.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.5.subheader","typeLabel":"object"},"imageUrl":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.5.imageUrl","typeLabel":"string"},"imageAltText":{"type":"object","description":"Text alternative for `imageUrl`, read by screen readers. Omit or leave empty for a decorative image (rendered as `alt=\"\"`).","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.5.imageAltText.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.5.imageAltText","typeLabel":"object"},"videoUrl":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.5.videoUrl","typeLabel":"string"},"isDraft":{"type":"boolean","description":"Draft marker used by the editor and future update rules.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.5.isDraft","typeLabel":"boolean"},"showIf":{"type":"object","description":"Show-if: the element is shown only when this condition group matches, re-evaluated live as answers above it on the same page change. A hidden element is not validated (a hidden required element never blocks submission) and its answer is not submitted. Conditions use the same operands and operators as block `logic`. Reference rule: an element's show-if may use answers from earlier blocks and from elements above it in the same block, never itself or anything below it; a violation fails with `misordered_reference` at the exact condition path. Omit it, or send an empty group, for an element that is always shown.","required":["id","connector","conditions"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.5.showIf.id","typeLabel":"string\u003ccuid2>"},"connector":{"type":"string","enum":["and","or"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.5.showIf.connector","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","items":{"oneOf":[{"type":"object","description":"Single condition. Operators such as `isSubmitted`, `isSkipped`, `isClicked`, `isAccepted`,\n`isBooked`, `isSet`, and `isEmpty` do not use `rightOperand`; comparison operators do.\n","required":["id","leftOperand","operator"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.5.showIf.conditions.items.[INDEX].oneOf.0.id","typeLabel":"string\u003ccuid2>"},"leftOperand":{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.5.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.5.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.5.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.5.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.5.showIf.conditions.items.[INDEX].oneOf.0.leftOperand","typeLabel":"object"},"operator":{"type":"string","enum":["equals","doesNotEqual","contains","doesNotContain","startsWith","doesNotStartWith","endsWith","doesNotEndWith","isSubmitted","isSkipped","isGreaterThan","isLessThan","isGreaterThanOrEqual","isLessThanOrEqual","equalsOneOf","includesAllOf","includesOneOf","doesNotIncludeOneOf","doesNotIncludeAllOf","isClicked","isNotClicked","isAccepted","isBefore","isAfter","isBooked","isPartiallySubmitted","isCompletelySubmitted","isSet","isNotSet","isEmpty","isNotEmpty","isAnyOf"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.5.showIf.conditions.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"rightOperand":{"oneOf":[{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.5.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.5.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.5.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.1","typeLabel":"number"},{"type":"array","items":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.5.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.5.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.5.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value","typeLabel":"string | number | string[]"},"columnId":{"type":"string","minLength":1,"description":"On a matrix row condition, the id of the column. Read before `value` and wins when the two disagree, so the condition survives reordering. Must be a column of the matrix. Optional: when only `value` is sent, the id is filled in from the position on write.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.5.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnId","typeLabel":"string"},"columnIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.5.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition with `isAnyOf`, the ids of the columns `value` lists. Read before `value`, like `columnId`.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.5.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.5.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0","typeLabel":"object"},{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.5.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.5.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.5.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.5.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.5.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1","typeLabel":"object"}],"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.5.showIf.conditions.items.[INDEX].oneOf.0.rightOperand","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.5.showIf.conditions.items.[INDEX].oneOf.0","typeLabel":"object"},{}],"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.5.showIf.conditions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.5.showIf.conditions","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.5.showIf","typeLabel":"object"},"buttonExternal":{"type":"boolean","default":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.5.buttonExternal","typeLabel":"boolean"},"buttonUrl":{"type":"string","conditionalRequirements":[{"when":[[{"property":"buttonExternal","values":[true]}]]}],"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.5.buttonUrl","typeLabel":"string"},"ctaButtonLabel":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.5.ctaButtonLabel.additionalProperties","typeLabel":"string"},"conditionalRequirements":[{"when":[[{"property":"buttonExternal","values":[true]}]]}],"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.5.ctaButtonLabel","typeLabel":"object"}},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.5","typeLabel":"object"},{"type":"object","description":"Survey element/question inside a block. Element ids are stable public identifiers used by\nlogic, recall strings, response data, quotas, integrations, and analysis. `type` selects the\nallowed shape; unsupported fields are rejected instead of ignored.\n","required":["scale","range","id","type","headline","required"],"properties":{"id":{"type":"string","pattern":"^[a-zA-Z0-9_-]+$","description":"Stable element id. Avoid spaces and reserved ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.6.id","typeLabel":"string"},"type":{"type":"string","enum":["rating"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.6.type","typeLabel":"enum\u003cstring>"},"headline":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.6.headline.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.6.headline","typeLabel":"object"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.6.required","typeLabel":"boolean"},"scale":{"type":"string","enum":["number","smiley","star"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.6.scale","typeLabel":"enum\u003cstring>"},"range":{"type":"integer","enum":[3,4,5,6,7,10],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.6.range","typeLabel":"enum\u003cinteger>"},"subheader":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.6.subheader.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.6.subheader","typeLabel":"object"},"imageUrl":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.6.imageUrl","typeLabel":"string"},"imageAltText":{"type":"object","description":"Text alternative for `imageUrl`, read by screen readers. Omit or leave empty for a decorative image (rendered as `alt=\"\"`).","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.6.imageAltText.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.6.imageAltText","typeLabel":"object"},"videoUrl":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.6.videoUrl","typeLabel":"string"},"isDraft":{"type":"boolean","description":"Draft marker used by the editor and future update rules.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.6.isDraft","typeLabel":"boolean"},"showIf":{"type":"object","description":"Show-if: the element is shown only when this condition group matches, re-evaluated live as answers above it on the same page change. A hidden element is not validated (a hidden required element never blocks submission) and its answer is not submitted. Conditions use the same operands and operators as block `logic`. Reference rule: an element's show-if may use answers from earlier blocks and from elements above it in the same block, never itself or anything below it; a violation fails with `misordered_reference` at the exact condition path. Omit it, or send an empty group, for an element that is always shown.","required":["id","connector","conditions"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.6.showIf.id","typeLabel":"string\u003ccuid2>"},"connector":{"type":"string","enum":["and","or"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.6.showIf.connector","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","items":{"oneOf":[{"type":"object","description":"Single condition. Operators such as `isSubmitted`, `isSkipped`, `isClicked`, `isAccepted`,\n`isBooked`, `isSet`, and `isEmpty` do not use `rightOperand`; comparison operators do.\n","required":["id","leftOperand","operator"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.6.showIf.conditions.items.[INDEX].oneOf.0.id","typeLabel":"string\u003ccuid2>"},"leftOperand":{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.6.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.6.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.6.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.6.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.6.showIf.conditions.items.[INDEX].oneOf.0.leftOperand","typeLabel":"object"},"operator":{"type":"string","enum":["equals","doesNotEqual","contains","doesNotContain","startsWith","doesNotStartWith","endsWith","doesNotEndWith","isSubmitted","isSkipped","isGreaterThan","isLessThan","isGreaterThanOrEqual","isLessThanOrEqual","equalsOneOf","includesAllOf","includesOneOf","doesNotIncludeOneOf","doesNotIncludeAllOf","isClicked","isNotClicked","isAccepted","isBefore","isAfter","isBooked","isPartiallySubmitted","isCompletelySubmitted","isSet","isNotSet","isEmpty","isNotEmpty","isAnyOf"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.6.showIf.conditions.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"rightOperand":{"oneOf":[{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.6.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.6.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.6.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.1","typeLabel":"number"},{"type":"array","items":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.6.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.6.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.6.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value","typeLabel":"string | number | string[]"},"columnId":{"type":"string","minLength":1,"description":"On a matrix row condition, the id of the column. Read before `value` and wins when the two disagree, so the condition survives reordering. Must be a column of the matrix. Optional: when only `value` is sent, the id is filled in from the position on write.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.6.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnId","typeLabel":"string"},"columnIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.6.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition with `isAnyOf`, the ids of the columns `value` lists. Read before `value`, like `columnId`.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.6.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.6.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0","typeLabel":"object"},{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.6.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.6.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.6.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.6.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.6.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1","typeLabel":"object"}],"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.6.showIf.conditions.items.[INDEX].oneOf.0.rightOperand","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.6.showIf.conditions.items.[INDEX].oneOf.0","typeLabel":"object"},{}],"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.6.showIf.conditions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.6.showIf.conditions","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.6.showIf","typeLabel":"object"},"code":{"type":"string","maxLength":30,"pattern":"^[a-z][a-z0-9_]*$","description":"Question code, the name the question carries in exports, webhooks and links. Optional. Starts with a lowercase letter, then lowercase letters, digits and `_`; no `__`, no trailing `_`, at most 30 characters. It must not be an SPSS reserved word (`all`, `and`, `by`, `eq`, `ge`, `gt`, `le`, `lt`, `ne`, `not`, `or`, `to`, `with`) or an export column name (`response_id`, `language`, `outcome`, ...), and must be unique among the survey's question codes, Embedded Data names and the Question IDs of other questions, ignoring case. CTA elements have no code.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.6.code","typeLabel":"string"},"lowerLabel":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.6.lowerLabel.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.6.lowerLabel","typeLabel":"object"},"upperLabel":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.6.upperLabel.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.6.upperLabel","typeLabel":"object"},"isColorCodingEnabled":{"type":"boolean","default":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.6.isColorCodingEnabled","typeLabel":"boolean"}},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.6","typeLabel":"object"},{"type":"object","description":"Survey element/question inside a block. Element ids are stable public identifiers used by\nlogic, recall strings, response data, quotas, integrations, and analysis. `type` selects the\nallowed shape; unsupported fields are rejected instead of ignored.\n","required":["choices","id","type","headline","required"],"properties":{"id":{"type":"string","pattern":"^[a-zA-Z0-9_-]+$","description":"Stable element id. Avoid spaces and reserved ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.id","typeLabel":"string"},"type":{"type":"string","enum":["pictureSelection"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.type","typeLabel":"enum\u003cstring>"},"headline":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.headline.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.headline","typeLabel":"object"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.required","typeLabel":"boolean"},"choices":{"type":"array","minItems":2,"items":{"type":"object","required":["id","imageUrl"],"properties":{"id":{"type":"string","description":"Stable picture choice id.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.choices.items.[INDEX].id","typeLabel":"string"},"imageUrl":{"type":"string","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.choices.items.[INDEX].imageUrl","typeLabel":"string"},"code":{"type":"string","maxLength":20,"pattern":"^[a-z0-9][a-z0-9_]*$","description":"Answer code of an option, a matrix row or a matrix column. Optional. Lowercase letters, digits and `_`; it may start with a digit, but not with `_`; no `__`, no trailing `_`, at most 20 characters. It must not be an SPSS reserved word or an export column name, and must be unique within its question (a matrix's rows and columns are checked separately), ignoring case.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.choices.items.[INDEX].code","typeLabel":"string"},"imageAltText":{"type":"object","description":"Text alternative for `imageUrl`, read by screen readers. Omit or leave empty to fall back to the positional label (\"Option 1\", \"Option 2\", …); a choice image is never decorative, since the respondent selects it.","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.choices.items.[INDEX].imageAltText.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.choices.items.[INDEX].imageAltText","typeLabel":"object"},"showIf":{"type":"object","description":"Option show-if: the option (or matrix row or column) is offered only when this condition group matches, re-evaluated live as earlier answers change. It may use what its element's show-if may use: answers from earlier blocks and from elements above its element in the same block, never its own element or anything below (`misordered_reference` at the exact condition path). A question left with no option to offer is skipped and recorded as not shown. Omit it, or send an empty group, for an option that is always offered. Allowed on published surveys.","required":["id","connector","conditions"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf.id","typeLabel":"string\u003ccuid2>"},"connector":{"type":"string","enum":["and","or"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf.connector","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","items":{"oneOf":[{"type":"object","description":"Single condition. Operators such as `isSubmitted`, `isSkipped`, `isClicked`, `isAccepted`,\n`isBooked`, `isSet`, and `isEmpty` do not use `rightOperand`; comparison operators do.\n","required":["id","leftOperand","operator"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.id","typeLabel":"string\u003ccuid2>"},"leftOperand":{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand","typeLabel":"object"},"operator":{"type":"string","enum":["equals","doesNotEqual","contains","doesNotContain","startsWith","doesNotStartWith","endsWith","doesNotEndWith","isSubmitted","isSkipped","isGreaterThan","isLessThan","isGreaterThanOrEqual","isLessThanOrEqual","equalsOneOf","includesAllOf","includesOneOf","doesNotIncludeOneOf","doesNotIncludeAllOf","isClicked","isNotClicked","isAccepted","isBefore","isAfter","isBooked","isPartiallySubmitted","isCompletelySubmitted","isSet","isNotSet","isEmpty","isNotEmpty","isAnyOf"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"rightOperand":{"oneOf":[{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.1","typeLabel":"number"},{"type":"array","items":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value","typeLabel":"string | number | string[]"},"columnId":{"type":"string","minLength":1,"description":"On a matrix row condition, the id of the column. Read before `value` and wins when the two disagree, so the condition survives reordering. Must be a column of the matrix. Optional: when only `value` is sent, the id is filled in from the position on write.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnId","typeLabel":"string"},"columnIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition with `isAnyOf`, the ids of the columns `value` lists. Read before `value`, like `columnId`.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0","typeLabel":"object"},{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1","typeLabel":"object"}],"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0","typeLabel":"object"},{}],"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf.conditions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf.conditions","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf","typeLabel":"object"},"hidden":{"type":"boolean","description":"Hidden: the option is never offered, whatever its `showIf` says, and is recorded as not shown. Use it to retire an option on a published survey instead of deleting it (deleting an option that existed at launch is refused): it keeps its id, answer code and earlier answers, and stays in results labelled Hidden.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.choices.items.[INDEX].hidden","typeLabel":"boolean"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.choices.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.choices","typeLabel":"object[]"},"subheader":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.subheader.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.subheader","typeLabel":"object"},"imageUrl":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.imageUrl","typeLabel":"string"},"imageAltText":{"type":"object","description":"Text alternative for `imageUrl`, read by screen readers. Omit or leave empty for a decorative image (rendered as `alt=\"\"`).","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.imageAltText.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.imageAltText","typeLabel":"object"},"videoUrl":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.videoUrl","typeLabel":"string"},"isDraft":{"type":"boolean","description":"Draft marker used by the editor and future update rules.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.isDraft","typeLabel":"boolean"},"showIf":{"type":"object","description":"Show-if: the element is shown only when this condition group matches, re-evaluated live as answers above it on the same page change. A hidden element is not validated (a hidden required element never blocks submission) and its answer is not submitted. Conditions use the same operands and operators as block `logic`. Reference rule: an element's show-if may use answers from earlier blocks and from elements above it in the same block, never itself or anything below it; a violation fails with `misordered_reference` at the exact condition path. Omit it, or send an empty group, for an element that is always shown.","required":["id","connector","conditions"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.showIf.id","typeLabel":"string\u003ccuid2>"},"connector":{"type":"string","enum":["and","or"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.showIf.connector","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","items":{"oneOf":[{"type":"object","description":"Single condition. Operators such as `isSubmitted`, `isSkipped`, `isClicked`, `isAccepted`,\n`isBooked`, `isSet`, and `isEmpty` do not use `rightOperand`; comparison operators do.\n","required":["id","leftOperand","operator"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.showIf.conditions.items.[INDEX].oneOf.0.id","typeLabel":"string\u003ccuid2>"},"leftOperand":{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.showIf.conditions.items.[INDEX].oneOf.0.leftOperand","typeLabel":"object"},"operator":{"type":"string","enum":["equals","doesNotEqual","contains","doesNotContain","startsWith","doesNotStartWith","endsWith","doesNotEndWith","isSubmitted","isSkipped","isGreaterThan","isLessThan","isGreaterThanOrEqual","isLessThanOrEqual","equalsOneOf","includesAllOf","includesOneOf","doesNotIncludeOneOf","doesNotIncludeAllOf","isClicked","isNotClicked","isAccepted","isBefore","isAfter","isBooked","isPartiallySubmitted","isCompletelySubmitted","isSet","isNotSet","isEmpty","isNotEmpty","isAnyOf"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.showIf.conditions.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"rightOperand":{"oneOf":[{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.1","typeLabel":"number"},{"type":"array","items":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value","typeLabel":"string | number | string[]"},"columnId":{"type":"string","minLength":1,"description":"On a matrix row condition, the id of the column. Read before `value` and wins when the two disagree, so the condition survives reordering. Must be a column of the matrix. Optional: when only `value` is sent, the id is filled in from the position on write.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnId","typeLabel":"string"},"columnIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition with `isAnyOf`, the ids of the columns `value` lists. Read before `value`, like `columnId`.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0","typeLabel":"object"},{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1","typeLabel":"object"}],"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.showIf.conditions.items.[INDEX].oneOf.0.rightOperand","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.showIf.conditions.items.[INDEX].oneOf.0","typeLabel":"object"},{}],"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.showIf.conditions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.showIf.conditions","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.showIf","typeLabel":"object"},"code":{"type":"string","maxLength":30,"pattern":"^[a-z][a-z0-9_]*$","description":"Question code, the name the question carries in exports, webhooks and links. Optional. Starts with a lowercase letter, then lowercase letters, digits and `_`; no `__`, no trailing `_`, at most 30 characters. It must not be an SPSS reserved word (`all`, `and`, `by`, `eq`, `ge`, `gt`, `le`, `lt`, `ne`, `not`, `or`, `to`, `with`) or an export column name (`response_id`, `language`, `outcome`, ...), and must be unique among the survey's question codes, Embedded Data names and the Question IDs of other questions, ignoring case. CTA elements have no code.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.code","typeLabel":"string"},"allowMulti":{"type":"boolean","default":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.allowMulti","typeLabel":"boolean"},"optionsCopiedFrom":{"type":"string","minLength":1,"description":"Copied options: the id of an earlier element whose options this element copies (\"only the brands you know\"). Choices copy from a single select, multi select or ranking; pictures from a picture selection (matrix rows are not copied: give rows a `showIf` on the source instead). Write the copies yourself: each copied option keeps the source option's `id` and `code`, and carries a `showIf` \"picked in the source\" (`includesOneOf` with its own id, or `equals` when the source is a single select), so the element offers exactly the options picked there. Copied codes follow the source's: a code sent for a copy is replaced by the source option's. Fixed options next to the copies (such as \"None of these\", id `none`) get the next code free in every linked element. The source must exist (`dangling_reference`), sit in an earlier block or above this element on its block (`misordered_reference`), and have options of the same kind (`invalid_reference`). To bring in options the source gained later, add them the same way.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.optionsCopiedFrom","typeLabel":"string"},"validation":{"type":"object","description":"Optional element-level validation rules.","required":["rules"],"properties":{"rules":{"type":"array","items":{"type":"object","required":["id","type","params"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.validation.rules.items.[INDEX].id","typeLabel":"string"},"type":{"type":"string","enum":["minLength","maxLength","pattern","email","url","phone","equals","doesNotEqual","contains","doesNotContain","minValue","maxValue","isGreaterThan","isLessThan","minSelections","maxSelections","minRanked","rankAll","minRowsAnswered","answerAllRows","isLaterThan","isEarlierThan","isBetween","isNotBetween","fileExtensionIs","fileExtensionIsNot"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.validation.rules.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"params":{"type":"object","additionalProperties":true,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.validation.rules.items.[INDEX].params","typeLabel":"object"},"field":{"type":"string","enum":["addressLine1","addressLine2","city","state","zip","country","firstName","lastName","email","phone","company"],"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.validation.rules.items.[INDEX].field","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.validation.rules.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.validation.rules","typeLabel":"object[]"},"logic":{"type":"string","enum":["and","or"],"default":"and","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.validation.logic","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7.validation","typeLabel":"object"}},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.7","typeLabel":"object"},{"type":"object","description":"Survey element/question inside a block. Element ids are stable public identifiers used by\nlogic, recall strings, response data, quotas, integrations, and analysis. `type` selects the\nallowed shape; unsupported fields are rejected instead of ignored.\n","required":["format","id","type","headline","required"],"properties":{"id":{"type":"string","pattern":"^[a-zA-Z0-9_-]+$","description":"Stable element id. Avoid spaces and reserved ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.8.id","typeLabel":"string"},"type":{"type":"string","enum":["date"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.8.type","typeLabel":"enum\u003cstring>"},"headline":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.8.headline.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.8.headline","typeLabel":"object"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.8.required","typeLabel":"boolean"},"format":{"type":"string","enum":["M-d-y","d-M-y","y-M-d"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.8.format","typeLabel":"enum\u003cstring>"},"subheader":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.8.subheader.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.8.subheader","typeLabel":"object"},"imageUrl":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.8.imageUrl","typeLabel":"string"},"imageAltText":{"type":"object","description":"Text alternative for `imageUrl`, read by screen readers. Omit or leave empty for a decorative image (rendered as `alt=\"\"`).","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.8.imageAltText.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.8.imageAltText","typeLabel":"object"},"videoUrl":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.8.videoUrl","typeLabel":"string"},"isDraft":{"type":"boolean","description":"Draft marker used by the editor and future update rules.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.8.isDraft","typeLabel":"boolean"},"showIf":{"type":"object","description":"Show-if: the element is shown only when this condition group matches, re-evaluated live as answers above it on the same page change. A hidden element is not validated (a hidden required element never blocks submission) and its answer is not submitted. Conditions use the same operands and operators as block `logic`. Reference rule: an element's show-if may use answers from earlier blocks and from elements above it in the same block, never itself or anything below it; a violation fails with `misordered_reference` at the exact condition path. Omit it, or send an empty group, for an element that is always shown.","required":["id","connector","conditions"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.8.showIf.id","typeLabel":"string\u003ccuid2>"},"connector":{"type":"string","enum":["and","or"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.8.showIf.connector","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","items":{"oneOf":[{"type":"object","description":"Single condition. Operators such as `isSubmitted`, `isSkipped`, `isClicked`, `isAccepted`,\n`isBooked`, `isSet`, and `isEmpty` do not use `rightOperand`; comparison operators do.\n","required":["id","leftOperand","operator"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.8.showIf.conditions.items.[INDEX].oneOf.0.id","typeLabel":"string\u003ccuid2>"},"leftOperand":{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.8.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.8.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.8.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.8.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.8.showIf.conditions.items.[INDEX].oneOf.0.leftOperand","typeLabel":"object"},"operator":{"type":"string","enum":["equals","doesNotEqual","contains","doesNotContain","startsWith","doesNotStartWith","endsWith","doesNotEndWith","isSubmitted","isSkipped","isGreaterThan","isLessThan","isGreaterThanOrEqual","isLessThanOrEqual","equalsOneOf","includesAllOf","includesOneOf","doesNotIncludeOneOf","doesNotIncludeAllOf","isClicked","isNotClicked","isAccepted","isBefore","isAfter","isBooked","isPartiallySubmitted","isCompletelySubmitted","isSet","isNotSet","isEmpty","isNotEmpty","isAnyOf"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.8.showIf.conditions.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"rightOperand":{"oneOf":[{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.8.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.8.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.8.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.1","typeLabel":"number"},{"type":"array","items":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.8.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.8.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.8.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value","typeLabel":"string | number | string[]"},"columnId":{"type":"string","minLength":1,"description":"On a matrix row condition, the id of the column. Read before `value` and wins when the two disagree, so the condition survives reordering. Must be a column of the matrix. Optional: when only `value` is sent, the id is filled in from the position on write.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.8.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnId","typeLabel":"string"},"columnIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.8.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition with `isAnyOf`, the ids of the columns `value` lists. Read before `value`, like `columnId`.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.8.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.8.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0","typeLabel":"object"},{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.8.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.8.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.8.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.8.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.8.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1","typeLabel":"object"}],"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.8.showIf.conditions.items.[INDEX].oneOf.0.rightOperand","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.8.showIf.conditions.items.[INDEX].oneOf.0","typeLabel":"object"},{}],"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.8.showIf.conditions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.8.showIf.conditions","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.8.showIf","typeLabel":"object"},"code":{"type":"string","maxLength":30,"pattern":"^[a-z][a-z0-9_]*$","description":"Question code, the name the question carries in exports, webhooks and links. Optional. Starts with a lowercase letter, then lowercase letters, digits and `_`; no `__`, no trailing `_`, at most 30 characters. It must not be an SPSS reserved word (`all`, `and`, `by`, `eq`, `ge`, `gt`, `le`, `lt`, `ne`, `not`, `or`, `to`, `with`) or an export column name (`response_id`, `language`, `outcome`, ...), and must be unique among the survey's question codes, Embedded Data names and the Question IDs of other questions, ignoring case. CTA elements have no code.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.8.code","typeLabel":"string"},"html":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.8.html.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.8.html","typeLabel":"object"},"validation":{"type":"object","description":"Optional element-level validation rules.","required":["rules"],"properties":{"rules":{"type":"array","items":{"type":"object","required":["id","type","params"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.8.validation.rules.items.[INDEX].id","typeLabel":"string"},"type":{"type":"string","enum":["minLength","maxLength","pattern","email","url","phone","equals","doesNotEqual","contains","doesNotContain","minValue","maxValue","isGreaterThan","isLessThan","minSelections","maxSelections","minRanked","rankAll","minRowsAnswered","answerAllRows","isLaterThan","isEarlierThan","isBetween","isNotBetween","fileExtensionIs","fileExtensionIsNot"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.8.validation.rules.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"params":{"type":"object","additionalProperties":true,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.8.validation.rules.items.[INDEX].params","typeLabel":"object"},"field":{"type":"string","enum":["addressLine1","addressLine2","city","state","zip","country","firstName","lastName","email","phone","company"],"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.8.validation.rules.items.[INDEX].field","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.8.validation.rules.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.8.validation.rules","typeLabel":"object[]"},"logic":{"type":"string","enum":["and","or"],"default":"and","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.8.validation.logic","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.8.validation","typeLabel":"object"}},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.8","typeLabel":"object"},{"type":"object","description":"Survey element/question inside a block. Element ids are stable public identifiers used by\nlogic, recall strings, response data, quotas, integrations, and analysis. `type` selects the\nallowed shape; unsupported fields are rejected instead of ignored.\n","required":["allowMultipleFiles","id","type","headline","required"],"properties":{"id":{"type":"string","pattern":"^[a-zA-Z0-9_-]+$","description":"Stable element id. Avoid spaces and reserved ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.9.id","typeLabel":"string"},"type":{"type":"string","enum":["fileUpload"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.9.type","typeLabel":"enum\u003cstring>"},"headline":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.9.headline.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.9.headline","typeLabel":"object"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.9.required","typeLabel":"boolean"},"allowMultipleFiles":{"type":"boolean","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.9.allowMultipleFiles","typeLabel":"boolean"},"subheader":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.9.subheader.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.9.subheader","typeLabel":"object"},"imageUrl":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.9.imageUrl","typeLabel":"string"},"imageAltText":{"type":"object","description":"Text alternative for `imageUrl`, read by screen readers. Omit or leave empty for a decorative image (rendered as `alt=\"\"`).","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.9.imageAltText.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.9.imageAltText","typeLabel":"object"},"videoUrl":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.9.videoUrl","typeLabel":"string"},"isDraft":{"type":"boolean","description":"Draft marker used by the editor and future update rules.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.9.isDraft","typeLabel":"boolean"},"showIf":{"type":"object","description":"Show-if: the element is shown only when this condition group matches, re-evaluated live as answers above it on the same page change. A hidden element is not validated (a hidden required element never blocks submission) and its answer is not submitted. Conditions use the same operands and operators as block `logic`. Reference rule: an element's show-if may use answers from earlier blocks and from elements above it in the same block, never itself or anything below it; a violation fails with `misordered_reference` at the exact condition path. Omit it, or send an empty group, for an element that is always shown.","required":["id","connector","conditions"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.9.showIf.id","typeLabel":"string\u003ccuid2>"},"connector":{"type":"string","enum":["and","or"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.9.showIf.connector","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","items":{"oneOf":[{"type":"object","description":"Single condition. Operators such as `isSubmitted`, `isSkipped`, `isClicked`, `isAccepted`,\n`isBooked`, `isSet`, and `isEmpty` do not use `rightOperand`; comparison operators do.\n","required":["id","leftOperand","operator"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.9.showIf.conditions.items.[INDEX].oneOf.0.id","typeLabel":"string\u003ccuid2>"},"leftOperand":{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.9.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.9.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.9.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.9.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.9.showIf.conditions.items.[INDEX].oneOf.0.leftOperand","typeLabel":"object"},"operator":{"type":"string","enum":["equals","doesNotEqual","contains","doesNotContain","startsWith","doesNotStartWith","endsWith","doesNotEndWith","isSubmitted","isSkipped","isGreaterThan","isLessThan","isGreaterThanOrEqual","isLessThanOrEqual","equalsOneOf","includesAllOf","includesOneOf","doesNotIncludeOneOf","doesNotIncludeAllOf","isClicked","isNotClicked","isAccepted","isBefore","isAfter","isBooked","isPartiallySubmitted","isCompletelySubmitted","isSet","isNotSet","isEmpty","isNotEmpty","isAnyOf"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.9.showIf.conditions.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"rightOperand":{"oneOf":[{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.9.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.9.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.9.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.1","typeLabel":"number"},{"type":"array","items":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.9.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.9.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.9.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value","typeLabel":"string | number | string[]"},"columnId":{"type":"string","minLength":1,"description":"On a matrix row condition, the id of the column. Read before `value` and wins when the two disagree, so the condition survives reordering. Must be a column of the matrix. Optional: when only `value` is sent, the id is filled in from the position on write.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.9.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnId","typeLabel":"string"},"columnIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.9.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition with `isAnyOf`, the ids of the columns `value` lists. Read before `value`, like `columnId`.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.9.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.9.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0","typeLabel":"object"},{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.9.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.9.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.9.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.9.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.9.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1","typeLabel":"object"}],"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.9.showIf.conditions.items.[INDEX].oneOf.0.rightOperand","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.9.showIf.conditions.items.[INDEX].oneOf.0","typeLabel":"object"},{}],"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.9.showIf.conditions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.9.showIf.conditions","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.9.showIf","typeLabel":"object"},"code":{"type":"string","maxLength":30,"pattern":"^[a-z][a-z0-9_]*$","description":"Question code, the name the question carries in exports, webhooks and links. Optional. Starts with a lowercase letter, then lowercase letters, digits and `_`; no `__`, no trailing `_`, at most 30 characters. It must not be an SPSS reserved word (`all`, `and`, `by`, `eq`, `ge`, `gt`, `le`, `lt`, `ne`, `not`, `or`, `to`, `with`) or an export column name (`response_id`, `language`, `outcome`, ...), and must be unique among the survey's question codes, Embedded Data names and the Question IDs of other questions, ignoring case. CTA elements have no code.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.9.code","typeLabel":"string"},"maxSizeInMB":{"type":"number","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.9.maxSizeInMB","typeLabel":"number"},"allowedFileExtensions":{"type":"array","items":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.9.allowedFileExtensions.items.[INDEX]","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.9.allowedFileExtensions","typeLabel":"string[]"},"validation":{"type":"object","description":"Optional element-level validation rules.","required":["rules"],"properties":{"rules":{"type":"array","items":{"type":"object","required":["id","type","params"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.9.validation.rules.items.[INDEX].id","typeLabel":"string"},"type":{"type":"string","enum":["minLength","maxLength","pattern","email","url","phone","equals","doesNotEqual","contains","doesNotContain","minValue","maxValue","isGreaterThan","isLessThan","minSelections","maxSelections","minRanked","rankAll","minRowsAnswered","answerAllRows","isLaterThan","isEarlierThan","isBetween","isNotBetween","fileExtensionIs","fileExtensionIsNot"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.9.validation.rules.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"params":{"type":"object","additionalProperties":true,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.9.validation.rules.items.[INDEX].params","typeLabel":"object"},"field":{"type":"string","enum":["addressLine1","addressLine2","city","state","zip","country","firstName","lastName","email","phone","company"],"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.9.validation.rules.items.[INDEX].field","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.9.validation.rules.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.9.validation.rules","typeLabel":"object[]"},"logic":{"type":"string","enum":["and","or"],"default":"and","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.9.validation.logic","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.9.validation","typeLabel":"object"}},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.9","typeLabel":"object"},{"type":"object","description":"Survey element/question inside a block. Element ids are stable public identifiers used by\nlogic, recall strings, response data, quotas, integrations, and analysis. `type` selects the\nallowed shape; unsupported fields are rejected instead of ignored.\n","required":["calUserName","id","type","headline","required"],"properties":{"id":{"type":"string","pattern":"^[a-zA-Z0-9_-]+$","description":"Stable element id. Avoid spaces and reserved ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.10.id","typeLabel":"string"},"type":{"type":"string","enum":["cal"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.10.type","typeLabel":"enum\u003cstring>"},"headline":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.10.headline.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.10.headline","typeLabel":"object"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.10.required","typeLabel":"boolean"},"calUserName":{"type":"string","minLength":1,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.10.calUserName","typeLabel":"string"},"subheader":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.10.subheader.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.10.subheader","typeLabel":"object"},"imageUrl":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.10.imageUrl","typeLabel":"string"},"imageAltText":{"type":"object","description":"Text alternative for `imageUrl`, read by screen readers. Omit or leave empty for a decorative image (rendered as `alt=\"\"`).","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.10.imageAltText.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.10.imageAltText","typeLabel":"object"},"videoUrl":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.10.videoUrl","typeLabel":"string"},"isDraft":{"type":"boolean","description":"Draft marker used by the editor and future update rules.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.10.isDraft","typeLabel":"boolean"},"showIf":{"type":"object","description":"Show-if: the element is shown only when this condition group matches, re-evaluated live as answers above it on the same page change. A hidden element is not validated (a hidden required element never blocks submission) and its answer is not submitted. Conditions use the same operands and operators as block `logic`. Reference rule: an element's show-if may use answers from earlier blocks and from elements above it in the same block, never itself or anything below it; a violation fails with `misordered_reference` at the exact condition path. Omit it, or send an empty group, for an element that is always shown.","required":["id","connector","conditions"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.10.showIf.id","typeLabel":"string\u003ccuid2>"},"connector":{"type":"string","enum":["and","or"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.10.showIf.connector","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","items":{"oneOf":[{"type":"object","description":"Single condition. Operators such as `isSubmitted`, `isSkipped`, `isClicked`, `isAccepted`,\n`isBooked`, `isSet`, and `isEmpty` do not use `rightOperand`; comparison operators do.\n","required":["id","leftOperand","operator"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.10.showIf.conditions.items.[INDEX].oneOf.0.id","typeLabel":"string\u003ccuid2>"},"leftOperand":{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.10.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.10.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.10.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.10.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.10.showIf.conditions.items.[INDEX].oneOf.0.leftOperand","typeLabel":"object"},"operator":{"type":"string","enum":["equals","doesNotEqual","contains","doesNotContain","startsWith","doesNotStartWith","endsWith","doesNotEndWith","isSubmitted","isSkipped","isGreaterThan","isLessThan","isGreaterThanOrEqual","isLessThanOrEqual","equalsOneOf","includesAllOf","includesOneOf","doesNotIncludeOneOf","doesNotIncludeAllOf","isClicked","isNotClicked","isAccepted","isBefore","isAfter","isBooked","isPartiallySubmitted","isCompletelySubmitted","isSet","isNotSet","isEmpty","isNotEmpty","isAnyOf"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.10.showIf.conditions.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"rightOperand":{"oneOf":[{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.10.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.10.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.10.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.1","typeLabel":"number"},{"type":"array","items":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.10.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.10.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.10.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value","typeLabel":"string | number | string[]"},"columnId":{"type":"string","minLength":1,"description":"On a matrix row condition, the id of the column. Read before `value` and wins when the two disagree, so the condition survives reordering. Must be a column of the matrix. Optional: when only `value` is sent, the id is filled in from the position on write.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.10.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnId","typeLabel":"string"},"columnIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.10.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition with `isAnyOf`, the ids of the columns `value` lists. Read before `value`, like `columnId`.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.10.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.10.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0","typeLabel":"object"},{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.10.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.10.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.10.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.10.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.10.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1","typeLabel":"object"}],"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.10.showIf.conditions.items.[INDEX].oneOf.0.rightOperand","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.10.showIf.conditions.items.[INDEX].oneOf.0","typeLabel":"object"},{}],"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.10.showIf.conditions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.10.showIf.conditions","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.10.showIf","typeLabel":"object"},"code":{"type":"string","maxLength":30,"pattern":"^[a-z][a-z0-9_]*$","description":"Question code, the name the question carries in exports, webhooks and links. Optional. Starts with a lowercase letter, then lowercase letters, digits and `_`; no `__`, no trailing `_`, at most 30 characters. It must not be an SPSS reserved word (`all`, `and`, `by`, `eq`, `ge`, `gt`, `le`, `lt`, `ne`, `not`, `or`, `to`, `with`) or an export column name (`response_id`, `language`, `outcome`, ...), and must be unique among the survey's question codes, Embedded Data names and the Question IDs of other questions, ignoring case. CTA elements have no code.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.10.code","typeLabel":"string"},"calHost":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.10.calHost","typeLabel":"string"}},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.10","typeLabel":"object"},{"type":"object","description":"Survey element/question inside a block. Element ids are stable public identifiers used by\nlogic, recall strings, response data, quotas, integrations, and analysis. `type` selects the\nallowed shape; unsupported fields are rejected instead of ignored.\n","required":["rows","columns","id","type","headline","required"],"properties":{"id":{"type":"string","pattern":"^[a-zA-Z0-9_-]+$","description":"Stable element id. Avoid spaces and reserved ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.id","typeLabel":"string"},"type":{"type":"string","enum":["matrix"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.type","typeLabel":"enum\u003cstring>"},"headline":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.headline.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.headline","typeLabel":"object"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.required","typeLabel":"boolean"},"rows":{"type":"array","items":{"type":"object","required":["id","label"],"properties":{"id":{"type":"string","description":"Stable choice id.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.rows.items.[INDEX].id","typeLabel":"string"},"label":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.rows.items.[INDEX].label.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.rows.items.[INDEX].label","typeLabel":"object"},"code":{"type":"string","maxLength":20,"pattern":"^[a-z0-9][a-z0-9_]*$","description":"Answer code of an option, a matrix row or a matrix column. Optional. Lowercase letters, digits and `_`; it may start with a digit, but not with `_`; no `__`, no trailing `_`, at most 20 characters. It must not be an SPSS reserved word or an export column name, and must be unique within its question (a matrix's rows and columns are checked separately), ignoring case.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.rows.items.[INDEX].code","typeLabel":"string"},"showIf":{"type":"object","description":"Option show-if: the option (or matrix row or column) is offered only when this condition group matches, re-evaluated live as earlier answers change. It may use what its element's show-if may use: answers from earlier blocks and from elements above its element in the same block, never its own element or anything below (`misordered_reference` at the exact condition path). A question left with no option to offer is skipped and recorded as not shown. Omit it, or send an empty group, for an option that is always offered. Allowed on published surveys.","required":["id","connector","conditions"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf.id","typeLabel":"string\u003ccuid2>"},"connector":{"type":"string","enum":["and","or"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf.connector","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","items":{"oneOf":[{"type":"object","description":"Single condition. Operators such as `isSubmitted`, `isSkipped`, `isClicked`, `isAccepted`,\n`isBooked`, `isSet`, and `isEmpty` do not use `rightOperand`; comparison operators do.\n","required":["id","leftOperand","operator"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.id","typeLabel":"string\u003ccuid2>"},"leftOperand":{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand","typeLabel":"object"},"operator":{"type":"string","enum":["equals","doesNotEqual","contains","doesNotContain","startsWith","doesNotStartWith","endsWith","doesNotEndWith","isSubmitted","isSkipped","isGreaterThan","isLessThan","isGreaterThanOrEqual","isLessThanOrEqual","equalsOneOf","includesAllOf","includesOneOf","doesNotIncludeOneOf","doesNotIncludeAllOf","isClicked","isNotClicked","isAccepted","isBefore","isAfter","isBooked","isPartiallySubmitted","isCompletelySubmitted","isSet","isNotSet","isEmpty","isNotEmpty","isAnyOf"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"rightOperand":{"oneOf":[{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.1","typeLabel":"number"},{"type":"array","items":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value","typeLabel":"string | number | string[]"},"columnId":{"type":"string","minLength":1,"description":"On a matrix row condition, the id of the column. Read before `value` and wins when the two disagree, so the condition survives reordering. Must be a column of the matrix. Optional: when only `value` is sent, the id is filled in from the position on write.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnId","typeLabel":"string"},"columnIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition with `isAnyOf`, the ids of the columns `value` lists. Read before `value`, like `columnId`.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0","typeLabel":"object"},{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1","typeLabel":"object"}],"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0","typeLabel":"object"},{}],"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf.conditions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf.conditions","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf","typeLabel":"object"},"hidden":{"type":"boolean","description":"Hidden: the option is never offered, whatever its `showIf` says, and is recorded as not shown. Use it to retire an option on a published survey instead of deleting it (deleting an option that existed at launch is refused): it keeps its id, answer code and earlier answers, and stays in results labelled Hidden.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.rows.items.[INDEX].hidden","typeLabel":"boolean"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.rows.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.rows","typeLabel":"object[]"},"columns":{"type":"array","items":{"type":"object","required":["id","label"],"properties":{"id":{"type":"string","description":"Stable choice id.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.columns.items.[INDEX].id","typeLabel":"string"},"label":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.columns.items.[INDEX].label.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.columns.items.[INDEX].label","typeLabel":"object"},"code":{"type":"string","maxLength":20,"pattern":"^[a-z0-9][a-z0-9_]*$","description":"Answer code of an option, a matrix row or a matrix column. Optional. Lowercase letters, digits and `_`; it may start with a digit, but not with `_`; no `__`, no trailing `_`, at most 20 characters. It must not be an SPSS reserved word or an export column name, and must be unique within its question (a matrix's rows and columns are checked separately), ignoring case.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.columns.items.[INDEX].code","typeLabel":"string"},"showIf":{"type":"object","description":"Option show-if: the option (or matrix row or column) is offered only when this condition group matches, re-evaluated live as earlier answers change. It may use what its element's show-if may use: answers from earlier blocks and from elements above its element in the same block, never its own element or anything below (`misordered_reference` at the exact condition path). A question left with no option to offer is skipped and recorded as not shown. Omit it, or send an empty group, for an option that is always offered. Allowed on published surveys.","required":["id","connector","conditions"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf.id","typeLabel":"string\u003ccuid2>"},"connector":{"type":"string","enum":["and","or"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf.connector","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","items":{"oneOf":[{"type":"object","description":"Single condition. Operators such as `isSubmitted`, `isSkipped`, `isClicked`, `isAccepted`,\n`isBooked`, `isSet`, and `isEmpty` do not use `rightOperand`; comparison operators do.\n","required":["id","leftOperand","operator"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.id","typeLabel":"string\u003ccuid2>"},"leftOperand":{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand","typeLabel":"object"},"operator":{"type":"string","enum":["equals","doesNotEqual","contains","doesNotContain","startsWith","doesNotStartWith","endsWith","doesNotEndWith","isSubmitted","isSkipped","isGreaterThan","isLessThan","isGreaterThanOrEqual","isLessThanOrEqual","equalsOneOf","includesAllOf","includesOneOf","doesNotIncludeOneOf","doesNotIncludeAllOf","isClicked","isNotClicked","isAccepted","isBefore","isAfter","isBooked","isPartiallySubmitted","isCompletelySubmitted","isSet","isNotSet","isEmpty","isNotEmpty","isAnyOf"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"rightOperand":{"oneOf":[{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.1","typeLabel":"number"},{"type":"array","items":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value","typeLabel":"string | number | string[]"},"columnId":{"type":"string","minLength":1,"description":"On a matrix row condition, the id of the column. Read before `value` and wins when the two disagree, so the condition survives reordering. Must be a column of the matrix. Optional: when only `value` is sent, the id is filled in from the position on write.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnId","typeLabel":"string"},"columnIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition with `isAnyOf`, the ids of the columns `value` lists. Read before `value`, like `columnId`.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0","typeLabel":"object"},{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1","typeLabel":"object"}],"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0","typeLabel":"object"},{}],"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf.conditions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf.conditions","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf","typeLabel":"object"},"hidden":{"type":"boolean","description":"Hidden: the option is never offered, whatever its `showIf` says, and is recorded as not shown. Use it to retire an option on a published survey instead of deleting it (deleting an option that existed at launch is refused): it keeps its id, answer code and earlier answers, and stays in results labelled Hidden.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.columns.items.[INDEX].hidden","typeLabel":"boolean"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.columns.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.columns","typeLabel":"object[]"},"subheader":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.subheader.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.subheader","typeLabel":"object"},"imageUrl":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.imageUrl","typeLabel":"string"},"imageAltText":{"type":"object","description":"Text alternative for `imageUrl`, read by screen readers. Omit or leave empty for a decorative image (rendered as `alt=\"\"`).","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.imageAltText.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.imageAltText","typeLabel":"object"},"videoUrl":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.videoUrl","typeLabel":"string"},"isDraft":{"type":"boolean","description":"Draft marker used by the editor and future update rules.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.isDraft","typeLabel":"boolean"},"showIf":{"type":"object","description":"Show-if: the element is shown only when this condition group matches, re-evaluated live as answers above it on the same page change. A hidden element is not validated (a hidden required element never blocks submission) and its answer is not submitted. Conditions use the same operands and operators as block `logic`. Reference rule: an element's show-if may use answers from earlier blocks and from elements above it in the same block, never itself or anything below it; a violation fails with `misordered_reference` at the exact condition path. Omit it, or send an empty group, for an element that is always shown.","required":["id","connector","conditions"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.showIf.id","typeLabel":"string\u003ccuid2>"},"connector":{"type":"string","enum":["and","or"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.showIf.connector","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","items":{"oneOf":[{"type":"object","description":"Single condition. Operators such as `isSubmitted`, `isSkipped`, `isClicked`, `isAccepted`,\n`isBooked`, `isSet`, and `isEmpty` do not use `rightOperand`; comparison operators do.\n","required":["id","leftOperand","operator"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.showIf.conditions.items.[INDEX].oneOf.0.id","typeLabel":"string\u003ccuid2>"},"leftOperand":{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.showIf.conditions.items.[INDEX].oneOf.0.leftOperand","typeLabel":"object"},"operator":{"type":"string","enum":["equals","doesNotEqual","contains","doesNotContain","startsWith","doesNotStartWith","endsWith","doesNotEndWith","isSubmitted","isSkipped","isGreaterThan","isLessThan","isGreaterThanOrEqual","isLessThanOrEqual","equalsOneOf","includesAllOf","includesOneOf","doesNotIncludeOneOf","doesNotIncludeAllOf","isClicked","isNotClicked","isAccepted","isBefore","isAfter","isBooked","isPartiallySubmitted","isCompletelySubmitted","isSet","isNotSet","isEmpty","isNotEmpty","isAnyOf"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.showIf.conditions.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"rightOperand":{"oneOf":[{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.1","typeLabel":"number"},{"type":"array","items":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value","typeLabel":"string | number | string[]"},"columnId":{"type":"string","minLength":1,"description":"On a matrix row condition, the id of the column. Read before `value` and wins when the two disagree, so the condition survives reordering. Must be a column of the matrix. Optional: when only `value` is sent, the id is filled in from the position on write.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnId","typeLabel":"string"},"columnIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition with `isAnyOf`, the ids of the columns `value` lists. Read before `value`, like `columnId`.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0","typeLabel":"object"},{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1","typeLabel":"object"}],"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.showIf.conditions.items.[INDEX].oneOf.0.rightOperand","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.showIf.conditions.items.[INDEX].oneOf.0","typeLabel":"object"},{}],"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.showIf.conditions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.showIf.conditions","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.showIf","typeLabel":"object"},"code":{"type":"string","maxLength":30,"pattern":"^[a-z][a-z0-9_]*$","description":"Question code, the name the question carries in exports, webhooks and links. Optional. Starts with a lowercase letter, then lowercase letters, digits and `_`; no `__`, no trailing `_`, at most 30 characters. It must not be an SPSS reserved word (`all`, `and`, `by`, `eq`, `ge`, `gt`, `le`, `lt`, `ne`, `not`, `or`, `to`, `with`) or an export column name (`response_id`, `language`, `outcome`, ...), and must be unique among the survey's question codes, Embedded Data names and the Question IDs of other questions, ignoring case. CTA elements have no code.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.code","typeLabel":"string"},"shuffleOption":{"type":"string","enum":["none","all","exceptLast","reverseOrderOccasionally","reverseOrderExceptLast"],"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.shuffleOption","typeLabel":"enum\u003cstring>"},"validation":{"type":"object","description":"Optional element-level validation rules.","required":["rules"],"properties":{"rules":{"type":"array","items":{"type":"object","required":["id","type","params"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.validation.rules.items.[INDEX].id","typeLabel":"string"},"type":{"type":"string","enum":["minLength","maxLength","pattern","email","url","phone","equals","doesNotEqual","contains","doesNotContain","minValue","maxValue","isGreaterThan","isLessThan","minSelections","maxSelections","minRanked","rankAll","minRowsAnswered","answerAllRows","isLaterThan","isEarlierThan","isBetween","isNotBetween","fileExtensionIs","fileExtensionIsNot"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.validation.rules.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"params":{"type":"object","additionalProperties":true,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.validation.rules.items.[INDEX].params","typeLabel":"object"},"field":{"type":"string","enum":["addressLine1","addressLine2","city","state","zip","country","firstName","lastName","email","phone","company"],"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.validation.rules.items.[INDEX].field","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.validation.rules.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.validation.rules","typeLabel":"object[]"},"logic":{"type":"string","enum":["and","or"],"default":"and","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.validation.logic","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11.validation","typeLabel":"object"}},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.11","typeLabel":"object"},{"type":"object","description":"Survey element/question inside a block. Element ids are stable public identifiers used by\nlogic, recall strings, response data, quotas, integrations, and analysis. `type` selects the\nallowed shape; unsupported fields are rejected instead of ignored.\n","required":["addressLine1","addressLine2","city","state","zip","country","id","type","headline","required"],"properties":{"id":{"type":"string","pattern":"^[a-zA-Z0-9_-]+$","description":"Stable element id. Avoid spaces and reserved ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.12.id","typeLabel":"string"},"type":{"type":"string","enum":["address"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.12.type","typeLabel":"enum\u003cstring>"},"headline":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.12.headline.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.12.headline","typeLabel":"object"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.12.required","typeLabel":"boolean"},"addressLine1":{"type":"object","description":"Field config for address and contact info elements.","required":["show","required","placeholder"],"properties":{"show":{"type":"boolean","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.12.addressLine1.show","typeLabel":"boolean"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.12.addressLine1.required","typeLabel":"boolean"},"placeholder":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.12.addressLine1.placeholder.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.12.addressLine1.placeholder","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.12.addressLine1","typeLabel":"object"},"addressLine2":{"type":"object","description":"Field config for address and contact info elements.","required":["show","required","placeholder"],"properties":{"show":{"type":"boolean","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.12.addressLine2.show","typeLabel":"boolean"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.12.addressLine2.required","typeLabel":"boolean"},"placeholder":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.12.addressLine2.placeholder.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.12.addressLine2.placeholder","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.12.addressLine2","typeLabel":"object"},"city":{"type":"object","description":"Field config for address and contact info elements.","required":["show","required","placeholder"],"properties":{"show":{"type":"boolean","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.12.city.show","typeLabel":"boolean"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.12.city.required","typeLabel":"boolean"},"placeholder":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.12.city.placeholder.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.12.city.placeholder","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.12.city","typeLabel":"object"},"state":{"type":"object","description":"Field config for address and contact info elements.","required":["show","required","placeholder"],"properties":{"show":{"type":"boolean","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.12.state.show","typeLabel":"boolean"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.12.state.required","typeLabel":"boolean"},"placeholder":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.12.state.placeholder.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.12.state.placeholder","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.12.state","typeLabel":"object"},"zip":{"type":"object","description":"Field config for address and contact info elements.","required":["show","required","placeholder"],"properties":{"show":{"type":"boolean","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.12.zip.show","typeLabel":"boolean"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.12.zip.required","typeLabel":"boolean"},"placeholder":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.12.zip.placeholder.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.12.zip.placeholder","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.12.zip","typeLabel":"object"},"country":{"type":"object","description":"Field config for address and contact info elements.","required":["show","required","placeholder"],"properties":{"show":{"type":"boolean","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.12.country.show","typeLabel":"boolean"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.12.country.required","typeLabel":"boolean"},"placeholder":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.12.country.placeholder.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.12.country.placeholder","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.12.country","typeLabel":"object"},"subheader":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.12.subheader.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.12.subheader","typeLabel":"object"},"imageUrl":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.12.imageUrl","typeLabel":"string"},"imageAltText":{"type":"object","description":"Text alternative for `imageUrl`, read by screen readers. Omit or leave empty for a decorative image (rendered as `alt=\"\"`).","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.12.imageAltText.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.12.imageAltText","typeLabel":"object"},"videoUrl":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.12.videoUrl","typeLabel":"string"},"isDraft":{"type":"boolean","description":"Draft marker used by the editor and future update rules.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.12.isDraft","typeLabel":"boolean"},"showIf":{"type":"object","description":"Show-if: the element is shown only when this condition group matches, re-evaluated live as answers above it on the same page change. A hidden element is not validated (a hidden required element never blocks submission) and its answer is not submitted. Conditions use the same operands and operators as block `logic`. Reference rule: an element's show-if may use answers from earlier blocks and from elements above it in the same block, never itself or anything below it; a violation fails with `misordered_reference` at the exact condition path. Omit it, or send an empty group, for an element that is always shown.","required":["id","connector","conditions"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.12.showIf.id","typeLabel":"string\u003ccuid2>"},"connector":{"type":"string","enum":["and","or"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.12.showIf.connector","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","items":{"oneOf":[{"type":"object","description":"Single condition. Operators such as `isSubmitted`, `isSkipped`, `isClicked`, `isAccepted`,\n`isBooked`, `isSet`, and `isEmpty` do not use `rightOperand`; comparison operators do.\n","required":["id","leftOperand","operator"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.12.showIf.conditions.items.[INDEX].oneOf.0.id","typeLabel":"string\u003ccuid2>"},"leftOperand":{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.12.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.12.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.12.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.12.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.12.showIf.conditions.items.[INDEX].oneOf.0.leftOperand","typeLabel":"object"},"operator":{"type":"string","enum":["equals","doesNotEqual","contains","doesNotContain","startsWith","doesNotStartWith","endsWith","doesNotEndWith","isSubmitted","isSkipped","isGreaterThan","isLessThan","isGreaterThanOrEqual","isLessThanOrEqual","equalsOneOf","includesAllOf","includesOneOf","doesNotIncludeOneOf","doesNotIncludeAllOf","isClicked","isNotClicked","isAccepted","isBefore","isAfter","isBooked","isPartiallySubmitted","isCompletelySubmitted","isSet","isNotSet","isEmpty","isNotEmpty","isAnyOf"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.12.showIf.conditions.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"rightOperand":{"oneOf":[{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.12.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.12.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.12.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.1","typeLabel":"number"},{"type":"array","items":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.12.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.12.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.12.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value","typeLabel":"string | number | string[]"},"columnId":{"type":"string","minLength":1,"description":"On a matrix row condition, the id of the column. Read before `value` and wins when the two disagree, so the condition survives reordering. Must be a column of the matrix. Optional: when only `value` is sent, the id is filled in from the position on write.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.12.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnId","typeLabel":"string"},"columnIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.12.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition with `isAnyOf`, the ids of the columns `value` lists. Read before `value`, like `columnId`.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.12.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.12.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0","typeLabel":"object"},{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.12.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.12.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.12.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.12.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.12.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1","typeLabel":"object"}],"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.12.showIf.conditions.items.[INDEX].oneOf.0.rightOperand","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.12.showIf.conditions.items.[INDEX].oneOf.0","typeLabel":"object"},{}],"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.12.showIf.conditions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.12.showIf.conditions","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.12.showIf","typeLabel":"object"},"code":{"type":"string","maxLength":30,"pattern":"^[a-z][a-z0-9_]*$","description":"Question code, the name the question carries in exports, webhooks and links. Optional. Starts with a lowercase letter, then lowercase letters, digits and `_`; no `__`, no trailing `_`, at most 30 characters. It must not be an SPSS reserved word (`all`, `and`, `by`, `eq`, `ge`, `gt`, `le`, `lt`, `ne`, `not`, `or`, `to`, `with`) or an export column name (`response_id`, `language`, `outcome`, ...), and must be unique among the survey's question codes, Embedded Data names and the Question IDs of other questions, ignoring case. CTA elements have no code.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.12.code","typeLabel":"string"},"validation":{"type":"object","description":"Optional element-level validation rules.","required":["rules"],"properties":{"rules":{"type":"array","items":{"type":"object","required":["id","type","params"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.12.validation.rules.items.[INDEX].id","typeLabel":"string"},"type":{"type":"string","enum":["minLength","maxLength","pattern","email","url","phone","equals","doesNotEqual","contains","doesNotContain","minValue","maxValue","isGreaterThan","isLessThan","minSelections","maxSelections","minRanked","rankAll","minRowsAnswered","answerAllRows","isLaterThan","isEarlierThan","isBetween","isNotBetween","fileExtensionIs","fileExtensionIsNot"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.12.validation.rules.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"params":{"type":"object","additionalProperties":true,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.12.validation.rules.items.[INDEX].params","typeLabel":"object"},"field":{"type":"string","enum":["addressLine1","addressLine2","city","state","zip","country","firstName","lastName","email","phone","company"],"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.12.validation.rules.items.[INDEX].field","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.12.validation.rules.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.12.validation.rules","typeLabel":"object[]"},"logic":{"type":"string","enum":["and","or"],"default":"and","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.12.validation.logic","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.12.validation","typeLabel":"object"}},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.12","typeLabel":"object"},{"type":"object","description":"Survey element/question inside a block. Element ids are stable public identifiers used by\nlogic, recall strings, response data, quotas, integrations, and analysis. `type` selects the\nallowed shape; unsupported fields are rejected instead of ignored.\n","required":["choices","id","type","headline","required"],"properties":{"id":{"type":"string","pattern":"^[a-zA-Z0-9_-]+$","description":"Stable element id. Avoid spaces and reserved ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.id","typeLabel":"string"},"type":{"type":"string","enum":["ranking"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.type","typeLabel":"enum\u003cstring>"},"headline":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.headline.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.headline","typeLabel":"object"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.required","typeLabel":"boolean"},"choices":{"type":"array","minItems":2,"maxItems":25,"items":{"type":"object","required":["id","label"],"properties":{"id":{"type":"string","description":"Stable choice id.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.choices.items.[INDEX].id","typeLabel":"string"},"label":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.choices.items.[INDEX].label.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.choices.items.[INDEX].label","typeLabel":"object"},"code":{"type":"string","maxLength":20,"pattern":"^[a-z0-9][a-z0-9_]*$","description":"Answer code of an option, a matrix row or a matrix column. Optional. Lowercase letters, digits and `_`; it may start with a digit, but not with `_`; no `__`, no trailing `_`, at most 20 characters. It must not be an SPSS reserved word or an export column name, and must be unique within its question (a matrix's rows and columns are checked separately), ignoring case.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.choices.items.[INDEX].code","typeLabel":"string"},"showIf":{"type":"object","description":"Option show-if: the option (or matrix row or column) is offered only when this condition group matches, re-evaluated live as earlier answers change. It may use what its element's show-if may use: answers from earlier blocks and from elements above its element in the same block, never its own element or anything below (`misordered_reference` at the exact condition path). A question left with no option to offer is skipped and recorded as not shown. Omit it, or send an empty group, for an option that is always offered. Allowed on published surveys.","required":["id","connector","conditions"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf.id","typeLabel":"string\u003ccuid2>"},"connector":{"type":"string","enum":["and","or"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf.connector","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","items":{"oneOf":[{"type":"object","description":"Single condition. Operators such as `isSubmitted`, `isSkipped`, `isClicked`, `isAccepted`,\n`isBooked`, `isSet`, and `isEmpty` do not use `rightOperand`; comparison operators do.\n","required":["id","leftOperand","operator"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.id","typeLabel":"string\u003ccuid2>"},"leftOperand":{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand","typeLabel":"object"},"operator":{"type":"string","enum":["equals","doesNotEqual","contains","doesNotContain","startsWith","doesNotStartWith","endsWith","doesNotEndWith","isSubmitted","isSkipped","isGreaterThan","isLessThan","isGreaterThanOrEqual","isLessThanOrEqual","equalsOneOf","includesAllOf","includesOneOf","doesNotIncludeOneOf","doesNotIncludeAllOf","isClicked","isNotClicked","isAccepted","isBefore","isAfter","isBooked","isPartiallySubmitted","isCompletelySubmitted","isSet","isNotSet","isEmpty","isNotEmpty","isAnyOf"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"rightOperand":{"oneOf":[{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.1","typeLabel":"number"},{"type":"array","items":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value","typeLabel":"string | number | string[]"},"columnId":{"type":"string","minLength":1,"description":"On a matrix row condition, the id of the column. Read before `value` and wins when the two disagree, so the condition survives reordering. Must be a column of the matrix. Optional: when only `value` is sent, the id is filled in from the position on write.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnId","typeLabel":"string"},"columnIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition with `isAnyOf`, the ids of the columns `value` lists. Read before `value`, like `columnId`.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0","typeLabel":"object"},{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1","typeLabel":"object"}],"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0","typeLabel":"object"},{}],"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf.conditions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf.conditions","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf","typeLabel":"object"},"hidden":{"type":"boolean","description":"Hidden: the option is never offered, whatever its `showIf` says, and is recorded as not shown. Use it to retire an option on a published survey instead of deleting it (deleting an option that existed at launch is refused): it keeps its id, answer code and earlier answers, and stays in results labelled Hidden.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.choices.items.[INDEX].hidden","typeLabel":"boolean"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.choices.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.choices","typeLabel":"object[]"},"subheader":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.subheader.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.subheader","typeLabel":"object"},"imageUrl":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.imageUrl","typeLabel":"string"},"imageAltText":{"type":"object","description":"Text alternative for `imageUrl`, read by screen readers. Omit or leave empty for a decorative image (rendered as `alt=\"\"`).","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.imageAltText.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.imageAltText","typeLabel":"object"},"videoUrl":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.videoUrl","typeLabel":"string"},"isDraft":{"type":"boolean","description":"Draft marker used by the editor and future update rules.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.isDraft","typeLabel":"boolean"},"showIf":{"type":"object","description":"Show-if: the element is shown only when this condition group matches, re-evaluated live as answers above it on the same page change. A hidden element is not validated (a hidden required element never blocks submission) and its answer is not submitted. Conditions use the same operands and operators as block `logic`. Reference rule: an element's show-if may use answers from earlier blocks and from elements above it in the same block, never itself or anything below it; a violation fails with `misordered_reference` at the exact condition path. Omit it, or send an empty group, for an element that is always shown.","required":["id","connector","conditions"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.showIf.id","typeLabel":"string\u003ccuid2>"},"connector":{"type":"string","enum":["and","or"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.showIf.connector","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","items":{"oneOf":[{"type":"object","description":"Single condition. Operators such as `isSubmitted`, `isSkipped`, `isClicked`, `isAccepted`,\n`isBooked`, `isSet`, and `isEmpty` do not use `rightOperand`; comparison operators do.\n","required":["id","leftOperand","operator"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.showIf.conditions.items.[INDEX].oneOf.0.id","typeLabel":"string\u003ccuid2>"},"leftOperand":{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.showIf.conditions.items.[INDEX].oneOf.0.leftOperand","typeLabel":"object"},"operator":{"type":"string","enum":["equals","doesNotEqual","contains","doesNotContain","startsWith","doesNotStartWith","endsWith","doesNotEndWith","isSubmitted","isSkipped","isGreaterThan","isLessThan","isGreaterThanOrEqual","isLessThanOrEqual","equalsOneOf","includesAllOf","includesOneOf","doesNotIncludeOneOf","doesNotIncludeAllOf","isClicked","isNotClicked","isAccepted","isBefore","isAfter","isBooked","isPartiallySubmitted","isCompletelySubmitted","isSet","isNotSet","isEmpty","isNotEmpty","isAnyOf"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.showIf.conditions.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"rightOperand":{"oneOf":[{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.1","typeLabel":"number"},{"type":"array","items":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value","typeLabel":"string | number | string[]"},"columnId":{"type":"string","minLength":1,"description":"On a matrix row condition, the id of the column. Read before `value` and wins when the two disagree, so the condition survives reordering. Must be a column of the matrix. Optional: when only `value` is sent, the id is filled in from the position on write.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnId","typeLabel":"string"},"columnIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition with `isAnyOf`, the ids of the columns `value` lists. Read before `value`, like `columnId`.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0","typeLabel":"object"},{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1","typeLabel":"object"}],"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.showIf.conditions.items.[INDEX].oneOf.0.rightOperand","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.showIf.conditions.items.[INDEX].oneOf.0","typeLabel":"object"},{}],"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.showIf.conditions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.showIf.conditions","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.showIf","typeLabel":"object"},"code":{"type":"string","maxLength":30,"pattern":"^[a-z][a-z0-9_]*$","description":"Question code, the name the question carries in exports, webhooks and links. Optional. Starts with a lowercase letter, then lowercase letters, digits and `_`; no `__`, no trailing `_`, at most 30 characters. It must not be an SPSS reserved word (`all`, `and`, `by`, `eq`, `ge`, `gt`, `le`, `lt`, `ne`, `not`, `or`, `to`, `with`) or an export column name (`response_id`, `language`, `outcome`, ...), and must be unique among the survey's question codes, Embedded Data names and the Question IDs of other questions, ignoring case. CTA elements have no code.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.code","typeLabel":"string"},"optionsCopiedFrom":{"type":"string","minLength":1,"description":"Copied options: the id of an earlier element whose options this element copies (\"only the brands you know\"). Choices copy from a single select, multi select or ranking; pictures from a picture selection (matrix rows are not copied: give rows a `showIf` on the source instead). Write the copies yourself: each copied option keeps the source option's `id` and `code`, and carries a `showIf` \"picked in the source\" (`includesOneOf` with its own id, or `equals` when the source is a single select), so the element offers exactly the options picked there. Copied codes follow the source's: a code sent for a copy is replaced by the source option's. Fixed options next to the copies (such as \"None of these\", id `none`) get the next code free in every linked element. The source must exist (`dangling_reference`), sit in an earlier block or above this element on its block (`misordered_reference`), and have options of the same kind (`invalid_reference`). To bring in options the source gained later, add them the same way.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.optionsCopiedFrom","typeLabel":"string"},"otherOptionPlaceholder":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.otherOptionPlaceholder.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.otherOptionPlaceholder","typeLabel":"object"},"shuffleOption":{"type":"string","enum":["none","all","exceptLast","reverseOrderOccasionally","reverseOrderExceptLast"],"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.shuffleOption","typeLabel":"enum\u003cstring>"},"validation":{"type":"object","description":"Optional element-level validation rules.","required":["rules"],"properties":{"rules":{"type":"array","items":{"type":"object","required":["id","type","params"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.validation.rules.items.[INDEX].id","typeLabel":"string"},"type":{"type":"string","enum":["minLength","maxLength","pattern","email","url","phone","equals","doesNotEqual","contains","doesNotContain","minValue","maxValue","isGreaterThan","isLessThan","minSelections","maxSelections","minRanked","rankAll","minRowsAnswered","answerAllRows","isLaterThan","isEarlierThan","isBetween","isNotBetween","fileExtensionIs","fileExtensionIsNot"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.validation.rules.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"params":{"type":"object","additionalProperties":true,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.validation.rules.items.[INDEX].params","typeLabel":"object"},"field":{"type":"string","enum":["addressLine1","addressLine2","city","state","zip","country","firstName","lastName","email","phone","company"],"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.validation.rules.items.[INDEX].field","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.validation.rules.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.validation.rules","typeLabel":"object[]"},"logic":{"type":"string","enum":["and","or"],"default":"and","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.validation.logic","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13.validation","typeLabel":"object"}},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.13","typeLabel":"object"},{"type":"object","description":"Survey element/question inside a block. Element ids are stable public identifiers used by\nlogic, recall strings, response data, quotas, integrations, and analysis. `type` selects the\nallowed shape; unsupported fields are rejected instead of ignored.\n","required":["firstName","lastName","email","phone","company","id","type","headline","required"],"properties":{"id":{"type":"string","pattern":"^[a-zA-Z0-9_-]+$","description":"Stable element id. Avoid spaces and reserved ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.14.id","typeLabel":"string"},"type":{"type":"string","enum":["contactInfo"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.14.type","typeLabel":"enum\u003cstring>"},"headline":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.14.headline.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.14.headline","typeLabel":"object"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.14.required","typeLabel":"boolean"},"firstName":{"type":"object","description":"Field config for address and contact info elements.","required":["show","required","placeholder"],"properties":{"show":{"type":"boolean","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.14.firstName.show","typeLabel":"boolean"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.14.firstName.required","typeLabel":"boolean"},"placeholder":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.14.firstName.placeholder.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.14.firstName.placeholder","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.14.firstName","typeLabel":"object"},"lastName":{"type":"object","description":"Field config for address and contact info elements.","required":["show","required","placeholder"],"properties":{"show":{"type":"boolean","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.14.lastName.show","typeLabel":"boolean"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.14.lastName.required","typeLabel":"boolean"},"placeholder":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.14.lastName.placeholder.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.14.lastName.placeholder","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.14.lastName","typeLabel":"object"},"email":{"type":"object","description":"Field config for address and contact info elements.","required":["show","required","placeholder"],"properties":{"show":{"type":"boolean","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.14.email.show","typeLabel":"boolean"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.14.email.required","typeLabel":"boolean"},"placeholder":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.14.email.placeholder.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.14.email.placeholder","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.14.email","typeLabel":"object"},"phone":{"type":"object","description":"Field config for address and contact info elements.","required":["show","required","placeholder"],"properties":{"show":{"type":"boolean","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.14.phone.show","typeLabel":"boolean"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.14.phone.required","typeLabel":"boolean"},"placeholder":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.14.phone.placeholder.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.14.phone.placeholder","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.14.phone","typeLabel":"object"},"company":{"type":"object","description":"Field config for address and contact info elements.","required":["show","required","placeholder"],"properties":{"show":{"type":"boolean","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.14.company.show","typeLabel":"boolean"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.14.company.required","typeLabel":"boolean"},"placeholder":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.14.company.placeholder.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.14.company.placeholder","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.14.company","typeLabel":"object"},"subheader":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.14.subheader.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.14.subheader","typeLabel":"object"},"imageUrl":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.14.imageUrl","typeLabel":"string"},"imageAltText":{"type":"object","description":"Text alternative for `imageUrl`, read by screen readers. Omit or leave empty for a decorative image (rendered as `alt=\"\"`).","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.14.imageAltText.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.14.imageAltText","typeLabel":"object"},"videoUrl":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.14.videoUrl","typeLabel":"string"},"isDraft":{"type":"boolean","description":"Draft marker used by the editor and future update rules.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.14.isDraft","typeLabel":"boolean"},"showIf":{"type":"object","description":"Show-if: the element is shown only when this condition group matches, re-evaluated live as answers above it on the same page change. A hidden element is not validated (a hidden required element never blocks submission) and its answer is not submitted. Conditions use the same operands and operators as block `logic`. Reference rule: an element's show-if may use answers from earlier blocks and from elements above it in the same block, never itself or anything below it; a violation fails with `misordered_reference` at the exact condition path. Omit it, or send an empty group, for an element that is always shown.","required":["id","connector","conditions"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.14.showIf.id","typeLabel":"string\u003ccuid2>"},"connector":{"type":"string","enum":["and","or"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.14.showIf.connector","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","items":{"oneOf":[{"type":"object","description":"Single condition. Operators such as `isSubmitted`, `isSkipped`, `isClicked`, `isAccepted`,\n`isBooked`, `isSet`, and `isEmpty` do not use `rightOperand`; comparison operators do.\n","required":["id","leftOperand","operator"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.14.showIf.conditions.items.[INDEX].oneOf.0.id","typeLabel":"string\u003ccuid2>"},"leftOperand":{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.14.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.14.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.14.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.14.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.14.showIf.conditions.items.[INDEX].oneOf.0.leftOperand","typeLabel":"object"},"operator":{"type":"string","enum":["equals","doesNotEqual","contains","doesNotContain","startsWith","doesNotStartWith","endsWith","doesNotEndWith","isSubmitted","isSkipped","isGreaterThan","isLessThan","isGreaterThanOrEqual","isLessThanOrEqual","equalsOneOf","includesAllOf","includesOneOf","doesNotIncludeOneOf","doesNotIncludeAllOf","isClicked","isNotClicked","isAccepted","isBefore","isAfter","isBooked","isPartiallySubmitted","isCompletelySubmitted","isSet","isNotSet","isEmpty","isNotEmpty","isAnyOf"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.14.showIf.conditions.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"rightOperand":{"oneOf":[{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.14.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.14.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.14.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.1","typeLabel":"number"},{"type":"array","items":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.14.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.14.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.14.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value","typeLabel":"string | number | string[]"},"columnId":{"type":"string","minLength":1,"description":"On a matrix row condition, the id of the column. Read before `value` and wins when the two disagree, so the condition survives reordering. Must be a column of the matrix. Optional: when only `value` is sent, the id is filled in from the position on write.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.14.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnId","typeLabel":"string"},"columnIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.14.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition with `isAnyOf`, the ids of the columns `value` lists. Read before `value`, like `columnId`.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.14.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.14.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0","typeLabel":"object"},{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.14.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.14.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.14.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.14.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.14.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1","typeLabel":"object"}],"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.14.showIf.conditions.items.[INDEX].oneOf.0.rightOperand","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.14.showIf.conditions.items.[INDEX].oneOf.0","typeLabel":"object"},{}],"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.14.showIf.conditions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.14.showIf.conditions","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.14.showIf","typeLabel":"object"},"code":{"type":"string","maxLength":30,"pattern":"^[a-z][a-z0-9_]*$","description":"Question code, the name the question carries in exports, webhooks and links. Optional. Starts with a lowercase letter, then lowercase letters, digits and `_`; no `__`, no trailing `_`, at most 30 characters. It must not be an SPSS reserved word (`all`, `and`, `by`, `eq`, `ge`, `gt`, `le`, `lt`, `ne`, `not`, `or`, `to`, `with`) or an export column name (`response_id`, `language`, `outcome`, ...), and must be unique among the survey's question codes, Embedded Data names and the Question IDs of other questions, ignoring case. CTA elements have no code.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.14.code","typeLabel":"string"},"validation":{"type":"object","description":"Optional element-level validation rules.","required":["rules"],"properties":{"rules":{"type":"array","items":{"type":"object","required":["id","type","params"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.14.validation.rules.items.[INDEX].id","typeLabel":"string"},"type":{"type":"string","enum":["minLength","maxLength","pattern","email","url","phone","equals","doesNotEqual","contains","doesNotContain","minValue","maxValue","isGreaterThan","isLessThan","minSelections","maxSelections","minRanked","rankAll","minRowsAnswered","answerAllRows","isLaterThan","isEarlierThan","isBetween","isNotBetween","fileExtensionIs","fileExtensionIsNot"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.14.validation.rules.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"params":{"type":"object","additionalProperties":true,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.14.validation.rules.items.[INDEX].params","typeLabel":"object"},"field":{"type":"string","enum":["addressLine1","addressLine2","city","state","zip","country","firstName","lastName","email","phone","company"],"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.14.validation.rules.items.[INDEX].field","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.14.validation.rules.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.14.validation.rules","typeLabel":"object[]"},"logic":{"type":"string","enum":["and","or"],"default":"and","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.14.validation.logic","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.14.validation","typeLabel":"object"}},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.14","typeLabel":"object"},{"type":"object","description":"Survey element/question inside a block. Element ids are stable public identifiers used by\nlogic, recall strings, response data, quotas, integrations, and analysis. `type` selects the\nallowed shape; unsupported fields are rejected instead of ignored.\n","required":["scale","range","id","type","headline","required"],"properties":{"id":{"type":"string","pattern":"^[a-zA-Z0-9_-]+$","description":"Stable element id. Avoid spaces and reserved ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.15.id","typeLabel":"string"},"type":{"type":"string","enum":["csat"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.15.type","typeLabel":"enum\u003cstring>"},"headline":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.15.headline.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.15.headline","typeLabel":"object"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.15.required","typeLabel":"boolean"},"scale":{"type":"string","enum":["number","smiley","star"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.15.scale","typeLabel":"enum\u003cstring>"},"range":{"type":"integer","enum":[5],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.15.range","typeLabel":"enum\u003cinteger>"},"subheader":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.15.subheader.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.15.subheader","typeLabel":"object"},"imageUrl":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.15.imageUrl","typeLabel":"string"},"imageAltText":{"type":"object","description":"Text alternative for `imageUrl`, read by screen readers. Omit or leave empty for a decorative image (rendered as `alt=\"\"`).","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.15.imageAltText.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.15.imageAltText","typeLabel":"object"},"videoUrl":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.15.videoUrl","typeLabel":"string"},"isDraft":{"type":"boolean","description":"Draft marker used by the editor and future update rules.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.15.isDraft","typeLabel":"boolean"},"showIf":{"type":"object","description":"Show-if: the element is shown only when this condition group matches, re-evaluated live as answers above it on the same page change. A hidden element is not validated (a hidden required element never blocks submission) and its answer is not submitted. Conditions use the same operands and operators as block `logic`. Reference rule: an element's show-if may use answers from earlier blocks and from elements above it in the same block, never itself or anything below it; a violation fails with `misordered_reference` at the exact condition path. Omit it, or send an empty group, for an element that is always shown.","required":["id","connector","conditions"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.15.showIf.id","typeLabel":"string\u003ccuid2>"},"connector":{"type":"string","enum":["and","or"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.15.showIf.connector","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","items":{"oneOf":[{"type":"object","description":"Single condition. Operators such as `isSubmitted`, `isSkipped`, `isClicked`, `isAccepted`,\n`isBooked`, `isSet`, and `isEmpty` do not use `rightOperand`; comparison operators do.\n","required":["id","leftOperand","operator"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.15.showIf.conditions.items.[INDEX].oneOf.0.id","typeLabel":"string\u003ccuid2>"},"leftOperand":{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.15.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.15.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.15.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.15.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.15.showIf.conditions.items.[INDEX].oneOf.0.leftOperand","typeLabel":"object"},"operator":{"type":"string","enum":["equals","doesNotEqual","contains","doesNotContain","startsWith","doesNotStartWith","endsWith","doesNotEndWith","isSubmitted","isSkipped","isGreaterThan","isLessThan","isGreaterThanOrEqual","isLessThanOrEqual","equalsOneOf","includesAllOf","includesOneOf","doesNotIncludeOneOf","doesNotIncludeAllOf","isClicked","isNotClicked","isAccepted","isBefore","isAfter","isBooked","isPartiallySubmitted","isCompletelySubmitted","isSet","isNotSet","isEmpty","isNotEmpty","isAnyOf"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.15.showIf.conditions.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"rightOperand":{"oneOf":[{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.15.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.15.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.15.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.1","typeLabel":"number"},{"type":"array","items":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.15.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.15.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.15.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value","typeLabel":"string | number | string[]"},"columnId":{"type":"string","minLength":1,"description":"On a matrix row condition, the id of the column. Read before `value` and wins when the two disagree, so the condition survives reordering. Must be a column of the matrix. Optional: when only `value` is sent, the id is filled in from the position on write.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.15.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnId","typeLabel":"string"},"columnIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.15.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition with `isAnyOf`, the ids of the columns `value` lists. Read before `value`, like `columnId`.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.15.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.15.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0","typeLabel":"object"},{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.15.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.15.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.15.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.15.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.15.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1","typeLabel":"object"}],"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.15.showIf.conditions.items.[INDEX].oneOf.0.rightOperand","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.15.showIf.conditions.items.[INDEX].oneOf.0","typeLabel":"object"},{}],"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.15.showIf.conditions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.15.showIf.conditions","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.15.showIf","typeLabel":"object"},"code":{"type":"string","maxLength":30,"pattern":"^[a-z][a-z0-9_]*$","description":"Question code, the name the question carries in exports, webhooks and links. Optional. Starts with a lowercase letter, then lowercase letters, digits and `_`; no `__`, no trailing `_`, at most 30 characters. It must not be an SPSS reserved word (`all`, `and`, `by`, `eq`, `ge`, `gt`, `le`, `lt`, `ne`, `not`, `or`, `to`, `with`) or an export column name (`response_id`, `language`, `outcome`, ...), and must be unique among the survey's question codes, Embedded Data names and the Question IDs of other questions, ignoring case. CTA elements have no code.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.15.code","typeLabel":"string"},"lowerLabel":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.15.lowerLabel.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.15.lowerLabel","typeLabel":"object"},"upperLabel":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.15.upperLabel.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.15.upperLabel","typeLabel":"object"},"isColorCodingEnabled":{"type":"boolean","default":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.15.isColorCodingEnabled","typeLabel":"boolean"}},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.15","typeLabel":"object"},{"type":"object","description":"Survey element/question inside a block. Element ids are stable public identifiers used by\nlogic, recall strings, response data, quotas, integrations, and analysis. `type` selects the\nallowed shape; unsupported fields are rejected instead of ignored.\n","required":["scale","range","id","type","headline","required"],"properties":{"id":{"type":"string","pattern":"^[a-zA-Z0-9_-]+$","description":"Stable element id. Avoid spaces and reserved ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.16.id","typeLabel":"string"},"type":{"type":"string","enum":["ces"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.16.type","typeLabel":"enum\u003cstring>"},"headline":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.16.headline.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.16.headline","typeLabel":"object"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.16.required","typeLabel":"boolean"},"scale":{"type":"string","enum":["number","smiley","star"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.16.scale","typeLabel":"enum\u003cstring>"},"range":{"type":"integer","enum":[5,7],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.16.range","typeLabel":"enum\u003cinteger>"},"subheader":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.16.subheader.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.16.subheader","typeLabel":"object"},"imageUrl":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.16.imageUrl","typeLabel":"string"},"imageAltText":{"type":"object","description":"Text alternative for `imageUrl`, read by screen readers. Omit or leave empty for a decorative image (rendered as `alt=\"\"`).","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.16.imageAltText.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.16.imageAltText","typeLabel":"object"},"videoUrl":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.16.videoUrl","typeLabel":"string"},"isDraft":{"type":"boolean","description":"Draft marker used by the editor and future update rules.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.16.isDraft","typeLabel":"boolean"},"showIf":{"type":"object","description":"Show-if: the element is shown only when this condition group matches, re-evaluated live as answers above it on the same page change. A hidden element is not validated (a hidden required element never blocks submission) and its answer is not submitted. Conditions use the same operands and operators as block `logic`. Reference rule: an element's show-if may use answers from earlier blocks and from elements above it in the same block, never itself or anything below it; a violation fails with `misordered_reference` at the exact condition path. Omit it, or send an empty group, for an element that is always shown.","required":["id","connector","conditions"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.16.showIf.id","typeLabel":"string\u003ccuid2>"},"connector":{"type":"string","enum":["and","or"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.16.showIf.connector","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","items":{"oneOf":[{"type":"object","description":"Single condition. Operators such as `isSubmitted`, `isSkipped`, `isClicked`, `isAccepted`,\n`isBooked`, `isSet`, and `isEmpty` do not use `rightOperand`; comparison operators do.\n","required":["id","leftOperand","operator"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.16.showIf.conditions.items.[INDEX].oneOf.0.id","typeLabel":"string\u003ccuid2>"},"leftOperand":{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.16.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.16.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.16.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.16.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.16.showIf.conditions.items.[INDEX].oneOf.0.leftOperand","typeLabel":"object"},"operator":{"type":"string","enum":["equals","doesNotEqual","contains","doesNotContain","startsWith","doesNotStartWith","endsWith","doesNotEndWith","isSubmitted","isSkipped","isGreaterThan","isLessThan","isGreaterThanOrEqual","isLessThanOrEqual","equalsOneOf","includesAllOf","includesOneOf","doesNotIncludeOneOf","doesNotIncludeAllOf","isClicked","isNotClicked","isAccepted","isBefore","isAfter","isBooked","isPartiallySubmitted","isCompletelySubmitted","isSet","isNotSet","isEmpty","isNotEmpty","isAnyOf"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.16.showIf.conditions.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"rightOperand":{"oneOf":[{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.16.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.16.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.16.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.1","typeLabel":"number"},{"type":"array","items":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.16.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.16.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.16.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value","typeLabel":"string | number | string[]"},"columnId":{"type":"string","minLength":1,"description":"On a matrix row condition, the id of the column. Read before `value` and wins when the two disagree, so the condition survives reordering. Must be a column of the matrix. Optional: when only `value` is sent, the id is filled in from the position on write.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.16.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnId","typeLabel":"string"},"columnIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.16.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition with `isAnyOf`, the ids of the columns `value` lists. Read before `value`, like `columnId`.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.16.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.16.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0","typeLabel":"object"},{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.16.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.16.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.16.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.16.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.16.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1","typeLabel":"object"}],"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.16.showIf.conditions.items.[INDEX].oneOf.0.rightOperand","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.16.showIf.conditions.items.[INDEX].oneOf.0","typeLabel":"object"},{}],"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.16.showIf.conditions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.16.showIf.conditions","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.16.showIf","typeLabel":"object"},"code":{"type":"string","maxLength":30,"pattern":"^[a-z][a-z0-9_]*$","description":"Question code, the name the question carries in exports, webhooks and links. Optional. Starts with a lowercase letter, then lowercase letters, digits and `_`; no `__`, no trailing `_`, at most 30 characters. It must not be an SPSS reserved word (`all`, `and`, `by`, `eq`, `ge`, `gt`, `le`, `lt`, `ne`, `not`, `or`, `to`, `with`) or an export column name (`response_id`, `language`, `outcome`, ...), and must be unique among the survey's question codes, Embedded Data names and the Question IDs of other questions, ignoring case. CTA elements have no code.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.16.code","typeLabel":"string"},"lowerLabel":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.16.lowerLabel.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.16.lowerLabel","typeLabel":"object"},"upperLabel":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.16.upperLabel.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.16.upperLabel","typeLabel":"object"},"isColorCodingEnabled":{"type":"boolean","default":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.16.isColorCodingEnabled","typeLabel":"boolean"}},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.16","typeLabel":"object"},{"type":"object","description":"Survey element/question inside a block. Element ids are stable public identifiers used by\nlogic, recall strings, response data, quotas, integrations, and analysis. `type` selects the\nallowed shape; unsupported fields are rejected instead of ignored.\n","required":["id","type","headline","required"],"properties":{"id":{"type":"string","pattern":"^[a-zA-Z0-9_-]+$","description":"Stable element id. Avoid spaces and reserved ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.17.id","typeLabel":"string"},"type":{"type":"string","enum":["signature"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.17.type","typeLabel":"enum\u003cstring>"},"headline":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.17.headline.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.17.headline","typeLabel":"object"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.17.required","typeLabel":"boolean"},"subheader":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.17.subheader.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.17.subheader","typeLabel":"object"},"imageUrl":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.17.imageUrl","typeLabel":"string"},"imageAltText":{"type":"object","description":"Text alternative for `imageUrl`, read by screen readers. Omit or leave empty for a decorative image (rendered as `alt=\"\"`).","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.17.imageAltText.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.17.imageAltText","typeLabel":"object"},"videoUrl":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.17.videoUrl","typeLabel":"string"},"isDraft":{"type":"boolean","description":"Draft marker used by the editor and future update rules.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.17.isDraft","typeLabel":"boolean"},"showIf":{"type":"object","description":"Show-if: the element is shown only when this condition group matches, re-evaluated live as answers above it on the same page change. A hidden element is not validated (a hidden required element never blocks submission) and its answer is not submitted. Conditions use the same operands and operators as block `logic`. Reference rule: an element's show-if may use answers from earlier blocks and from elements above it in the same block, never itself or anything below it; a violation fails with `misordered_reference` at the exact condition path. Omit it, or send an empty group, for an element that is always shown.","required":["id","connector","conditions"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.17.showIf.id","typeLabel":"string\u003ccuid2>"},"connector":{"type":"string","enum":["and","or"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.17.showIf.connector","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","items":{"oneOf":[{"type":"object","description":"Single condition. Operators such as `isSubmitted`, `isSkipped`, `isClicked`, `isAccepted`,\n`isBooked`, `isSet`, and `isEmpty` do not use `rightOperand`; comparison operators do.\n","required":["id","leftOperand","operator"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.17.showIf.conditions.items.[INDEX].oneOf.0.id","typeLabel":"string\u003ccuid2>"},"leftOperand":{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.17.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.17.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.17.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.17.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.17.showIf.conditions.items.[INDEX].oneOf.0.leftOperand","typeLabel":"object"},"operator":{"type":"string","enum":["equals","doesNotEqual","contains","doesNotContain","startsWith","doesNotStartWith","endsWith","doesNotEndWith","isSubmitted","isSkipped","isGreaterThan","isLessThan","isGreaterThanOrEqual","isLessThanOrEqual","equalsOneOf","includesAllOf","includesOneOf","doesNotIncludeOneOf","doesNotIncludeAllOf","isClicked","isNotClicked","isAccepted","isBefore","isAfter","isBooked","isPartiallySubmitted","isCompletelySubmitted","isSet","isNotSet","isEmpty","isNotEmpty","isAnyOf"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.17.showIf.conditions.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"rightOperand":{"oneOf":[{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.17.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.17.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.17.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.1","typeLabel":"number"},{"type":"array","items":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.17.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.17.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.17.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value","typeLabel":"string | number | string[]"},"columnId":{"type":"string","minLength":1,"description":"On a matrix row condition, the id of the column. Read before `value` and wins when the two disagree, so the condition survives reordering. Must be a column of the matrix. Optional: when only `value` is sent, the id is filled in from the position on write.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.17.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnId","typeLabel":"string"},"columnIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.17.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition with `isAnyOf`, the ids of the columns `value` lists. Read before `value`, like `columnId`.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.17.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.17.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0","typeLabel":"object"},{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.17.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.17.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.17.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.17.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.17.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1","typeLabel":"object"}],"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.17.showIf.conditions.items.[INDEX].oneOf.0.rightOperand","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.17.showIf.conditions.items.[INDEX].oneOf.0","typeLabel":"object"},{}],"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.17.showIf.conditions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.17.showIf.conditions","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.17.showIf","typeLabel":"object"},"code":{"type":"string","maxLength":30,"pattern":"^[a-z][a-z0-9_]*$","description":"Question code, the name the question carries in exports, webhooks and links. Optional. Starts with a lowercase letter, then lowercase letters, digits and `_`; no `__`, no trailing `_`, at most 30 characters. It must not be an SPSS reserved word (`all`, `and`, `by`, `eq`, `ge`, `gt`, `le`, `lt`, `ne`, `not`, `or`, `to`, `with`) or an export column name (`response_id`, `language`, `outcome`, ...), and must be unique among the survey's question codes, Embedded Data names and the Question IDs of other questions, ignoring case. CTA elements have no code.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.17.code","typeLabel":"string"},"allowTypedSignature":{"type":"boolean","default":true,"description":"Whether the respondent may type their name instead of drawing. The signature is stored as a single PNG image either way.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.17.allowTypedSignature","typeLabel":"boolean"}},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX].oneOf.17","typeLabel":"object"}],"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.elements","typeLabel":"object[]"},"id":{"type":"string","format":"cuid2","description":"Optional stable block id. Generated when omitted.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.id","typeLabel":"string\u003ccuid2>"},"logic":{"type":"array","items":{"type":"object","description":"Conditional logic rule evaluated at block level.","required":["id","conditions","actions"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.logic.items.[INDEX].id","typeLabel":"string\u003ccuid2>"},"conditions":{"type":"object","required":["id","connector","conditions"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.logic.items.[INDEX].conditions.id","typeLabel":"string\u003ccuid2>"},"connector":{"type":"string","enum":["and","or"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.logic.items.[INDEX].conditions.connector","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","items":{"oneOf":[{"type":"object","description":"Single condition. Operators such as `isSubmitted`, `isSkipped`, `isClicked`, `isAccepted`,\n`isBooked`, `isSet`, and `isEmpty` do not use `rightOperand`; comparison operators do.\n","required":["id","leftOperand","operator"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.logic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.id","typeLabel":"string\u003ccuid2>"},"leftOperand":{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.logic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.leftOperand.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.logic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.leftOperand.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.logic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.leftOperand.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.logic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.leftOperand.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.logic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.leftOperand","typeLabel":"object"},"operator":{"type":"string","enum":["equals","doesNotEqual","contains","doesNotContain","startsWith","doesNotStartWith","endsWith","doesNotEndWith","isSubmitted","isSkipped","isGreaterThan","isLessThan","isGreaterThanOrEqual","isLessThanOrEqual","equalsOneOf","includesAllOf","includesOneOf","doesNotIncludeOneOf","doesNotIncludeAllOf","isClicked","isNotClicked","isAccepted","isBefore","isAfter","isBooked","isPartiallySubmitted","isCompletelySubmitted","isSet","isNotSet","isEmpty","isNotEmpty","isAnyOf"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.logic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"rightOperand":{"oneOf":[{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.logic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.logic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.logic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.1","typeLabel":"number"},{"type":"array","items":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.logic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.logic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.logic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value","typeLabel":"string | number | string[]"},"columnId":{"type":"string","minLength":1,"description":"On a matrix row condition, the id of the column. Read before `value` and wins when the two disagree, so the condition survives reordering. Must be a column of the matrix. Optional: when only `value` is sent, the id is filled in from the position on write.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.logic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnId","typeLabel":"string"},"columnIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.logic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition with `isAnyOf`, the ids of the columns `value` lists. Read before `value`, like `columnId`.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.logic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.logic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0","typeLabel":"object"},{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.logic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.logic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.logic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.logic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.logic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1","typeLabel":"object"}],"uniqueKey":"ops.items.[INDEX].oneOf.1.block.logic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.rightOperand","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.logic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0","typeLabel":"object"},{}],"uniqueKey":"ops.items.[INDEX].oneOf.1.block.logic.items.[INDEX].conditions.conditions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.logic.items.[INDEX].conditions.conditions","typeLabel":"object[]"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.logic.items.[INDEX].conditions","typeLabel":"object"},"actions":{"type":"array","items":{"oneOf":[{"type":"object","description":"Logic action. Keep referenced ids stable: `calculate.variableId` points to a variable id,\n`requireAnswer.target` points to an element id, and `jumpToBlock.target` points to a block id\nor ending id. `markLowQuality` takes no target: it marks the response Low quality when the rule fires.\n","required":["id","objective","variableId","operator","value"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.0.id","typeLabel":"string\u003ccuid2>"},"objective":{"type":"string","enum":["calculate"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.0.objective","typeLabel":"enum\u003cstring>"},"variableId":{"type":"string","format":"cuid2","description":"The computed field's `storageKey` (a legacy variable id).","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.0.variableId","typeLabel":"string\u003ccuid2>"},"operator":{"type":"string","enum":["assign","concat","add","subtract","multiply","divide"],"description":"An `expression` value takes `assign` only.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.0.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.0.value.oneOf.1","typeLabel":"number"},{"type":"array","items":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.0.value.oneOf.2.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.0.value.oneOf.2","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.0.value","typeLabel":"string | number | string[]"},"columnId":{"type":"string","minLength":1,"description":"On a matrix row condition, the id of the column. Read before `value` and wins when the two disagree, so the condition survives reordering. Must be a column of the matrix. Optional: when only `value` is sent, the id is filled in from the position on write.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.0.columnId","typeLabel":"string"},"columnIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.0.columnIds.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition with `isAnyOf`, the ids of the columns `value` lists. Read before `value`, like `columnId`.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.0.columnIds","typeLabel":"string[]"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.0","typeLabel":"object"},{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.1","typeLabel":"object"},{"type":"object","description":"The value of a Set value step: an expression tree, evaluated in the respondent's browser without `eval`. Validation refuses text in arithmetic, unknown functions, wrong argument counts, references that don't exist and a result type that doesn't match the target field, each at its exact path (`…value.value.args.1`). Trees are at most 12 levels deep and 200 nodes.\n","required":["type","value"],"example":{"type":"expression","value":{"type":"call","fn":"round","args":[{"type":"call","fn":"add","args":[{"type":"element","value":"q1"},{"type":"call","fn":"multiply","args":[{"type":"element","value":"q2"},{"type":"static","value":2}]}]}]}},"properties":{"type":{"type":"string","enum":["expression"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.2.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"object","description":"One node of a Set value expression: a fixed value, a reference, or a function call.\n\n**Leaves.** `static` is a number or text (a text `2026-03-01` counts as a date where one is expected). `element` is an answer, by element id: rating, NPS, CSAT, CES and number open text are numbers; other open text is text; a date question is a date; a single select yields its answer code as text. Other question types can't be used. `variable` is a computed field and `hiddenField` an ingested field, by storage key, typed by their `dataType`; `reserved` is a reserved field by name.\n\n**Functions** (`call`): `add`, `multiply`, `min`, `max` take 2–50 numbers; `subtract` and `divide` exactly 2 (÷ 0 gives empty); `round` a number and optional fixed decimals (0–10, rounding half away from zero); `abs` 1 number; `ifEmpty` a value and a fallback of the same type; `concat` 2–50 values of any type (numbers and dates become text); `now` none (the device clock as a UTC ISO timestamp); `daysBetween` 2 dates (UTC calendar days from the first to the second, negative allowed).\n\n**Empty values.** An unanswered question or unset field is empty, and so is a value that isn't a number where a number is needed; every function except `ifEmpty` then gives empty.\n","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.2.value.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.2.value.oneOf.0.value.oneOf.0","typeLabel":"number"},{"type":"string","maxLength":5000,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.2.value.oneOf.0.value.oneOf.1","typeLabel":"string"}],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.2.value.oneOf.0.value","typeLabel":"number | string"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.2.value.oneOf.0","typeLabel":"object"},{"type":"object","description":"One node of a Set value expression: a fixed value, a reference, or a function call.\n\n**Leaves.** `static` is a number or text (a text `2026-03-01` counts as a date where one is expected). `element` is an answer, by element id: rating, NPS, CSAT, CES and number open text are numbers; other open text is text; a date question is a date; a single select yields its answer code as text. Other question types can't be used. `variable` is a computed field and `hiddenField` an ingested field, by storage key, typed by their `dataType`; `reserved` is a reserved field by name.\n\n**Functions** (`call`): `add`, `multiply`, `min`, `max` take 2–50 numbers; `subtract` and `divide` exactly 2 (÷ 0 gives empty); `round` a number and optional fixed decimals (0–10, rounding half away from zero); `abs` 1 number; `ifEmpty` a value and a fallback of the same type; `concat` 2–50 values of any type (numbers and dates become text); `now` none (the device clock as a UTC ISO timestamp); `daysBetween` 2 dates (UTC calendar days from the first to the second, negative allowed).\n\n**Empty values.** An unanswered question or unset field is empty, and so is a value that isn't a number where a number is needed; every function except `ifEmpty` then gives empty.\n","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.2.value.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.2.value.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.2.value.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.2.value.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.2.value.oneOf.1","typeLabel":"object"},{"type":"object","description":"One node of a Set value expression: a fixed value, a reference, or a function call.\n\n**Leaves.** `static` is a number or text (a text `2026-03-01` counts as a date where one is expected). `element` is an answer, by element id: rating, NPS, CSAT, CES and number open text are numbers; other open text is text; a date question is a date; a single select yields its answer code as text. Other question types can't be used. `variable` is a computed field and `hiddenField` an ingested field, by storage key, typed by their `dataType`; `reserved` is a reserved field by name.\n\n**Functions** (`call`): `add`, `multiply`, `min`, `max` take 2–50 numbers; `subtract` and `divide` exactly 2 (÷ 0 gives empty); `round` a number and optional fixed decimals (0–10, rounding half away from zero); `abs` 1 number; `ifEmpty` a value and a fallback of the same type; `concat` 2–50 values of any type (numbers and dates become text); `now` none (the device clock as a UTC ISO timestamp); `daysBetween` 2 dates (UTC calendar days from the first to the second, negative allowed).\n\n**Empty values.** An unanswered question or unset field is empty, and so is a value that isn't a number where a number is needed; every function except `ifEmpty` then gives empty.\n","required":["type","fn","args"],"properties":{"type":{"type":"string","enum":["call"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.2.value.oneOf.2.type","typeLabel":"enum\u003cstring>"},"fn":{"type":"string","enum":["add","subtract","multiply","divide","round","min","max","abs","ifEmpty","concat","now","daysBetween"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.2.value.oneOf.2.fn","typeLabel":"enum\u003cstring>"},"args":{"type":"array","maxItems":50,"items":{"$circularRef":"05361453-d19c-419d-9183-f17ee4b34306"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.2.value.oneOf.2.args","typeLabel":"array"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.2.value.oneOf.2","typeLabel":"object"}],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.2.value","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.2","typeLabel":"object"}],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","description":"Logic action. Keep referenced ids stable: `calculate.variableId` points to a variable id,\n`requireAnswer.target` points to an element id, and `jumpToBlock.target` points to a block id\nor ending id. `markLowQuality` takes no target: it marks the response Low quality when the rule fires.\n","required":["id","objective","target"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.1.id","typeLabel":"string\u003ccuid2>"},"objective":{"type":"string","enum":["requireAnswer"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.1.objective","typeLabel":"enum\u003cstring>"},"target":{"type":"string","description":"Target element id.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.1.target","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.1","typeLabel":"object"},{"type":"object","description":"Logic action. Keep referenced ids stable: `calculate.variableId` points to a variable id,\n`requireAnswer.target` points to an element id, and `jumpToBlock.target` points to a block id\nor ending id. `markLowQuality` takes no target: it marks the response Low quality when the rule fires.\n","required":["id","objective","target"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.2.id","typeLabel":"string\u003ccuid2>"},"objective":{"type":"string","enum":["jumpToBlock"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.2.objective","typeLabel":"enum\u003cstring>"},"target":{"type":"string","format":"cuid2","description":"Target block id or ending id.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.2.target","typeLabel":"string\u003ccuid2>"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.2","typeLabel":"object"},{"type":"object","description":"Logic action. Keep referenced ids stable: `calculate.variableId` points to a variable id,\n`requireAnswer.target` points to an element id, and `jumpToBlock.target` points to a block id\nor ending id. `markLowQuality` takes no target: it marks the response Low quality when the rule fires.\n","required":["id","objective"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.3.id","typeLabel":"string\u003ccuid2>"},"objective":{"type":"string","enum":["markLowQuality"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.3.objective","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.logic.items.[INDEX].actions.items.[INDEX].oneOf.3","typeLabel":"object"}],"uniqueKey":"ops.items.[INDEX].oneOf.1.block.logic.items.[INDEX].actions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.logic.items.[INDEX].actions","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.logic.items.[INDEX]","typeLabel":"object"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.logic","typeLabel":"object[]"},"logicFallback":{"type":"string","format":"cuid2","description":"Block or ending id used when no logic condition matches. Only valid when this same block\nhas at least one `logic` rule; omit it for normal sequential flow.\n","uniqueKey":"ops.items.[INDEX].oneOf.1.block.logicFallback","typeLabel":"string\u003ccuid2>"},"showIf":{"type":"object","description":"Show-if: the block is shown only when this condition group matches. A block whose show-if fails is skipped, and its `logic` still runs as if the block were submitted with no answers. A block whose elements are all hidden by their show-if is skipped the same way. Conditions use the same operands and operators as `logic`. Reference rule: a block's show-if may use answers from earlier blocks only (plus hidden fields, variables and reserved fields); a violation fails with `misordered_reference` at the exact condition path. Omit it, or send an empty group, for a block that is always shown.","required":["id","connector","conditions"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.showIf.id","typeLabel":"string\u003ccuid2>"},"connector":{"type":"string","enum":["and","or"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.showIf.connector","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","items":{"oneOf":[{"type":"object","description":"Single condition. Operators such as `isSubmitted`, `isSkipped`, `isClicked`, `isAccepted`,\n`isBooked`, `isSet`, and `isEmpty` do not use `rightOperand`; comparison operators do.\n","required":["id","leftOperand","operator"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.showIf.conditions.items.[INDEX].oneOf.0.id","typeLabel":"string\u003ccuid2>"},"leftOperand":{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.showIf.conditions.items.[INDEX].oneOf.0.leftOperand","typeLabel":"object"},"operator":{"type":"string","enum":["equals","doesNotEqual","contains","doesNotContain","startsWith","doesNotStartWith","endsWith","doesNotEndWith","isSubmitted","isSkipped","isGreaterThan","isLessThan","isGreaterThanOrEqual","isLessThanOrEqual","equalsOneOf","includesAllOf","includesOneOf","doesNotIncludeOneOf","doesNotIncludeAllOf","isClicked","isNotClicked","isAccepted","isBefore","isAfter","isBooked","isPartiallySubmitted","isCompletelySubmitted","isSet","isNotSet","isEmpty","isNotEmpty","isAnyOf"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.showIf.conditions.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"rightOperand":{"oneOf":[{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.1","typeLabel":"number"},{"type":"array","items":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value","typeLabel":"string | number | string[]"},"columnId":{"type":"string","minLength":1,"description":"On a matrix row condition, the id of the column. Read before `value` and wins when the two disagree, so the condition survives reordering. Must be a column of the matrix. Optional: when only `value` is sent, the id is filled in from the position on write.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnId","typeLabel":"string"},"columnIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition with `isAnyOf`, the ids of the columns `value` lists. Read before `value`, like `columnId`.","uniqueKey":"ops.items.[INDEX].oneOf.1.block.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0","typeLabel":"object"},{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1","typeLabel":"object"}],"uniqueKey":"ops.items.[INDEX].oneOf.1.block.showIf.conditions.items.[INDEX].oneOf.0.rightOperand","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.showIf.conditions.items.[INDEX].oneOf.0","typeLabel":"object"},{}],"uniqueKey":"ops.items.[INDEX].oneOf.1.block.showIf.conditions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.showIf.conditions","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1.block.showIf","typeLabel":"object"},"buttonLabel":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.buttonLabel.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.buttonLabel","typeLabel":"object"},"backButtonLabel":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"ops.items.[INDEX].oneOf.1.block.backButtonLabel.additionalProperties","typeLabel":"string"},"uniqueKey":"ops.items.[INDEX].oneOf.1.block.backButtonLabel","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.block","typeLabel":"object"},"position":{"oneOf":[{"type":"object","description":"Where an inserted block goes. Anchored to a block id, never to a positional index.","required":["type"],"properties":{"type":{"type":"string","enum":["start"],"description":"Insert before every existing block.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.position.oneOf.0.type","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.position.oneOf.0","typeLabel":"object"},{"type":"object","description":"Where an inserted block goes. Anchored to a block id, never to a positional index.","required":["type"],"properties":{"type":{"type":"string","enum":["end"],"description":"Insert after every existing block.","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.position.oneOf.1.type","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.position.oneOf.1","typeLabel":"object"},{"type":"object","description":"Where an inserted block goes. Anchored to a block id, never to a positional index.","required":["type","blockId"],"properties":{"type":{"type":"string","enum":["after"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.position.oneOf.2.type","typeLabel":"enum\u003cstring>"},"blockId":{"type":"string","maxLength":128,"minLength":1,"description":"Block to insert after. May be a block inserted by an earlier operation in the same request, since operations are applied in order.\n","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.position.oneOf.2.blockId","typeLabel":"string"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.position.oneOf.2","typeLabel":"object"}],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.1.position","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.1","typeLabel":"object"},{"type":"object","description":"A single block operation.","required":["op","id"],"properties":{"op":{"type":"string","enum":["remove"],"isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.2.op","typeLabel":"enum\u003cstring>"},"id":{"type":"string","maxLength":128,"minLength":1,"description":"Block to delete, along with every element in it. Answers already collected for those elements are orphaned and the API cannot undo that.\n","isRequired":true,"uniqueKey":"ops.items.[INDEX].oneOf.2.id","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"ops.items.[INDEX].oneOf.2","typeLabel":"object"}],"uniqueKey":"ops.items.[INDEX]","typeLabel":"object"},"description":"Operations applied in order against a single snapshot, atomically — either all of them land or none do. Each operation resolves against the state left by the previous one, so an insert may anchor after a block an earlier operation inserted, and a remove followed by an insert of the same id is legal.\n","isRequired":true,"uniqueKey":"ops","typeLabel":"object[]"},"expectedUpdatedAt":{"type":"string","format":"date-time","description":"Optimistic-concurrency precondition: the survey's `updatedAt` from your last read. If the survey changed since, the write is rejected with **409** and the response carries the current value. Omit it to accept last-write-wins.\n","uniqueKey":"expectedUpdatedAt","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"","typeLabel":"object"},"examples":{"updateOneBlock":{"title":"updateOneBlock","summary":"Replace a single block","value":{"ops":[{"op":"update","id":"k1p9wq2m4x7c3v8b5n6t0j2r","block":{"id":"k1p9wq2m4x7c3v8b5n6t0j2r","name":"Satisfaction","elements":[{"id":"satisfaction","type":"openText","headline":{"en-US":"How satisfied were you?"},"required":true,"inputType":"text"}]}}],"expectedUpdatedAt":"2026-04-21T10:00:00.000Z"}},"insertAndRemove":{"title":"insertAndRemove","summary":"Add a block after another and drop a third","value":{"ops":[{"op":"insert","position":{"type":"after","blockId":"k1p9wq2m4x7c3v8b5n6t0j2r"},"block":{"id":"b4h8s2d6f0g3j5k7l9z1x3c5","name":"Follow-up","elements":[{"id":"followup","type":"openText","headline":{"en-US":"Anything else?"},"required":false,"inputType":"text"}]}},{"op":"remove","id":"n7m4q8w2e6r0t3y5u1i9o2p4"}]}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"4f16c5f3-15b6-4bbb-aac7-2060415a8bb8":{"description":"Blocks updated; returns the full survey resource.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Request correlation ID"},"Cache-Control":{"schema":{"type":"string"},"example":"private, no-store"}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","description":"The three fields every `SurveyListItem` and `SurveyResource` carries, merged into both via `allOf`. All required, always present.","required":["visibility","owner","access","id","workspaceId","createdAt","updatedAt","archivedAt","name","type","status","metadata","defaultLanguage","languages","showLanguageSwitch","autoSelectLanguage","welcomeCard","blocks","endings","hiddenFields","variables","startLogic","embeddedFields","customCss"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"data.id","typeLabel":"string"},"workspaceId":{"type":"string","isRequired":true,"uniqueKey":"data.workspaceId","typeLabel":"string"},"createdAt":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"data.createdAt","typeLabel":"string\u003cdate-time>"},"updatedAt":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"data.updatedAt","typeLabel":"string\u003cdate-time>"},"archivedAt":{"oneOf":[{"type":"string","format":"date-time","description":"Soft-delete/archive marker (ISO 8601); `null` when the survey is active.","isRequired":true,"uniqueKey":"data.archivedAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"Soft-delete/archive marker (ISO 8601); `null` when the survey is active.","isRequired":true,"uniqueKey":"data.archivedAt.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.archivedAt","typeLabel":"string\u003cdate-time> | null"},"name":{"type":"string","isRequired":true,"uniqueKey":"data.name","typeLabel":"string"},"type":{"type":"string","enum":["link","app"],"isRequired":true,"uniqueKey":"data.type","typeLabel":"enum\u003cstring>"},"status":{"type":"string","enum":["draft","inProgress","paused","completed"],"isRequired":true,"uniqueKey":"data.status","typeLabel":"enum\u003cstring>"},"metadata":{"oneOf":[{"type":"object","description":"Arbitrary JSON survey context for customer- or operation-specific metadata. v3 preserves\narbitrary metadata values as-is. If present, `title` and `description` are treated as\ntranslatable text maps and returned with real locale-code keys.\n","properties":{"title":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.metadata.oneOf.0.title.additionalProperties","typeLabel":"string"},"uniqueKey":"data.metadata.oneOf.0.title","typeLabel":"object"},"description":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.metadata.oneOf.0.description.additionalProperties","typeLabel":"string"},"uniqueKey":"data.metadata.oneOf.0.description","typeLabel":"object"}},"additionalProperties":true,"isRequired":true,"uniqueKey":"data.metadata.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"data.metadata.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.metadata","typeLabel":"object | null"},"defaultLanguage":{"type":"string","description":"Emitted language code/tag for the survey default language. The internal `default` translation key is never exposed.","isRequired":true,"uniqueKey":"data.defaultLanguage","typeLabel":"string"},"languages":{"type":"array","items":{"type":"object","description":"Language configured for this survey. GET responses expose the server-emitted code/tag used as the\ntranslatable map key. Existing surveys can use region-qualified, language-only, or script-only codes.\nDisabled languages can still be read by the management API so unfinished translations can be completed.\n","required":["code","default","enabled"],"properties":{"code":{"type":"string","description":"Server-emitted survey language code/tag used as the translatable map key.","example":"en-US","isRequired":true,"uniqueKey":"data.languages.items.[INDEX].code","typeLabel":"string"},"default":{"type":"boolean","description":"Whether this is the default authoring language.","isRequired":true,"uniqueKey":"data.languages.items.[INDEX].default","typeLabel":"boolean"},"enabled":{"type":"boolean","description":"Whether this language is enabled for respondent-facing delivery.","isRequired":true,"uniqueKey":"data.languages.items.[INDEX].enabled","typeLabel":"boolean"},"alias":{"oneOf":[{"type":"string","description":"Optional configured alias accepted by `?lang` for compatibility and agent discovery.","example":"english","uniqueKey":"data.languages.items.[INDEX].alias.oneOf.0","typeLabel":"string"},{"type":"null","description":"Optional configured alias accepted by `?lang` for compatibility and agent discovery.","example":"english","uniqueKey":"data.languages.items.[INDEX].alias.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.languages.items.[INDEX].alias","typeLabel":"string | null"}},"uniqueKey":"data.languages.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.languages","typeLabel":"object[]"},"showLanguageSwitch":{"oneOf":[{"type":"boolean","description":"Show respondents a language switch on multi-language surveys. `null` and `false` both mean off.","isRequired":true,"uniqueKey":"data.showLanguageSwitch.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"Show respondents a language switch on multi-language surveys. `null` and `false` both mean off.","isRequired":true,"uniqueKey":"data.showLanguageSwitch.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.showLanguageSwitch","typeLabel":"boolean | null"},"autoSelectLanguage":{"oneOf":[{"type":"boolean","description":"Open link and app surveys in the respondent's browser language when it matches an enabled survey language; otherwise the default language is used. `null` and `false` both mean off.","isRequired":true,"uniqueKey":"data.autoSelectLanguage.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"Open link and app surveys in the respondent's browser language when it matches an enabled survey language; otherwise the default language is used. `null` and `false` both mean off.","isRequired":true,"uniqueKey":"data.autoSelectLanguage.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.autoSelectLanguage","typeLabel":"boolean | null"},"welcomeCard":{"type":"object","description":"Optional card shown before the first survey block.","required":["enabled"],"properties":{"enabled":{"type":"boolean","isRequired":true,"uniqueKey":"data.welcomeCard.enabled","typeLabel":"boolean"},"headline":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.welcomeCard.headline.additionalProperties","typeLabel":"string"},"uniqueKey":"data.welcomeCard.headline","typeLabel":"object"},"subheader":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.welcomeCard.subheader.additionalProperties","typeLabel":"string"},"uniqueKey":"data.welcomeCard.subheader","typeLabel":"object"},"buttonLabel":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.welcomeCard.buttonLabel.additionalProperties","typeLabel":"string"},"uniqueKey":"data.welcomeCard.buttonLabel","typeLabel":"object"},"fileUrl":{"type":"string","uniqueKey":"data.welcomeCard.fileUrl","typeLabel":"string"},"videoUrl":{"type":"string","uniqueKey":"data.welcomeCard.videoUrl","typeLabel":"string"},"timeToFinish":{"type":"boolean","uniqueKey":"data.welcomeCard.timeToFinish","typeLabel":"boolean"},"showResponseCount":{"type":"boolean","uniqueKey":"data.welcomeCard.showResponseCount","typeLabel":"boolean"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.welcomeCard","typeLabel":"object"},"blocks":{"type":"array","items":{"type":"object","description":"Block-based survey section. Block ids are stable public identifiers. Logic and fallbacks can\njump to block ids or ending ids, so clients and agents should preserve ids unless intentionally\ncreating/deleting a block.\n","required":["id","name","elements"],"properties":{"id":{"type":"string","format":"cuid2","description":"Stable block id.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].id","typeLabel":"string\u003ccuid2>"},"name":{"type":"string","minLength":1,"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].name","typeLabel":"string"},"elements":{"type":"array","minItems":1,"items":{"oneOf":[{"type":"object","description":"Survey element/question inside a block. Element ids are stable public identifiers used by\nlogic, recall strings, response data, quotas, integrations, and analysis. `type` selects the\nallowed shape; unsupported fields are rejected instead of ignored.\n","required":["id","type","headline","required"],"properties":{"id":{"type":"string","pattern":"^[a-zA-Z0-9_-]+$","description":"Stable element id. Avoid spaces and reserved ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.0.id","typeLabel":"string"},"type":{"type":"string","enum":["openText"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.0.type","typeLabel":"enum\u003cstring>"},"headline":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.0.headline.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.0.headline","typeLabel":"object"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.0.required","typeLabel":"boolean"},"subheader":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.0.subheader.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.0.subheader","typeLabel":"object"},"imageUrl":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.0.imageUrl","typeLabel":"string"},"imageAltText":{"type":"object","description":"Text alternative for `imageUrl`, read by screen readers. Omit or leave empty for a decorative image (rendered as `alt=\"\"`).","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.0.imageAltText.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.0.imageAltText","typeLabel":"object"},"videoUrl":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.0.videoUrl","typeLabel":"string"},"isDraft":{"type":"boolean","description":"Draft marker used by the editor and future update rules.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.0.isDraft","typeLabel":"boolean"},"showIf":{"type":"object","description":"Show-if: the element is shown only when this condition group matches, re-evaluated live as answers above it on the same page change. A hidden element is not validated (a hidden required element never blocks submission) and its answer is not submitted. Conditions use the same operands and operators as block `logic`. Reference rule: an element's show-if may use answers from earlier blocks and from elements above it in the same block, never itself or anything below it; a violation fails with `misordered_reference` at the exact condition path. Omit it, or send an empty group, for an element that is always shown.","required":["id","connector","conditions"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.0.showIf.id","typeLabel":"string\u003ccuid2>"},"connector":{"type":"string","enum":["and","or"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.0.showIf.connector","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","items":{"oneOf":[{"type":"object","description":"Single condition. Operators such as `isSubmitted`, `isSkipped`, `isClicked`, `isAccepted`,\n`isBooked`, `isSet`, and `isEmpty` do not use `rightOperand`; comparison operators do.\n","required":["id","leftOperand","operator"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.0.showIf.conditions.items.[INDEX].oneOf.0.id","typeLabel":"string\u003ccuid2>"},"leftOperand":{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.0.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.0.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.0.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.0.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.0.showIf.conditions.items.[INDEX].oneOf.0.leftOperand","typeLabel":"object"},"operator":{"type":"string","enum":["equals","doesNotEqual","contains","doesNotContain","startsWith","doesNotStartWith","endsWith","doesNotEndWith","isSubmitted","isSkipped","isGreaterThan","isLessThan","isGreaterThanOrEqual","isLessThanOrEqual","equalsOneOf","includesAllOf","includesOneOf","doesNotIncludeOneOf","doesNotIncludeAllOf","isClicked","isNotClicked","isAccepted","isBefore","isAfter","isBooked","isPartiallySubmitted","isCompletelySubmitted","isSet","isNotSet","isEmpty","isNotEmpty","isAnyOf"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.0.showIf.conditions.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"rightOperand":{"oneOf":[{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.0.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.0.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.0.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.1","typeLabel":"number"},{"type":"array","items":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.0.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.0.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.0.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value","typeLabel":"string | number | string[]"},"columnId":{"type":"string","minLength":1,"description":"On a matrix row condition, the id of the column. Read before `value` and wins when the two disagree, so the condition survives reordering. Must be a column of the matrix. Optional: when only `value` is sent, the id is filled in from the position on write.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.0.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnId","typeLabel":"string"},"columnIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.0.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition with `isAnyOf`, the ids of the columns `value` lists. Read before `value`, like `columnId`.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.0.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.0.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0","typeLabel":"object"},{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.0.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.0.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.0.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.0.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.0.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1","typeLabel":"object"}],"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.0.showIf.conditions.items.[INDEX].oneOf.0.rightOperand","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.0.showIf.conditions.items.[INDEX].oneOf.0","typeLabel":"object"},{}],"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.0.showIf.conditions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.0.showIf.conditions","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.0.showIf","typeLabel":"object"},"code":{"type":"string","maxLength":30,"pattern":"^[a-z][a-z0-9_]*$","description":"Question code, the name the question carries in exports, webhooks and links. Optional. Starts with a lowercase letter, then lowercase letters, digits and `_`; no `__`, no trailing `_`, at most 30 characters. It must not be an SPSS reserved word (`all`, `and`, `by`, `eq`, `ge`, `gt`, `le`, `lt`, `ne`, `not`, `or`, `to`, `with`) or an export column name (`response_id`, `language`, `outcome`, ...), and must be unique among the survey's question codes, Embedded Data names and the Question IDs of other questions, ignoring case. CTA elements have no code.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.0.code","typeLabel":"string"},"placeholder":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.0.placeholder.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.0.placeholder","typeLabel":"object"},"longAnswer":{"type":"boolean","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.0.longAnswer","typeLabel":"boolean"},"inputType":{"type":"string","enum":["text","email","url","number","phone"],"default":"text","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.0.inputType","typeLabel":"enum\u003cstring>"},"insightsEnabled":{"type":"boolean","default":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.0.insightsEnabled","typeLabel":"boolean"},"charLimit":{"type":"object","description":"Optional `openText` character limit configuration.","properties":{"enabled":{"type":"boolean","default":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.0.charLimit.enabled","typeLabel":"boolean"},"min":{"type":"number","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.0.charLimit.min","typeLabel":"number"},"max":{"type":"number","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.0.charLimit.max","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.0.charLimit","typeLabel":"object"},"validation":{"type":"object","description":"Optional element-level validation rules.","required":["rules"],"properties":{"rules":{"type":"array","items":{"type":"object","required":["id","type","params"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.0.validation.rules.items.[INDEX].id","typeLabel":"string"},"type":{"type":"string","enum":["minLength","maxLength","pattern","email","url","phone","equals","doesNotEqual","contains","doesNotContain","minValue","maxValue","isGreaterThan","isLessThan","minSelections","maxSelections","minRanked","rankAll","minRowsAnswered","answerAllRows","isLaterThan","isEarlierThan","isBetween","isNotBetween","fileExtensionIs","fileExtensionIsNot"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.0.validation.rules.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"params":{"type":"object","additionalProperties":true,"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.0.validation.rules.items.[INDEX].params","typeLabel":"object"},"field":{"type":"string","enum":["addressLine1","addressLine2","city","state","zip","country","firstName","lastName","email","phone","company"],"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.0.validation.rules.items.[INDEX].field","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.0.validation.rules.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.0.validation.rules","typeLabel":"object[]"},"logic":{"type":"string","enum":["and","or"],"default":"and","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.0.validation.logic","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.0.validation","typeLabel":"object"}},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","description":"Survey element/question inside a block. Element ids are stable public identifiers used by\nlogic, recall strings, response data, quotas, integrations, and analysis. `type` selects the\nallowed shape; unsupported fields are rejected instead of ignored.\n","required":["label","id","type","headline","required"],"properties":{"id":{"type":"string","pattern":"^[a-zA-Z0-9_-]+$","description":"Stable element id. Avoid spaces and reserved ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.1.id","typeLabel":"string"},"type":{"type":"string","enum":["consent"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.1.type","typeLabel":"enum\u003cstring>"},"headline":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.1.headline.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.1.headline","typeLabel":"object"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.1.required","typeLabel":"boolean"},"label":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.1.label.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.1.label","typeLabel":"object"},"subheader":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.1.subheader.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.1.subheader","typeLabel":"object"},"imageUrl":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.1.imageUrl","typeLabel":"string"},"imageAltText":{"type":"object","description":"Text alternative for `imageUrl`, read by screen readers. Omit or leave empty for a decorative image (rendered as `alt=\"\"`).","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.1.imageAltText.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.1.imageAltText","typeLabel":"object"},"videoUrl":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.1.videoUrl","typeLabel":"string"},"isDraft":{"type":"boolean","description":"Draft marker used by the editor and future update rules.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.1.isDraft","typeLabel":"boolean"},"showIf":{"type":"object","description":"Show-if: the element is shown only when this condition group matches, re-evaluated live as answers above it on the same page change. A hidden element is not validated (a hidden required element never blocks submission) and its answer is not submitted. Conditions use the same operands and operators as block `logic`. Reference rule: an element's show-if may use answers from earlier blocks and from elements above it in the same block, never itself or anything below it; a violation fails with `misordered_reference` at the exact condition path. Omit it, or send an empty group, for an element that is always shown.","required":["id","connector","conditions"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.1.showIf.id","typeLabel":"string\u003ccuid2>"},"connector":{"type":"string","enum":["and","or"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.1.showIf.connector","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","items":{"oneOf":[{"type":"object","description":"Single condition. Operators such as `isSubmitted`, `isSkipped`, `isClicked`, `isAccepted`,\n`isBooked`, `isSet`, and `isEmpty` do not use `rightOperand`; comparison operators do.\n","required":["id","leftOperand","operator"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.1.showIf.conditions.items.[INDEX].oneOf.0.id","typeLabel":"string\u003ccuid2>"},"leftOperand":{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.1.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.1.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.1.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.1.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.1.showIf.conditions.items.[INDEX].oneOf.0.leftOperand","typeLabel":"object"},"operator":{"type":"string","enum":["equals","doesNotEqual","contains","doesNotContain","startsWith","doesNotStartWith","endsWith","doesNotEndWith","isSubmitted","isSkipped","isGreaterThan","isLessThan","isGreaterThanOrEqual","isLessThanOrEqual","equalsOneOf","includesAllOf","includesOneOf","doesNotIncludeOneOf","doesNotIncludeAllOf","isClicked","isNotClicked","isAccepted","isBefore","isAfter","isBooked","isPartiallySubmitted","isCompletelySubmitted","isSet","isNotSet","isEmpty","isNotEmpty","isAnyOf"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.1.showIf.conditions.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"rightOperand":{"oneOf":[{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.1.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.1.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.1.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.1","typeLabel":"number"},{"type":"array","items":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.1.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.1.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.1.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value","typeLabel":"string | number | string[]"},"columnId":{"type":"string","minLength":1,"description":"On a matrix row condition, the id of the column. Read before `value` and wins when the two disagree, so the condition survives reordering. Must be a column of the matrix. Optional: when only `value` is sent, the id is filled in from the position on write.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.1.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnId","typeLabel":"string"},"columnIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.1.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition with `isAnyOf`, the ids of the columns `value` lists. Read before `value`, like `columnId`.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.1.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.1.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0","typeLabel":"object"},{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.1.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.1.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.1.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.1.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.1.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1","typeLabel":"object"}],"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.1.showIf.conditions.items.[INDEX].oneOf.0.rightOperand","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.1.showIf.conditions.items.[INDEX].oneOf.0","typeLabel":"object"},{}],"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.1.showIf.conditions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.1.showIf.conditions","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.1.showIf","typeLabel":"object"},"code":{"type":"string","maxLength":30,"pattern":"^[a-z][a-z0-9_]*$","description":"Question code, the name the question carries in exports, webhooks and links. Optional. Starts with a lowercase letter, then lowercase letters, digits and `_`; no `__`, no trailing `_`, at most 30 characters. It must not be an SPSS reserved word (`all`, `and`, `by`, `eq`, `ge`, `gt`, `le`, `lt`, `ne`, `not`, `or`, `to`, `with`) or an export column name (`response_id`, `language`, `outcome`, ...), and must be unique among the survey's question codes, Embedded Data names and the Question IDs of other questions, ignoring case. CTA elements have no code.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.1.code","typeLabel":"string"},"validation":{"type":"object","description":"Optional element-level validation rules.","required":["rules"],"properties":{"rules":{"type":"array","items":{"type":"object","required":["id","type","params"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.1.validation.rules.items.[INDEX].id","typeLabel":"string"},"type":{"type":"string","enum":["minLength","maxLength","pattern","email","url","phone","equals","doesNotEqual","contains","doesNotContain","minValue","maxValue","isGreaterThan","isLessThan","minSelections","maxSelections","minRanked","rankAll","minRowsAnswered","answerAllRows","isLaterThan","isEarlierThan","isBetween","isNotBetween","fileExtensionIs","fileExtensionIsNot"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.1.validation.rules.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"params":{"type":"object","additionalProperties":true,"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.1.validation.rules.items.[INDEX].params","typeLabel":"object"},"field":{"type":"string","enum":["addressLine1","addressLine2","city","state","zip","country","firstName","lastName","email","phone","company"],"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.1.validation.rules.items.[INDEX].field","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.1.validation.rules.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.1.validation.rules","typeLabel":"object[]"},"logic":{"type":"string","enum":["and","or"],"default":"and","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.1.validation.logic","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.1.validation","typeLabel":"object"}},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.1","typeLabel":"object"},{"type":"object","description":"Survey element/question inside a block. Element ids are stable public identifiers used by\nlogic, recall strings, response data, quotas, integrations, and analysis. `type` selects the\nallowed shape; unsupported fields are rejected instead of ignored.\n","required":["choices","id","type","headline","required"],"properties":{"id":{"type":"string","pattern":"^[a-zA-Z0-9_-]+$","description":"Stable element id. Avoid spaces and reserved ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.2.id","typeLabel":"string"},"type":{"type":"string","enum":["multipleChoiceSingle"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.2.type","typeLabel":"enum\u003cstring>"},"headline":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.2.headline.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.2.headline","typeLabel":"object"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.2.required","typeLabel":"boolean"},"choices":{"type":"array","minItems":2,"items":{"type":"object","required":["id","label"],"properties":{"id":{"type":"string","description":"Stable choice id.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.2.choices.items.[INDEX].id","typeLabel":"string"},"label":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.2.choices.items.[INDEX].label.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.2.choices.items.[INDEX].label","typeLabel":"object"},"code":{"type":"string","maxLength":20,"pattern":"^[a-z0-9][a-z0-9_]*$","description":"Answer code of an option, a matrix row or a matrix column. Optional. Lowercase letters, digits and `_`; it may start with a digit, but not with `_`; no `__`, no trailing `_`, at most 20 characters. It must not be an SPSS reserved word or an export column name, and must be unique within its question (a matrix's rows and columns are checked separately), ignoring case.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.2.choices.items.[INDEX].code","typeLabel":"string"},"showIf":{"type":"object","description":"Option show-if: the option (or matrix row or column) is offered only when this condition group matches, re-evaluated live as earlier answers change. It may use what its element's show-if may use: answers from earlier blocks and from elements above its element in the same block, never its own element or anything below (`misordered_reference` at the exact condition path). A question left with no option to offer is skipped and recorded as not shown. Omit it, or send an empty group, for an option that is always offered. Allowed on published surveys.","required":["id","connector","conditions"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf.id","typeLabel":"string\u003ccuid2>"},"connector":{"type":"string","enum":["and","or"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf.connector","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","items":{"oneOf":[{"type":"object","description":"Single condition. Operators such as `isSubmitted`, `isSkipped`, `isClicked`, `isAccepted`,\n`isBooked`, `isSet`, and `isEmpty` do not use `rightOperand`; comparison operators do.\n","required":["id","leftOperand","operator"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.id","typeLabel":"string\u003ccuid2>"},"leftOperand":{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand","typeLabel":"object"},"operator":{"type":"string","enum":["equals","doesNotEqual","contains","doesNotContain","startsWith","doesNotStartWith","endsWith","doesNotEndWith","isSubmitted","isSkipped","isGreaterThan","isLessThan","isGreaterThanOrEqual","isLessThanOrEqual","equalsOneOf","includesAllOf","includesOneOf","doesNotIncludeOneOf","doesNotIncludeAllOf","isClicked","isNotClicked","isAccepted","isBefore","isAfter","isBooked","isPartiallySubmitted","isCompletelySubmitted","isSet","isNotSet","isEmpty","isNotEmpty","isAnyOf"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"rightOperand":{"oneOf":[{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.1","typeLabel":"number"},{"type":"array","items":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value","typeLabel":"string | number | string[]"},"columnId":{"type":"string","minLength":1,"description":"On a matrix row condition, the id of the column. Read before `value` and wins when the two disagree, so the condition survives reordering. Must be a column of the matrix. Optional: when only `value` is sent, the id is filled in from the position on write.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnId","typeLabel":"string"},"columnIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition with `isAnyOf`, the ids of the columns `value` lists. Read before `value`, like `columnId`.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0","typeLabel":"object"},{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1","typeLabel":"object"}],"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0","typeLabel":"object"},{}],"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf.conditions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf.conditions","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.2.choices.items.[INDEX].showIf","typeLabel":"object"},"hidden":{"type":"boolean","description":"Hidden: the option is never offered, whatever its `showIf` says, and is recorded as not shown. Use it to retire an option on a published survey instead of deleting it (deleting an option that existed at launch is refused): it keeps its id, answer code and earlier answers, and stays in results labelled Hidden.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.2.choices.items.[INDEX].hidden","typeLabel":"boolean"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.2.choices.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.2.choices","typeLabel":"object[]"},"subheader":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.2.subheader.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.2.subheader","typeLabel":"object"},"imageUrl":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.2.imageUrl","typeLabel":"string"},"imageAltText":{"type":"object","description":"Text alternative for `imageUrl`, read by screen readers. Omit or leave empty for a decorative image (rendered as `alt=\"\"`).","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.2.imageAltText.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.2.imageAltText","typeLabel":"object"},"videoUrl":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.2.videoUrl","typeLabel":"string"},"isDraft":{"type":"boolean","description":"Draft marker used by the editor and future update rules.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.2.isDraft","typeLabel":"boolean"},"showIf":{"type":"object","description":"Show-if: the element is shown only when this condition group matches, re-evaluated live as answers above it on the same page change. A hidden element is not validated (a hidden required element never blocks submission) and its answer is not submitted. Conditions use the same operands and operators as block `logic`. Reference rule: an element's show-if may use answers from earlier blocks and from elements above it in the same block, never itself or anything below it; a violation fails with `misordered_reference` at the exact condition path. Omit it, or send an empty group, for an element that is always shown.","required":["id","connector","conditions"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.2.showIf.id","typeLabel":"string\u003ccuid2>"},"connector":{"type":"string","enum":["and","or"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.2.showIf.connector","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","items":{"oneOf":[{"type":"object","description":"Single condition. Operators such as `isSubmitted`, `isSkipped`, `isClicked`, `isAccepted`,\n`isBooked`, `isSet`, and `isEmpty` do not use `rightOperand`; comparison operators do.\n","required":["id","leftOperand","operator"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.2.showIf.conditions.items.[INDEX].oneOf.0.id","typeLabel":"string\u003ccuid2>"},"leftOperand":{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.2.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.2.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.2.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.2.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.2.showIf.conditions.items.[INDEX].oneOf.0.leftOperand","typeLabel":"object"},"operator":{"type":"string","enum":["equals","doesNotEqual","contains","doesNotContain","startsWith","doesNotStartWith","endsWith","doesNotEndWith","isSubmitted","isSkipped","isGreaterThan","isLessThan","isGreaterThanOrEqual","isLessThanOrEqual","equalsOneOf","includesAllOf","includesOneOf","doesNotIncludeOneOf","doesNotIncludeAllOf","isClicked","isNotClicked","isAccepted","isBefore","isAfter","isBooked","isPartiallySubmitted","isCompletelySubmitted","isSet","isNotSet","isEmpty","isNotEmpty","isAnyOf"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.2.showIf.conditions.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"rightOperand":{"oneOf":[{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.2.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.2.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.2.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.1","typeLabel":"number"},{"type":"array","items":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.2.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.2.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.2.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value","typeLabel":"string | number | string[]"},"columnId":{"type":"string","minLength":1,"description":"On a matrix row condition, the id of the column. Read before `value` and wins when the two disagree, so the condition survives reordering. Must be a column of the matrix. Optional: when only `value` is sent, the id is filled in from the position on write.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.2.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnId","typeLabel":"string"},"columnIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.2.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition with `isAnyOf`, the ids of the columns `value` lists. Read before `value`, like `columnId`.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.2.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.2.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0","typeLabel":"object"},{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.2.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.2.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.2.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.2.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.2.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1","typeLabel":"object"}],"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.2.showIf.conditions.items.[INDEX].oneOf.0.rightOperand","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.2.showIf.conditions.items.[INDEX].oneOf.0","typeLabel":"object"},{}],"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.2.showIf.conditions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.2.showIf.conditions","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.2.showIf","typeLabel":"object"},"code":{"type":"string","maxLength":30,"pattern":"^[a-z][a-z0-9_]*$","description":"Question code, the name the question carries in exports, webhooks and links. Optional. Starts with a lowercase letter, then lowercase letters, digits and `_`; no `__`, no trailing `_`, at most 30 characters. It must not be an SPSS reserved word (`all`, `and`, `by`, `eq`, `ge`, `gt`, `le`, `lt`, `ne`, `not`, `or`, `to`, `with`) or an export column name (`response_id`, `language`, `outcome`, ...), and must be unique among the survey's question codes, Embedded Data names and the Question IDs of other questions, ignoring case. CTA elements have no code.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.2.code","typeLabel":"string"},"optionsCopiedFrom":{"type":"string","minLength":1,"description":"Copied options: the id of an earlier element whose options this element copies (\"only the brands you know\"). Choices copy from a single select, multi select or ranking; pictures from a picture selection (matrix rows are not copied: give rows a `showIf` on the source instead). Write the copies yourself: each copied option keeps the source option's `id` and `code`, and carries a `showIf` \"picked in the source\" (`includesOneOf` with its own id, or `equals` when the source is a single select), so the element offers exactly the options picked there. Copied codes follow the source's: a code sent for a copy is replaced by the source option's. Fixed options next to the copies (such as \"None of these\", id `none`) get the next code free in every linked element. The source must exist (`dangling_reference`), sit in an earlier block or above this element on its block (`misordered_reference`), and have options of the same kind (`invalid_reference`). To bring in options the source gained later, add them the same way.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.2.optionsCopiedFrom","typeLabel":"string"},"shuffleOption":{"type":"string","enum":["none","all","exceptLast","reverseOrderOccasionally","reverseOrderExceptLast"],"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.2.shuffleOption","typeLabel":"enum\u003cstring>"},"otherOptionPlaceholder":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.2.otherOptionPlaceholder.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.2.otherOptionPlaceholder","typeLabel":"object"},"displayType":{"type":"string","enum":["list","row","dropdown"],"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.2.displayType","typeLabel":"enum\u003cstring>"}},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.2","typeLabel":"object"},{"type":"object","description":"Survey element/question inside a block. Element ids are stable public identifiers used by\nlogic, recall strings, response data, quotas, integrations, and analysis. `type` selects the\nallowed shape; unsupported fields are rejected instead of ignored.\n","required":["choices","id","type","headline","required"],"properties":{"id":{"type":"string","pattern":"^[a-zA-Z0-9_-]+$","description":"Stable element id. Avoid spaces and reserved ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.id","typeLabel":"string"},"type":{"type":"string","enum":["multipleChoiceMulti"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.type","typeLabel":"enum\u003cstring>"},"headline":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.headline.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.headline","typeLabel":"object"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.required","typeLabel":"boolean"},"choices":{"type":"array","minItems":2,"items":{"type":"object","required":["id","label"],"properties":{"id":{"type":"string","description":"Stable choice id.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.choices.items.[INDEX].id","typeLabel":"string"},"label":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.choices.items.[INDEX].label.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.choices.items.[INDEX].label","typeLabel":"object"},"code":{"type":"string","maxLength":20,"pattern":"^[a-z0-9][a-z0-9_]*$","description":"Answer code of an option, a matrix row or a matrix column. Optional. Lowercase letters, digits and `_`; it may start with a digit, but not with `_`; no `__`, no trailing `_`, at most 20 characters. It must not be an SPSS reserved word or an export column name, and must be unique within its question (a matrix's rows and columns are checked separately), ignoring case.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.choices.items.[INDEX].code","typeLabel":"string"},"showIf":{"type":"object","description":"Option show-if: the option (or matrix row or column) is offered only when this condition group matches, re-evaluated live as earlier answers change. It may use what its element's show-if may use: answers from earlier blocks and from elements above its element in the same block, never its own element or anything below (`misordered_reference` at the exact condition path). A question left with no option to offer is skipped and recorded as not shown. Omit it, or send an empty group, for an option that is always offered. Allowed on published surveys.","required":["id","connector","conditions"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf.id","typeLabel":"string\u003ccuid2>"},"connector":{"type":"string","enum":["and","or"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf.connector","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","items":{"oneOf":[{"type":"object","description":"Single condition. Operators such as `isSubmitted`, `isSkipped`, `isClicked`, `isAccepted`,\n`isBooked`, `isSet`, and `isEmpty` do not use `rightOperand`; comparison operators do.\n","required":["id","leftOperand","operator"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.id","typeLabel":"string\u003ccuid2>"},"leftOperand":{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand","typeLabel":"object"},"operator":{"type":"string","enum":["equals","doesNotEqual","contains","doesNotContain","startsWith","doesNotStartWith","endsWith","doesNotEndWith","isSubmitted","isSkipped","isGreaterThan","isLessThan","isGreaterThanOrEqual","isLessThanOrEqual","equalsOneOf","includesAllOf","includesOneOf","doesNotIncludeOneOf","doesNotIncludeAllOf","isClicked","isNotClicked","isAccepted","isBefore","isAfter","isBooked","isPartiallySubmitted","isCompletelySubmitted","isSet","isNotSet","isEmpty","isNotEmpty","isAnyOf"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"rightOperand":{"oneOf":[{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.1","typeLabel":"number"},{"type":"array","items":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value","typeLabel":"string | number | string[]"},"columnId":{"type":"string","minLength":1,"description":"On a matrix row condition, the id of the column. Read before `value` and wins when the two disagree, so the condition survives reordering. Must be a column of the matrix. Optional: when only `value` is sent, the id is filled in from the position on write.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnId","typeLabel":"string"},"columnIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition with `isAnyOf`, the ids of the columns `value` lists. Read before `value`, like `columnId`.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0","typeLabel":"object"},{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1","typeLabel":"object"}],"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0","typeLabel":"object"},{}],"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf.conditions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf.conditions","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.choices.items.[INDEX].showIf","typeLabel":"object"},"hidden":{"type":"boolean","description":"Hidden: the option is never offered, whatever its `showIf` says, and is recorded as not shown. Use it to retire an option on a published survey instead of deleting it (deleting an option that existed at launch is refused): it keeps its id, answer code and earlier answers, and stays in results labelled Hidden.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.choices.items.[INDEX].hidden","typeLabel":"boolean"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.choices.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.choices","typeLabel":"object[]"},"subheader":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.subheader.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.subheader","typeLabel":"object"},"imageUrl":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.imageUrl","typeLabel":"string"},"imageAltText":{"type":"object","description":"Text alternative for `imageUrl`, read by screen readers. Omit or leave empty for a decorative image (rendered as `alt=\"\"`).","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.imageAltText.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.imageAltText","typeLabel":"object"},"videoUrl":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.videoUrl","typeLabel":"string"},"isDraft":{"type":"boolean","description":"Draft marker used by the editor and future update rules.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.isDraft","typeLabel":"boolean"},"showIf":{"type":"object","description":"Show-if: the element is shown only when this condition group matches, re-evaluated live as answers above it on the same page change. A hidden element is not validated (a hidden required element never blocks submission) and its answer is not submitted. Conditions use the same operands and operators as block `logic`. Reference rule: an element's show-if may use answers from earlier blocks and from elements above it in the same block, never itself or anything below it; a violation fails with `misordered_reference` at the exact condition path. Omit it, or send an empty group, for an element that is always shown.","required":["id","connector","conditions"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.showIf.id","typeLabel":"string\u003ccuid2>"},"connector":{"type":"string","enum":["and","or"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.showIf.connector","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","items":{"oneOf":[{"type":"object","description":"Single condition. Operators such as `isSubmitted`, `isSkipped`, `isClicked`, `isAccepted`,\n`isBooked`, `isSet`, and `isEmpty` do not use `rightOperand`; comparison operators do.\n","required":["id","leftOperand","operator"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.showIf.conditions.items.[INDEX].oneOf.0.id","typeLabel":"string\u003ccuid2>"},"leftOperand":{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.showIf.conditions.items.[INDEX].oneOf.0.leftOperand","typeLabel":"object"},"operator":{"type":"string","enum":["equals","doesNotEqual","contains","doesNotContain","startsWith","doesNotStartWith","endsWith","doesNotEndWith","isSubmitted","isSkipped","isGreaterThan","isLessThan","isGreaterThanOrEqual","isLessThanOrEqual","equalsOneOf","includesAllOf","includesOneOf","doesNotIncludeOneOf","doesNotIncludeAllOf","isClicked","isNotClicked","isAccepted","isBefore","isAfter","isBooked","isPartiallySubmitted","isCompletelySubmitted","isSet","isNotSet","isEmpty","isNotEmpty","isAnyOf"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.showIf.conditions.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"rightOperand":{"oneOf":[{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.1","typeLabel":"number"},{"type":"array","items":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value","typeLabel":"string | number | string[]"},"columnId":{"type":"string","minLength":1,"description":"On a matrix row condition, the id of the column. Read before `value` and wins when the two disagree, so the condition survives reordering. Must be a column of the matrix. Optional: when only `value` is sent, the id is filled in from the position on write.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnId","typeLabel":"string"},"columnIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition with `isAnyOf`, the ids of the columns `value` lists. Read before `value`, like `columnId`.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0","typeLabel":"object"},{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1","typeLabel":"object"}],"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.showIf.conditions.items.[INDEX].oneOf.0.rightOperand","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.showIf.conditions.items.[INDEX].oneOf.0","typeLabel":"object"},{}],"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.showIf.conditions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.showIf.conditions","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.showIf","typeLabel":"object"},"code":{"type":"string","maxLength":30,"pattern":"^[a-z][a-z0-9_]*$","description":"Question code, the name the question carries in exports, webhooks and links. Optional. Starts with a lowercase letter, then lowercase letters, digits and `_`; no `__`, no trailing `_`, at most 30 characters. It must not be an SPSS reserved word (`all`, `and`, `by`, `eq`, `ge`, `gt`, `le`, `lt`, `ne`, `not`, `or`, `to`, `with`) or an export column name (`response_id`, `language`, `outcome`, ...), and must be unique among the survey's question codes, Embedded Data names and the Question IDs of other questions, ignoring case. CTA elements have no code.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.code","typeLabel":"string"},"optionsCopiedFrom":{"type":"string","minLength":1,"description":"Copied options: the id of an earlier element whose options this element copies (\"only the brands you know\"). Choices copy from a single select, multi select or ranking; pictures from a picture selection (matrix rows are not copied: give rows a `showIf` on the source instead). Write the copies yourself: each copied option keeps the source option's `id` and `code`, and carries a `showIf` \"picked in the source\" (`includesOneOf` with its own id, or `equals` when the source is a single select), so the element offers exactly the options picked there. Copied codes follow the source's: a code sent for a copy is replaced by the source option's. Fixed options next to the copies (such as \"None of these\", id `none`) get the next code free in every linked element. The source must exist (`dangling_reference`), sit in an earlier block or above this element on its block (`misordered_reference`), and have options of the same kind (`invalid_reference`). To bring in options the source gained later, add them the same way.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.optionsCopiedFrom","typeLabel":"string"},"shuffleOption":{"type":"string","enum":["none","all","exceptLast","reverseOrderOccasionally","reverseOrderExceptLast"],"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.shuffleOption","typeLabel":"enum\u003cstring>"},"otherOptionPlaceholder":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.otherOptionPlaceholder.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.otherOptionPlaceholder","typeLabel":"object"},"validation":{"type":"object","description":"Optional element-level validation rules.","required":["rules"],"properties":{"rules":{"type":"array","items":{"type":"object","required":["id","type","params"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.validation.rules.items.[INDEX].id","typeLabel":"string"},"type":{"type":"string","enum":["minLength","maxLength","pattern","email","url","phone","equals","doesNotEqual","contains","doesNotContain","minValue","maxValue","isGreaterThan","isLessThan","minSelections","maxSelections","minRanked","rankAll","minRowsAnswered","answerAllRows","isLaterThan","isEarlierThan","isBetween","isNotBetween","fileExtensionIs","fileExtensionIsNot"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.validation.rules.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"params":{"type":"object","additionalProperties":true,"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.validation.rules.items.[INDEX].params","typeLabel":"object"},"field":{"type":"string","enum":["addressLine1","addressLine2","city","state","zip","country","firstName","lastName","email","phone","company"],"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.validation.rules.items.[INDEX].field","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.validation.rules.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.validation.rules","typeLabel":"object[]"},"logic":{"type":"string","enum":["and","or"],"default":"and","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.validation.logic","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.validation","typeLabel":"object"},"displayType":{"type":"string","enum":["list","row","dropdown"],"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3.displayType","typeLabel":"enum\u003cstring>"}},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.3","typeLabel":"object"},{"type":"object","description":"Survey element/question inside a block. Element ids are stable public identifiers used by\nlogic, recall strings, response data, quotas, integrations, and analysis. `type` selects the\nallowed shape; unsupported fields are rejected instead of ignored.\n","required":["id","type","headline","required"],"properties":{"id":{"type":"string","pattern":"^[a-zA-Z0-9_-]+$","description":"Stable element id. Avoid spaces and reserved ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.4.id","typeLabel":"string"},"type":{"type":"string","enum":["nps"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.4.type","typeLabel":"enum\u003cstring>"},"headline":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.4.headline.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.4.headline","typeLabel":"object"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.4.required","typeLabel":"boolean"},"subheader":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.4.subheader.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.4.subheader","typeLabel":"object"},"imageUrl":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.4.imageUrl","typeLabel":"string"},"imageAltText":{"type":"object","description":"Text alternative for `imageUrl`, read by screen readers. Omit or leave empty for a decorative image (rendered as `alt=\"\"`).","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.4.imageAltText.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.4.imageAltText","typeLabel":"object"},"videoUrl":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.4.videoUrl","typeLabel":"string"},"isDraft":{"type":"boolean","description":"Draft marker used by the editor and future update rules.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.4.isDraft","typeLabel":"boolean"},"showIf":{"type":"object","description":"Show-if: the element is shown only when this condition group matches, re-evaluated live as answers above it on the same page change. A hidden element is not validated (a hidden required element never blocks submission) and its answer is not submitted. Conditions use the same operands and operators as block `logic`. Reference rule: an element's show-if may use answers from earlier blocks and from elements above it in the same block, never itself or anything below it; a violation fails with `misordered_reference` at the exact condition path. Omit it, or send an empty group, for an element that is always shown.","required":["id","connector","conditions"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.4.showIf.id","typeLabel":"string\u003ccuid2>"},"connector":{"type":"string","enum":["and","or"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.4.showIf.connector","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","items":{"oneOf":[{"type":"object","description":"Single condition. Operators such as `isSubmitted`, `isSkipped`, `isClicked`, `isAccepted`,\n`isBooked`, `isSet`, and `isEmpty` do not use `rightOperand`; comparison operators do.\n","required":["id","leftOperand","operator"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.4.showIf.conditions.items.[INDEX].oneOf.0.id","typeLabel":"string\u003ccuid2>"},"leftOperand":{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.4.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.4.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.4.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.4.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.4.showIf.conditions.items.[INDEX].oneOf.0.leftOperand","typeLabel":"object"},"operator":{"type":"string","enum":["equals","doesNotEqual","contains","doesNotContain","startsWith","doesNotStartWith","endsWith","doesNotEndWith","isSubmitted","isSkipped","isGreaterThan","isLessThan","isGreaterThanOrEqual","isLessThanOrEqual","equalsOneOf","includesAllOf","includesOneOf","doesNotIncludeOneOf","doesNotIncludeAllOf","isClicked","isNotClicked","isAccepted","isBefore","isAfter","isBooked","isPartiallySubmitted","isCompletelySubmitted","isSet","isNotSet","isEmpty","isNotEmpty","isAnyOf"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.4.showIf.conditions.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"rightOperand":{"oneOf":[{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.4.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.4.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.4.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.1","typeLabel":"number"},{"type":"array","items":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.4.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.4.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.4.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value","typeLabel":"string | number | string[]"},"columnId":{"type":"string","minLength":1,"description":"On a matrix row condition, the id of the column. Read before `value` and wins when the two disagree, so the condition survives reordering. Must be a column of the matrix. Optional: when only `value` is sent, the id is filled in from the position on write.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.4.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnId","typeLabel":"string"},"columnIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.4.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition with `isAnyOf`, the ids of the columns `value` lists. Read before `value`, like `columnId`.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.4.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.4.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0","typeLabel":"object"},{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.4.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.4.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.4.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.4.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.4.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1","typeLabel":"object"}],"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.4.showIf.conditions.items.[INDEX].oneOf.0.rightOperand","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.4.showIf.conditions.items.[INDEX].oneOf.0","typeLabel":"object"},{}],"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.4.showIf.conditions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.4.showIf.conditions","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.4.showIf","typeLabel":"object"},"code":{"type":"string","maxLength":30,"pattern":"^[a-z][a-z0-9_]*$","description":"Question code, the name the question carries in exports, webhooks and links. Optional. Starts with a lowercase letter, then lowercase letters, digits and `_`; no `__`, no trailing `_`, at most 30 characters. It must not be an SPSS reserved word (`all`, `and`, `by`, `eq`, `ge`, `gt`, `le`, `lt`, `ne`, `not`, `or`, `to`, `with`) or an export column name (`response_id`, `language`, `outcome`, ...), and must be unique among the survey's question codes, Embedded Data names and the Question IDs of other questions, ignoring case. CTA elements have no code.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.4.code","typeLabel":"string"},"lowerLabel":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.4.lowerLabel.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.4.lowerLabel","typeLabel":"object"},"upperLabel":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.4.upperLabel.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.4.upperLabel","typeLabel":"object"},"isColorCodingEnabled":{"type":"boolean","default":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.4.isColorCodingEnabled","typeLabel":"boolean"}},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.4","typeLabel":"object"},{"type":"object","description":"Survey element/question inside a block. Element ids are stable public identifiers used by\nlogic, recall strings, response data, quotas, integrations, and analysis. `type` selects the\nallowed shape; unsupported fields are rejected instead of ignored.\n","required":["id","type","headline","required"],"conditionallyRequiredProperties":{"buttonUrl":[{"when":[[{"property":"buttonExternal","values":[true]}]]}],"ctaButtonLabel":[{"when":[[{"property":"buttonExternal","values":[true]}]]}]},"properties":{"id":{"type":"string","pattern":"^[a-zA-Z0-9_-]+$","description":"Stable element id. Avoid spaces and reserved ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.5.id","typeLabel":"string"},"type":{"type":"string","enum":["cta"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.5.type","typeLabel":"enum\u003cstring>"},"headline":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.5.headline.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.5.headline","typeLabel":"object"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.5.required","typeLabel":"boolean"},"subheader":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.5.subheader.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.5.subheader","typeLabel":"object"},"imageUrl":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.5.imageUrl","typeLabel":"string"},"imageAltText":{"type":"object","description":"Text alternative for `imageUrl`, read by screen readers. Omit or leave empty for a decorative image (rendered as `alt=\"\"`).","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.5.imageAltText.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.5.imageAltText","typeLabel":"object"},"videoUrl":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.5.videoUrl","typeLabel":"string"},"isDraft":{"type":"boolean","description":"Draft marker used by the editor and future update rules.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.5.isDraft","typeLabel":"boolean"},"showIf":{"type":"object","description":"Show-if: the element is shown only when this condition group matches, re-evaluated live as answers above it on the same page change. A hidden element is not validated (a hidden required element never blocks submission) and its answer is not submitted. Conditions use the same operands and operators as block `logic`. Reference rule: an element's show-if may use answers from earlier blocks and from elements above it in the same block, never itself or anything below it; a violation fails with `misordered_reference` at the exact condition path. Omit it, or send an empty group, for an element that is always shown.","required":["id","connector","conditions"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.5.showIf.id","typeLabel":"string\u003ccuid2>"},"connector":{"type":"string","enum":["and","or"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.5.showIf.connector","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","items":{"oneOf":[{"type":"object","description":"Single condition. Operators such as `isSubmitted`, `isSkipped`, `isClicked`, `isAccepted`,\n`isBooked`, `isSet`, and `isEmpty` do not use `rightOperand`; comparison operators do.\n","required":["id","leftOperand","operator"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.5.showIf.conditions.items.[INDEX].oneOf.0.id","typeLabel":"string\u003ccuid2>"},"leftOperand":{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.5.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.5.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.5.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.5.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.5.showIf.conditions.items.[INDEX].oneOf.0.leftOperand","typeLabel":"object"},"operator":{"type":"string","enum":["equals","doesNotEqual","contains","doesNotContain","startsWith","doesNotStartWith","endsWith","doesNotEndWith","isSubmitted","isSkipped","isGreaterThan","isLessThan","isGreaterThanOrEqual","isLessThanOrEqual","equalsOneOf","includesAllOf","includesOneOf","doesNotIncludeOneOf","doesNotIncludeAllOf","isClicked","isNotClicked","isAccepted","isBefore","isAfter","isBooked","isPartiallySubmitted","isCompletelySubmitted","isSet","isNotSet","isEmpty","isNotEmpty","isAnyOf"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.5.showIf.conditions.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"rightOperand":{"oneOf":[{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.5.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.5.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.5.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.1","typeLabel":"number"},{"type":"array","items":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.5.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.5.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.5.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value","typeLabel":"string | number | string[]"},"columnId":{"type":"string","minLength":1,"description":"On a matrix row condition, the id of the column. Read before `value` and wins when the two disagree, so the condition survives reordering. Must be a column of the matrix. Optional: when only `value` is sent, the id is filled in from the position on write.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.5.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnId","typeLabel":"string"},"columnIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.5.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition with `isAnyOf`, the ids of the columns `value` lists. Read before `value`, like `columnId`.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.5.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.5.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0","typeLabel":"object"},{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.5.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.5.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.5.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.5.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.5.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1","typeLabel":"object"}],"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.5.showIf.conditions.items.[INDEX].oneOf.0.rightOperand","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.5.showIf.conditions.items.[INDEX].oneOf.0","typeLabel":"object"},{}],"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.5.showIf.conditions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.5.showIf.conditions","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.5.showIf","typeLabel":"object"},"buttonExternal":{"type":"boolean","default":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.5.buttonExternal","typeLabel":"boolean"},"buttonUrl":{"type":"string","conditionalRequirements":[{"when":[[{"property":"buttonExternal","values":[true]}]]}],"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.5.buttonUrl","typeLabel":"string"},"ctaButtonLabel":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.5.ctaButtonLabel.additionalProperties","typeLabel":"string"},"conditionalRequirements":[{"when":[[{"property":"buttonExternal","values":[true]}]]}],"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.5.ctaButtonLabel","typeLabel":"object"}},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.5","typeLabel":"object"},{"type":"object","description":"Survey element/question inside a block. Element ids are stable public identifiers used by\nlogic, recall strings, response data, quotas, integrations, and analysis. `type` selects the\nallowed shape; unsupported fields are rejected instead of ignored.\n","required":["scale","range","id","type","headline","required"],"properties":{"id":{"type":"string","pattern":"^[a-zA-Z0-9_-]+$","description":"Stable element id. Avoid spaces and reserved ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.6.id","typeLabel":"string"},"type":{"type":"string","enum":["rating"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.6.type","typeLabel":"enum\u003cstring>"},"headline":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.6.headline.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.6.headline","typeLabel":"object"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.6.required","typeLabel":"boolean"},"scale":{"type":"string","enum":["number","smiley","star"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.6.scale","typeLabel":"enum\u003cstring>"},"range":{"type":"integer","enum":[3,4,5,6,7,10],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.6.range","typeLabel":"enum\u003cinteger>"},"subheader":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.6.subheader.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.6.subheader","typeLabel":"object"},"imageUrl":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.6.imageUrl","typeLabel":"string"},"imageAltText":{"type":"object","description":"Text alternative for `imageUrl`, read by screen readers. Omit or leave empty for a decorative image (rendered as `alt=\"\"`).","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.6.imageAltText.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.6.imageAltText","typeLabel":"object"},"videoUrl":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.6.videoUrl","typeLabel":"string"},"isDraft":{"type":"boolean","description":"Draft marker used by the editor and future update rules.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.6.isDraft","typeLabel":"boolean"},"showIf":{"type":"object","description":"Show-if: the element is shown only when this condition group matches, re-evaluated live as answers above it on the same page change. A hidden element is not validated (a hidden required element never blocks submission) and its answer is not submitted. Conditions use the same operands and operators as block `logic`. Reference rule: an element's show-if may use answers from earlier blocks and from elements above it in the same block, never itself or anything below it; a violation fails with `misordered_reference` at the exact condition path. Omit it, or send an empty group, for an element that is always shown.","required":["id","connector","conditions"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.6.showIf.id","typeLabel":"string\u003ccuid2>"},"connector":{"type":"string","enum":["and","or"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.6.showIf.connector","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","items":{"oneOf":[{"type":"object","description":"Single condition. Operators such as `isSubmitted`, `isSkipped`, `isClicked`, `isAccepted`,\n`isBooked`, `isSet`, and `isEmpty` do not use `rightOperand`; comparison operators do.\n","required":["id","leftOperand","operator"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.6.showIf.conditions.items.[INDEX].oneOf.0.id","typeLabel":"string\u003ccuid2>"},"leftOperand":{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.6.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.6.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.6.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.6.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.6.showIf.conditions.items.[INDEX].oneOf.0.leftOperand","typeLabel":"object"},"operator":{"type":"string","enum":["equals","doesNotEqual","contains","doesNotContain","startsWith","doesNotStartWith","endsWith","doesNotEndWith","isSubmitted","isSkipped","isGreaterThan","isLessThan","isGreaterThanOrEqual","isLessThanOrEqual","equalsOneOf","includesAllOf","includesOneOf","doesNotIncludeOneOf","doesNotIncludeAllOf","isClicked","isNotClicked","isAccepted","isBefore","isAfter","isBooked","isPartiallySubmitted","isCompletelySubmitted","isSet","isNotSet","isEmpty","isNotEmpty","isAnyOf"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.6.showIf.conditions.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"rightOperand":{"oneOf":[{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.6.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.6.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.6.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.1","typeLabel":"number"},{"type":"array","items":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.6.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.6.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.6.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value","typeLabel":"string | number | string[]"},"columnId":{"type":"string","minLength":1,"description":"On a matrix row condition, the id of the column. Read before `value` and wins when the two disagree, so the condition survives reordering. Must be a column of the matrix. Optional: when only `value` is sent, the id is filled in from the position on write.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.6.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnId","typeLabel":"string"},"columnIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.6.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition with `isAnyOf`, the ids of the columns `value` lists. Read before `value`, like `columnId`.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.6.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.6.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0","typeLabel":"object"},{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.6.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.6.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.6.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.6.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.6.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1","typeLabel":"object"}],"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.6.showIf.conditions.items.[INDEX].oneOf.0.rightOperand","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.6.showIf.conditions.items.[INDEX].oneOf.0","typeLabel":"object"},{}],"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.6.showIf.conditions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.6.showIf.conditions","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.6.showIf","typeLabel":"object"},"code":{"type":"string","maxLength":30,"pattern":"^[a-z][a-z0-9_]*$","description":"Question code, the name the question carries in exports, webhooks and links. Optional. Starts with a lowercase letter, then lowercase letters, digits and `_`; no `__`, no trailing `_`, at most 30 characters. It must not be an SPSS reserved word (`all`, `and`, `by`, `eq`, `ge`, `gt`, `le`, `lt`, `ne`, `not`, `or`, `to`, `with`) or an export column name (`response_id`, `language`, `outcome`, ...), and must be unique among the survey's question codes, Embedded Data names and the Question IDs of other questions, ignoring case. CTA elements have no code.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.6.code","typeLabel":"string"},"lowerLabel":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.6.lowerLabel.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.6.lowerLabel","typeLabel":"object"},"upperLabel":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.6.upperLabel.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.6.upperLabel","typeLabel":"object"},"isColorCodingEnabled":{"type":"boolean","default":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.6.isColorCodingEnabled","typeLabel":"boolean"}},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.6","typeLabel":"object"},{"type":"object","description":"Survey element/question inside a block. Element ids are stable public identifiers used by\nlogic, recall strings, response data, quotas, integrations, and analysis. `type` selects the\nallowed shape; unsupported fields are rejected instead of ignored.\n","required":["choices","id","type","headline","required"],"properties":{"id":{"type":"string","pattern":"^[a-zA-Z0-9_-]+$","description":"Stable element id. Avoid spaces and reserved ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.id","typeLabel":"string"},"type":{"type":"string","enum":["pictureSelection"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.type","typeLabel":"enum\u003cstring>"},"headline":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.headline.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.headline","typeLabel":"object"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.required","typeLabel":"boolean"},"choices":{"type":"array","minItems":2,"items":{"type":"object","required":["id","imageUrl"],"properties":{"id":{"type":"string","description":"Stable picture choice id.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.choices.items.[INDEX].id","typeLabel":"string"},"imageUrl":{"type":"string","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.choices.items.[INDEX].imageUrl","typeLabel":"string"},"code":{"type":"string","maxLength":20,"pattern":"^[a-z0-9][a-z0-9_]*$","description":"Answer code of an option, a matrix row or a matrix column. Optional. Lowercase letters, digits and `_`; it may start with a digit, but not with `_`; no `__`, no trailing `_`, at most 20 characters. It must not be an SPSS reserved word or an export column name, and must be unique within its question (a matrix's rows and columns are checked separately), ignoring case.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.choices.items.[INDEX].code","typeLabel":"string"},"imageAltText":{"type":"object","description":"Text alternative for `imageUrl`, read by screen readers. Omit or leave empty to fall back to the positional label (\"Option 1\", \"Option 2\", …); a choice image is never decorative, since the respondent selects it.","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.choices.items.[INDEX].imageAltText.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.choices.items.[INDEX].imageAltText","typeLabel":"object"},"showIf":{"type":"object","description":"Option show-if: the option (or matrix row or column) is offered only when this condition group matches, re-evaluated live as earlier answers change. It may use what its element's show-if may use: answers from earlier blocks and from elements above its element in the same block, never its own element or anything below (`misordered_reference` at the exact condition path). A question left with no option to offer is skipped and recorded as not shown. Omit it, or send an empty group, for an option that is always offered. Allowed on published surveys.","required":["id","connector","conditions"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf.id","typeLabel":"string\u003ccuid2>"},"connector":{"type":"string","enum":["and","or"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf.connector","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","items":{"oneOf":[{"type":"object","description":"Single condition. Operators such as `isSubmitted`, `isSkipped`, `isClicked`, `isAccepted`,\n`isBooked`, `isSet`, and `isEmpty` do not use `rightOperand`; comparison operators do.\n","required":["id","leftOperand","operator"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.id","typeLabel":"string\u003ccuid2>"},"leftOperand":{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand","typeLabel":"object"},"operator":{"type":"string","enum":["equals","doesNotEqual","contains","doesNotContain","startsWith","doesNotStartWith","endsWith","doesNotEndWith","isSubmitted","isSkipped","isGreaterThan","isLessThan","isGreaterThanOrEqual","isLessThanOrEqual","equalsOneOf","includesAllOf","includesOneOf","doesNotIncludeOneOf","doesNotIncludeAllOf","isClicked","isNotClicked","isAccepted","isBefore","isAfter","isBooked","isPartiallySubmitted","isCompletelySubmitted","isSet","isNotSet","isEmpty","isNotEmpty","isAnyOf"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"rightOperand":{"oneOf":[{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.1","typeLabel":"number"},{"type":"array","items":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value","typeLabel":"string | number | string[]"},"columnId":{"type":"string","minLength":1,"description":"On a matrix row condition, the id of the column. Read before `value` and wins when the two disagree, so the condition survives reordering. Must be a column of the matrix. Optional: when only `value` is sent, the id is filled in from the position on write.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnId","typeLabel":"string"},"columnIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition with `isAnyOf`, the ids of the columns `value` lists. Read before `value`, like `columnId`.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0","typeLabel":"object"},{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1","typeLabel":"object"}],"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0","typeLabel":"object"},{}],"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf.conditions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf.conditions","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.choices.items.[INDEX].showIf","typeLabel":"object"},"hidden":{"type":"boolean","description":"Hidden: the option is never offered, whatever its `showIf` says, and is recorded as not shown. Use it to retire an option on a published survey instead of deleting it (deleting an option that existed at launch is refused): it keeps its id, answer code and earlier answers, and stays in results labelled Hidden.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.choices.items.[INDEX].hidden","typeLabel":"boolean"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.choices.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.choices","typeLabel":"object[]"},"subheader":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.subheader.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.subheader","typeLabel":"object"},"imageUrl":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.imageUrl","typeLabel":"string"},"imageAltText":{"type":"object","description":"Text alternative for `imageUrl`, read by screen readers. Omit or leave empty for a decorative image (rendered as `alt=\"\"`).","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.imageAltText.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.imageAltText","typeLabel":"object"},"videoUrl":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.videoUrl","typeLabel":"string"},"isDraft":{"type":"boolean","description":"Draft marker used by the editor and future update rules.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.isDraft","typeLabel":"boolean"},"showIf":{"type":"object","description":"Show-if: the element is shown only when this condition group matches, re-evaluated live as answers above it on the same page change. A hidden element is not validated (a hidden required element never blocks submission) and its answer is not submitted. Conditions use the same operands and operators as block `logic`. Reference rule: an element's show-if may use answers from earlier blocks and from elements above it in the same block, never itself or anything below it; a violation fails with `misordered_reference` at the exact condition path. Omit it, or send an empty group, for an element that is always shown.","required":["id","connector","conditions"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.showIf.id","typeLabel":"string\u003ccuid2>"},"connector":{"type":"string","enum":["and","or"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.showIf.connector","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","items":{"oneOf":[{"type":"object","description":"Single condition. Operators such as `isSubmitted`, `isSkipped`, `isClicked`, `isAccepted`,\n`isBooked`, `isSet`, and `isEmpty` do not use `rightOperand`; comparison operators do.\n","required":["id","leftOperand","operator"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.showIf.conditions.items.[INDEX].oneOf.0.id","typeLabel":"string\u003ccuid2>"},"leftOperand":{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.showIf.conditions.items.[INDEX].oneOf.0.leftOperand","typeLabel":"object"},"operator":{"type":"string","enum":["equals","doesNotEqual","contains","doesNotContain","startsWith","doesNotStartWith","endsWith","doesNotEndWith","isSubmitted","isSkipped","isGreaterThan","isLessThan","isGreaterThanOrEqual","isLessThanOrEqual","equalsOneOf","includesAllOf","includesOneOf","doesNotIncludeOneOf","doesNotIncludeAllOf","isClicked","isNotClicked","isAccepted","isBefore","isAfter","isBooked","isPartiallySubmitted","isCompletelySubmitted","isSet","isNotSet","isEmpty","isNotEmpty","isAnyOf"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.showIf.conditions.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"rightOperand":{"oneOf":[{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.1","typeLabel":"number"},{"type":"array","items":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value","typeLabel":"string | number | string[]"},"columnId":{"type":"string","minLength":1,"description":"On a matrix row condition, the id of the column. Read before `value` and wins when the two disagree, so the condition survives reordering. Must be a column of the matrix. Optional: when only `value` is sent, the id is filled in from the position on write.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnId","typeLabel":"string"},"columnIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition with `isAnyOf`, the ids of the columns `value` lists. Read before `value`, like `columnId`.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0","typeLabel":"object"},{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1","typeLabel":"object"}],"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.showIf.conditions.items.[INDEX].oneOf.0.rightOperand","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.showIf.conditions.items.[INDEX].oneOf.0","typeLabel":"object"},{}],"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.showIf.conditions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.showIf.conditions","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.showIf","typeLabel":"object"},"code":{"type":"string","maxLength":30,"pattern":"^[a-z][a-z0-9_]*$","description":"Question code, the name the question carries in exports, webhooks and links. Optional. Starts with a lowercase letter, then lowercase letters, digits and `_`; no `__`, no trailing `_`, at most 30 characters. It must not be an SPSS reserved word (`all`, `and`, `by`, `eq`, `ge`, `gt`, `le`, `lt`, `ne`, `not`, `or`, `to`, `with`) or an export column name (`response_id`, `language`, `outcome`, ...), and must be unique among the survey's question codes, Embedded Data names and the Question IDs of other questions, ignoring case. CTA elements have no code.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.code","typeLabel":"string"},"allowMulti":{"type":"boolean","default":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.allowMulti","typeLabel":"boolean"},"optionsCopiedFrom":{"type":"string","minLength":1,"description":"Copied options: the id of an earlier element whose options this element copies (\"only the brands you know\"). Choices copy from a single select, multi select or ranking; pictures from a picture selection (matrix rows are not copied: give rows a `showIf` on the source instead). Write the copies yourself: each copied option keeps the source option's `id` and `code`, and carries a `showIf` \"picked in the source\" (`includesOneOf` with its own id, or `equals` when the source is a single select), so the element offers exactly the options picked there. Copied codes follow the source's: a code sent for a copy is replaced by the source option's. Fixed options next to the copies (such as \"None of these\", id `none`) get the next code free in every linked element. The source must exist (`dangling_reference`), sit in an earlier block or above this element on its block (`misordered_reference`), and have options of the same kind (`invalid_reference`). To bring in options the source gained later, add them the same way.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.optionsCopiedFrom","typeLabel":"string"},"validation":{"type":"object","description":"Optional element-level validation rules.","required":["rules"],"properties":{"rules":{"type":"array","items":{"type":"object","required":["id","type","params"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.validation.rules.items.[INDEX].id","typeLabel":"string"},"type":{"type":"string","enum":["minLength","maxLength","pattern","email","url","phone","equals","doesNotEqual","contains","doesNotContain","minValue","maxValue","isGreaterThan","isLessThan","minSelections","maxSelections","minRanked","rankAll","minRowsAnswered","answerAllRows","isLaterThan","isEarlierThan","isBetween","isNotBetween","fileExtensionIs","fileExtensionIsNot"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.validation.rules.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"params":{"type":"object","additionalProperties":true,"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.validation.rules.items.[INDEX].params","typeLabel":"object"},"field":{"type":"string","enum":["addressLine1","addressLine2","city","state","zip","country","firstName","lastName","email","phone","company"],"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.validation.rules.items.[INDEX].field","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.validation.rules.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.validation.rules","typeLabel":"object[]"},"logic":{"type":"string","enum":["and","or"],"default":"and","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.validation.logic","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7.validation","typeLabel":"object"}},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.7","typeLabel":"object"},{"type":"object","description":"Survey element/question inside a block. Element ids are stable public identifiers used by\nlogic, recall strings, response data, quotas, integrations, and analysis. `type` selects the\nallowed shape; unsupported fields are rejected instead of ignored.\n","required":["format","id","type","headline","required"],"properties":{"id":{"type":"string","pattern":"^[a-zA-Z0-9_-]+$","description":"Stable element id. Avoid spaces and reserved ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.8.id","typeLabel":"string"},"type":{"type":"string","enum":["date"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.8.type","typeLabel":"enum\u003cstring>"},"headline":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.8.headline.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.8.headline","typeLabel":"object"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.8.required","typeLabel":"boolean"},"format":{"type":"string","enum":["M-d-y","d-M-y","y-M-d"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.8.format","typeLabel":"enum\u003cstring>"},"subheader":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.8.subheader.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.8.subheader","typeLabel":"object"},"imageUrl":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.8.imageUrl","typeLabel":"string"},"imageAltText":{"type":"object","description":"Text alternative for `imageUrl`, read by screen readers. Omit or leave empty for a decorative image (rendered as `alt=\"\"`).","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.8.imageAltText.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.8.imageAltText","typeLabel":"object"},"videoUrl":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.8.videoUrl","typeLabel":"string"},"isDraft":{"type":"boolean","description":"Draft marker used by the editor and future update rules.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.8.isDraft","typeLabel":"boolean"},"showIf":{"type":"object","description":"Show-if: the element is shown only when this condition group matches, re-evaluated live as answers above it on the same page change. A hidden element is not validated (a hidden required element never blocks submission) and its answer is not submitted. Conditions use the same operands and operators as block `logic`. Reference rule: an element's show-if may use answers from earlier blocks and from elements above it in the same block, never itself or anything below it; a violation fails with `misordered_reference` at the exact condition path. Omit it, or send an empty group, for an element that is always shown.","required":["id","connector","conditions"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.8.showIf.id","typeLabel":"string\u003ccuid2>"},"connector":{"type":"string","enum":["and","or"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.8.showIf.connector","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","items":{"oneOf":[{"type":"object","description":"Single condition. Operators such as `isSubmitted`, `isSkipped`, `isClicked`, `isAccepted`,\n`isBooked`, `isSet`, and `isEmpty` do not use `rightOperand`; comparison operators do.\n","required":["id","leftOperand","operator"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.8.showIf.conditions.items.[INDEX].oneOf.0.id","typeLabel":"string\u003ccuid2>"},"leftOperand":{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.8.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.8.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.8.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.8.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.8.showIf.conditions.items.[INDEX].oneOf.0.leftOperand","typeLabel":"object"},"operator":{"type":"string","enum":["equals","doesNotEqual","contains","doesNotContain","startsWith","doesNotStartWith","endsWith","doesNotEndWith","isSubmitted","isSkipped","isGreaterThan","isLessThan","isGreaterThanOrEqual","isLessThanOrEqual","equalsOneOf","includesAllOf","includesOneOf","doesNotIncludeOneOf","doesNotIncludeAllOf","isClicked","isNotClicked","isAccepted","isBefore","isAfter","isBooked","isPartiallySubmitted","isCompletelySubmitted","isSet","isNotSet","isEmpty","isNotEmpty","isAnyOf"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.8.showIf.conditions.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"rightOperand":{"oneOf":[{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.8.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.8.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.8.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.1","typeLabel":"number"},{"type":"array","items":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.8.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.8.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.8.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value","typeLabel":"string | number | string[]"},"columnId":{"type":"string","minLength":1,"description":"On a matrix row condition, the id of the column. Read before `value` and wins when the two disagree, so the condition survives reordering. Must be a column of the matrix. Optional: when only `value` is sent, the id is filled in from the position on write.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.8.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnId","typeLabel":"string"},"columnIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.8.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition with `isAnyOf`, the ids of the columns `value` lists. Read before `value`, like `columnId`.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.8.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.8.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0","typeLabel":"object"},{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.8.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.8.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.8.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.8.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.8.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1","typeLabel":"object"}],"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.8.showIf.conditions.items.[INDEX].oneOf.0.rightOperand","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.8.showIf.conditions.items.[INDEX].oneOf.0","typeLabel":"object"},{}],"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.8.showIf.conditions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.8.showIf.conditions","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.8.showIf","typeLabel":"object"},"code":{"type":"string","maxLength":30,"pattern":"^[a-z][a-z0-9_]*$","description":"Question code, the name the question carries in exports, webhooks and links. Optional. Starts with a lowercase letter, then lowercase letters, digits and `_`; no `__`, no trailing `_`, at most 30 characters. It must not be an SPSS reserved word (`all`, `and`, `by`, `eq`, `ge`, `gt`, `le`, `lt`, `ne`, `not`, `or`, `to`, `with`) or an export column name (`response_id`, `language`, `outcome`, ...), and must be unique among the survey's question codes, Embedded Data names and the Question IDs of other questions, ignoring case. CTA elements have no code.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.8.code","typeLabel":"string"},"html":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.8.html.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.8.html","typeLabel":"object"},"validation":{"type":"object","description":"Optional element-level validation rules.","required":["rules"],"properties":{"rules":{"type":"array","items":{"type":"object","required":["id","type","params"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.8.validation.rules.items.[INDEX].id","typeLabel":"string"},"type":{"type":"string","enum":["minLength","maxLength","pattern","email","url","phone","equals","doesNotEqual","contains","doesNotContain","minValue","maxValue","isGreaterThan","isLessThan","minSelections","maxSelections","minRanked","rankAll","minRowsAnswered","answerAllRows","isLaterThan","isEarlierThan","isBetween","isNotBetween","fileExtensionIs","fileExtensionIsNot"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.8.validation.rules.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"params":{"type":"object","additionalProperties":true,"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.8.validation.rules.items.[INDEX].params","typeLabel":"object"},"field":{"type":"string","enum":["addressLine1","addressLine2","city","state","zip","country","firstName","lastName","email","phone","company"],"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.8.validation.rules.items.[INDEX].field","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.8.validation.rules.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.8.validation.rules","typeLabel":"object[]"},"logic":{"type":"string","enum":["and","or"],"default":"and","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.8.validation.logic","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.8.validation","typeLabel":"object"}},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.8","typeLabel":"object"},{"type":"object","description":"Survey element/question inside a block. Element ids are stable public identifiers used by\nlogic, recall strings, response data, quotas, integrations, and analysis. `type` selects the\nallowed shape; unsupported fields are rejected instead of ignored.\n","required":["allowMultipleFiles","id","type","headline","required"],"properties":{"id":{"type":"string","pattern":"^[a-zA-Z0-9_-]+$","description":"Stable element id. Avoid spaces and reserved ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.9.id","typeLabel":"string"},"type":{"type":"string","enum":["fileUpload"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.9.type","typeLabel":"enum\u003cstring>"},"headline":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.9.headline.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.9.headline","typeLabel":"object"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.9.required","typeLabel":"boolean"},"allowMultipleFiles":{"type":"boolean","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.9.allowMultipleFiles","typeLabel":"boolean"},"subheader":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.9.subheader.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.9.subheader","typeLabel":"object"},"imageUrl":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.9.imageUrl","typeLabel":"string"},"imageAltText":{"type":"object","description":"Text alternative for `imageUrl`, read by screen readers. Omit or leave empty for a decorative image (rendered as `alt=\"\"`).","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.9.imageAltText.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.9.imageAltText","typeLabel":"object"},"videoUrl":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.9.videoUrl","typeLabel":"string"},"isDraft":{"type":"boolean","description":"Draft marker used by the editor and future update rules.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.9.isDraft","typeLabel":"boolean"},"showIf":{"type":"object","description":"Show-if: the element is shown only when this condition group matches, re-evaluated live as answers above it on the same page change. A hidden element is not validated (a hidden required element never blocks submission) and its answer is not submitted. Conditions use the same operands and operators as block `logic`. Reference rule: an element's show-if may use answers from earlier blocks and from elements above it in the same block, never itself or anything below it; a violation fails with `misordered_reference` at the exact condition path. Omit it, or send an empty group, for an element that is always shown.","required":["id","connector","conditions"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.9.showIf.id","typeLabel":"string\u003ccuid2>"},"connector":{"type":"string","enum":["and","or"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.9.showIf.connector","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","items":{"oneOf":[{"type":"object","description":"Single condition. Operators such as `isSubmitted`, `isSkipped`, `isClicked`, `isAccepted`,\n`isBooked`, `isSet`, and `isEmpty` do not use `rightOperand`; comparison operators do.\n","required":["id","leftOperand","operator"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.9.showIf.conditions.items.[INDEX].oneOf.0.id","typeLabel":"string\u003ccuid2>"},"leftOperand":{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.9.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.9.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.9.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.9.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.9.showIf.conditions.items.[INDEX].oneOf.0.leftOperand","typeLabel":"object"},"operator":{"type":"string","enum":["equals","doesNotEqual","contains","doesNotContain","startsWith","doesNotStartWith","endsWith","doesNotEndWith","isSubmitted","isSkipped","isGreaterThan","isLessThan","isGreaterThanOrEqual","isLessThanOrEqual","equalsOneOf","includesAllOf","includesOneOf","doesNotIncludeOneOf","doesNotIncludeAllOf","isClicked","isNotClicked","isAccepted","isBefore","isAfter","isBooked","isPartiallySubmitted","isCompletelySubmitted","isSet","isNotSet","isEmpty","isNotEmpty","isAnyOf"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.9.showIf.conditions.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"rightOperand":{"oneOf":[{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.9.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.9.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.9.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.1","typeLabel":"number"},{"type":"array","items":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.9.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.9.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.9.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value","typeLabel":"string | number | string[]"},"columnId":{"type":"string","minLength":1,"description":"On a matrix row condition, the id of the column. Read before `value` and wins when the two disagree, so the condition survives reordering. Must be a column of the matrix. Optional: when only `value` is sent, the id is filled in from the position on write.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.9.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnId","typeLabel":"string"},"columnIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.9.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition with `isAnyOf`, the ids of the columns `value` lists. Read before `value`, like `columnId`.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.9.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.9.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0","typeLabel":"object"},{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.9.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.9.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.9.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.9.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.9.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1","typeLabel":"object"}],"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.9.showIf.conditions.items.[INDEX].oneOf.0.rightOperand","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.9.showIf.conditions.items.[INDEX].oneOf.0","typeLabel":"object"},{}],"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.9.showIf.conditions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.9.showIf.conditions","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.9.showIf","typeLabel":"object"},"code":{"type":"string","maxLength":30,"pattern":"^[a-z][a-z0-9_]*$","description":"Question code, the name the question carries in exports, webhooks and links. Optional. Starts with a lowercase letter, then lowercase letters, digits and `_`; no `__`, no trailing `_`, at most 30 characters. It must not be an SPSS reserved word (`all`, `and`, `by`, `eq`, `ge`, `gt`, `le`, `lt`, `ne`, `not`, `or`, `to`, `with`) or an export column name (`response_id`, `language`, `outcome`, ...), and must be unique among the survey's question codes, Embedded Data names and the Question IDs of other questions, ignoring case. CTA elements have no code.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.9.code","typeLabel":"string"},"maxSizeInMB":{"type":"number","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.9.maxSizeInMB","typeLabel":"number"},"allowedFileExtensions":{"type":"array","items":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.9.allowedFileExtensions.items.[INDEX]","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.9.allowedFileExtensions","typeLabel":"string[]"},"validation":{"type":"object","description":"Optional element-level validation rules.","required":["rules"],"properties":{"rules":{"type":"array","items":{"type":"object","required":["id","type","params"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.9.validation.rules.items.[INDEX].id","typeLabel":"string"},"type":{"type":"string","enum":["minLength","maxLength","pattern","email","url","phone","equals","doesNotEqual","contains","doesNotContain","minValue","maxValue","isGreaterThan","isLessThan","minSelections","maxSelections","minRanked","rankAll","minRowsAnswered","answerAllRows","isLaterThan","isEarlierThan","isBetween","isNotBetween","fileExtensionIs","fileExtensionIsNot"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.9.validation.rules.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"params":{"type":"object","additionalProperties":true,"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.9.validation.rules.items.[INDEX].params","typeLabel":"object"},"field":{"type":"string","enum":["addressLine1","addressLine2","city","state","zip","country","firstName","lastName","email","phone","company"],"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.9.validation.rules.items.[INDEX].field","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.9.validation.rules.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.9.validation.rules","typeLabel":"object[]"},"logic":{"type":"string","enum":["and","or"],"default":"and","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.9.validation.logic","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.9.validation","typeLabel":"object"}},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.9","typeLabel":"object"},{"type":"object","description":"Survey element/question inside a block. Element ids are stable public identifiers used by\nlogic, recall strings, response data, quotas, integrations, and analysis. `type` selects the\nallowed shape; unsupported fields are rejected instead of ignored.\n","required":["calUserName","id","type","headline","required"],"properties":{"id":{"type":"string","pattern":"^[a-zA-Z0-9_-]+$","description":"Stable element id. Avoid spaces and reserved ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.10.id","typeLabel":"string"},"type":{"type":"string","enum":["cal"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.10.type","typeLabel":"enum\u003cstring>"},"headline":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.10.headline.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.10.headline","typeLabel":"object"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.10.required","typeLabel":"boolean"},"calUserName":{"type":"string","minLength":1,"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.10.calUserName","typeLabel":"string"},"subheader":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.10.subheader.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.10.subheader","typeLabel":"object"},"imageUrl":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.10.imageUrl","typeLabel":"string"},"imageAltText":{"type":"object","description":"Text alternative for `imageUrl`, read by screen readers. Omit or leave empty for a decorative image (rendered as `alt=\"\"`).","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.10.imageAltText.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.10.imageAltText","typeLabel":"object"},"videoUrl":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.10.videoUrl","typeLabel":"string"},"isDraft":{"type":"boolean","description":"Draft marker used by the editor and future update rules.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.10.isDraft","typeLabel":"boolean"},"showIf":{"type":"object","description":"Show-if: the element is shown only when this condition group matches, re-evaluated live as answers above it on the same page change. A hidden element is not validated (a hidden required element never blocks submission) and its answer is not submitted. Conditions use the same operands and operators as block `logic`. Reference rule: an element's show-if may use answers from earlier blocks and from elements above it in the same block, never itself or anything below it; a violation fails with `misordered_reference` at the exact condition path. Omit it, or send an empty group, for an element that is always shown.","required":["id","connector","conditions"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.10.showIf.id","typeLabel":"string\u003ccuid2>"},"connector":{"type":"string","enum":["and","or"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.10.showIf.connector","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","items":{"oneOf":[{"type":"object","description":"Single condition. Operators such as `isSubmitted`, `isSkipped`, `isClicked`, `isAccepted`,\n`isBooked`, `isSet`, and `isEmpty` do not use `rightOperand`; comparison operators do.\n","required":["id","leftOperand","operator"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.10.showIf.conditions.items.[INDEX].oneOf.0.id","typeLabel":"string\u003ccuid2>"},"leftOperand":{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.10.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.10.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.10.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.10.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.10.showIf.conditions.items.[INDEX].oneOf.0.leftOperand","typeLabel":"object"},"operator":{"type":"string","enum":["equals","doesNotEqual","contains","doesNotContain","startsWith","doesNotStartWith","endsWith","doesNotEndWith","isSubmitted","isSkipped","isGreaterThan","isLessThan","isGreaterThanOrEqual","isLessThanOrEqual","equalsOneOf","includesAllOf","includesOneOf","doesNotIncludeOneOf","doesNotIncludeAllOf","isClicked","isNotClicked","isAccepted","isBefore","isAfter","isBooked","isPartiallySubmitted","isCompletelySubmitted","isSet","isNotSet","isEmpty","isNotEmpty","isAnyOf"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.10.showIf.conditions.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"rightOperand":{"oneOf":[{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.10.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.10.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.10.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.1","typeLabel":"number"},{"type":"array","items":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.10.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.10.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.10.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value","typeLabel":"string | number | string[]"},"columnId":{"type":"string","minLength":1,"description":"On a matrix row condition, the id of the column. Read before `value` and wins when the two disagree, so the condition survives reordering. Must be a column of the matrix. Optional: when only `value` is sent, the id is filled in from the position on write.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.10.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnId","typeLabel":"string"},"columnIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.10.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition with `isAnyOf`, the ids of the columns `value` lists. Read before `value`, like `columnId`.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.10.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.10.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0","typeLabel":"object"},{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.10.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.10.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.10.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.10.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.10.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1","typeLabel":"object"}],"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.10.showIf.conditions.items.[INDEX].oneOf.0.rightOperand","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.10.showIf.conditions.items.[INDEX].oneOf.0","typeLabel":"object"},{}],"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.10.showIf.conditions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.10.showIf.conditions","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.10.showIf","typeLabel":"object"},"code":{"type":"string","maxLength":30,"pattern":"^[a-z][a-z0-9_]*$","description":"Question code, the name the question carries in exports, webhooks and links. Optional. Starts with a lowercase letter, then lowercase letters, digits and `_`; no `__`, no trailing `_`, at most 30 characters. It must not be an SPSS reserved word (`all`, `and`, `by`, `eq`, `ge`, `gt`, `le`, `lt`, `ne`, `not`, `or`, `to`, `with`) or an export column name (`response_id`, `language`, `outcome`, ...), and must be unique among the survey's question codes, Embedded Data names and the Question IDs of other questions, ignoring case. CTA elements have no code.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.10.code","typeLabel":"string"},"calHost":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.10.calHost","typeLabel":"string"}},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.10","typeLabel":"object"},{"type":"object","description":"Survey element/question inside a block. Element ids are stable public identifiers used by\nlogic, recall strings, response data, quotas, integrations, and analysis. `type` selects the\nallowed shape; unsupported fields are rejected instead of ignored.\n","required":["rows","columns","id","type","headline","required"],"properties":{"id":{"type":"string","pattern":"^[a-zA-Z0-9_-]+$","description":"Stable element id. Avoid spaces and reserved ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.id","typeLabel":"string"},"type":{"type":"string","enum":["matrix"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.type","typeLabel":"enum\u003cstring>"},"headline":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.headline.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.headline","typeLabel":"object"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.required","typeLabel":"boolean"},"rows":{"type":"array","items":{"type":"object","required":["id","label"],"properties":{"id":{"type":"string","description":"Stable choice id.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.rows.items.[INDEX].id","typeLabel":"string"},"label":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.rows.items.[INDEX].label.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.rows.items.[INDEX].label","typeLabel":"object"},"code":{"type":"string","maxLength":20,"pattern":"^[a-z0-9][a-z0-9_]*$","description":"Answer code of an option, a matrix row or a matrix column. Optional. Lowercase letters, digits and `_`; it may start with a digit, but not with `_`; no `__`, no trailing `_`, at most 20 characters. It must not be an SPSS reserved word or an export column name, and must be unique within its question (a matrix's rows and columns are checked separately), ignoring case.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.rows.items.[INDEX].code","typeLabel":"string"},"showIf":{"type":"object","description":"Option show-if: the option (or matrix row or column) is offered only when this condition group matches, re-evaluated live as earlier answers change. It may use what its element's show-if may use: answers from earlier blocks and from elements above its element in the same block, never its own element or anything below (`misordered_reference` at the exact condition path). A question left with no option to offer is skipped and recorded as not shown. Omit it, or send an empty group, for an option that is always offered. Allowed on published surveys.","required":["id","connector","conditions"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf.id","typeLabel":"string\u003ccuid2>"},"connector":{"type":"string","enum":["and","or"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf.connector","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","items":{"oneOf":[{"type":"object","description":"Single condition. Operators such as `isSubmitted`, `isSkipped`, `isClicked`, `isAccepted`,\n`isBooked`, `isSet`, and `isEmpty` do not use `rightOperand`; comparison operators do.\n","required":["id","leftOperand","operator"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.id","typeLabel":"string\u003ccuid2>"},"leftOperand":{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand","typeLabel":"object"},"operator":{"type":"string","enum":["equals","doesNotEqual","contains","doesNotContain","startsWith","doesNotStartWith","endsWith","doesNotEndWith","isSubmitted","isSkipped","isGreaterThan","isLessThan","isGreaterThanOrEqual","isLessThanOrEqual","equalsOneOf","includesAllOf","includesOneOf","doesNotIncludeOneOf","doesNotIncludeAllOf","isClicked","isNotClicked","isAccepted","isBefore","isAfter","isBooked","isPartiallySubmitted","isCompletelySubmitted","isSet","isNotSet","isEmpty","isNotEmpty","isAnyOf"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"rightOperand":{"oneOf":[{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.1","typeLabel":"number"},{"type":"array","items":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value","typeLabel":"string | number | string[]"},"columnId":{"type":"string","minLength":1,"description":"On a matrix row condition, the id of the column. Read before `value` and wins when the two disagree, so the condition survives reordering. Must be a column of the matrix. Optional: when only `value` is sent, the id is filled in from the position on write.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnId","typeLabel":"string"},"columnIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition with `isAnyOf`, the ids of the columns `value` lists. Read before `value`, like `columnId`.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0","typeLabel":"object"},{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1","typeLabel":"object"}],"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0","typeLabel":"object"},{}],"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf.conditions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf.conditions","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.rows.items.[INDEX].showIf","typeLabel":"object"},"hidden":{"type":"boolean","description":"Hidden: the option is never offered, whatever its `showIf` says, and is recorded as not shown. Use it to retire an option on a published survey instead of deleting it (deleting an option that existed at launch is refused): it keeps its id, answer code and earlier answers, and stays in results labelled Hidden.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.rows.items.[INDEX].hidden","typeLabel":"boolean"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.rows.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.rows","typeLabel":"object[]"},"columns":{"type":"array","items":{"type":"object","required":["id","label"],"properties":{"id":{"type":"string","description":"Stable choice id.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.columns.items.[INDEX].id","typeLabel":"string"},"label":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.columns.items.[INDEX].label.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.columns.items.[INDEX].label","typeLabel":"object"},"code":{"type":"string","maxLength":20,"pattern":"^[a-z0-9][a-z0-9_]*$","description":"Answer code of an option, a matrix row or a matrix column. Optional. Lowercase letters, digits and `_`; it may start with a digit, but not with `_`; no `__`, no trailing `_`, at most 20 characters. It must not be an SPSS reserved word or an export column name, and must be unique within its question (a matrix's rows and columns are checked separately), ignoring case.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.columns.items.[INDEX].code","typeLabel":"string"},"showIf":{"type":"object","description":"Option show-if: the option (or matrix row or column) is offered only when this condition group matches, re-evaluated live as earlier answers change. It may use what its element's show-if may use: answers from earlier blocks and from elements above its element in the same block, never its own element or anything below (`misordered_reference` at the exact condition path). A question left with no option to offer is skipped and recorded as not shown. Omit it, or send an empty group, for an option that is always offered. Allowed on published surveys.","required":["id","connector","conditions"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf.id","typeLabel":"string\u003ccuid2>"},"connector":{"type":"string","enum":["and","or"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf.connector","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","items":{"oneOf":[{"type":"object","description":"Single condition. Operators such as `isSubmitted`, `isSkipped`, `isClicked`, `isAccepted`,\n`isBooked`, `isSet`, and `isEmpty` do not use `rightOperand`; comparison operators do.\n","required":["id","leftOperand","operator"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.id","typeLabel":"string\u003ccuid2>"},"leftOperand":{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand","typeLabel":"object"},"operator":{"type":"string","enum":["equals","doesNotEqual","contains","doesNotContain","startsWith","doesNotStartWith","endsWith","doesNotEndWith","isSubmitted","isSkipped","isGreaterThan","isLessThan","isGreaterThanOrEqual","isLessThanOrEqual","equalsOneOf","includesAllOf","includesOneOf","doesNotIncludeOneOf","doesNotIncludeAllOf","isClicked","isNotClicked","isAccepted","isBefore","isAfter","isBooked","isPartiallySubmitted","isCompletelySubmitted","isSet","isNotSet","isEmpty","isNotEmpty","isAnyOf"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"rightOperand":{"oneOf":[{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.1","typeLabel":"number"},{"type":"array","items":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value","typeLabel":"string | number | string[]"},"columnId":{"type":"string","minLength":1,"description":"On a matrix row condition, the id of the column. Read before `value` and wins when the two disagree, so the condition survives reordering. Must be a column of the matrix. Optional: when only `value` is sent, the id is filled in from the position on write.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnId","typeLabel":"string"},"columnIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition with `isAnyOf`, the ids of the columns `value` lists. Read before `value`, like `columnId`.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0","typeLabel":"object"},{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1","typeLabel":"object"}],"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0","typeLabel":"object"},{}],"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf.conditions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf.conditions","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.columns.items.[INDEX].showIf","typeLabel":"object"},"hidden":{"type":"boolean","description":"Hidden: the option is never offered, whatever its `showIf` says, and is recorded as not shown. Use it to retire an option on a published survey instead of deleting it (deleting an option that existed at launch is refused): it keeps its id, answer code and earlier answers, and stays in results labelled Hidden.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.columns.items.[INDEX].hidden","typeLabel":"boolean"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.columns.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.columns","typeLabel":"object[]"},"subheader":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.subheader.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.subheader","typeLabel":"object"},"imageUrl":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.imageUrl","typeLabel":"string"},"imageAltText":{"type":"object","description":"Text alternative for `imageUrl`, read by screen readers. Omit or leave empty for a decorative image (rendered as `alt=\"\"`).","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.imageAltText.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.imageAltText","typeLabel":"object"},"videoUrl":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.videoUrl","typeLabel":"string"},"isDraft":{"type":"boolean","description":"Draft marker used by the editor and future update rules.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.isDraft","typeLabel":"boolean"},"showIf":{"type":"object","description":"Show-if: the element is shown only when this condition group matches, re-evaluated live as answers above it on the same page change. A hidden element is not validated (a hidden required element never blocks submission) and its answer is not submitted. Conditions use the same operands and operators as block `logic`. Reference rule: an element's show-if may use answers from earlier blocks and from elements above it in the same block, never itself or anything below it; a violation fails with `misordered_reference` at the exact condition path. Omit it, or send an empty group, for an element that is always shown.","required":["id","connector","conditions"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.showIf.id","typeLabel":"string\u003ccuid2>"},"connector":{"type":"string","enum":["and","or"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.showIf.connector","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","items":{"oneOf":[{"type":"object","description":"Single condition. Operators such as `isSubmitted`, `isSkipped`, `isClicked`, `isAccepted`,\n`isBooked`, `isSet`, and `isEmpty` do not use `rightOperand`; comparison operators do.\n","required":["id","leftOperand","operator"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.showIf.conditions.items.[INDEX].oneOf.0.id","typeLabel":"string\u003ccuid2>"},"leftOperand":{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.showIf.conditions.items.[INDEX].oneOf.0.leftOperand","typeLabel":"object"},"operator":{"type":"string","enum":["equals","doesNotEqual","contains","doesNotContain","startsWith","doesNotStartWith","endsWith","doesNotEndWith","isSubmitted","isSkipped","isGreaterThan","isLessThan","isGreaterThanOrEqual","isLessThanOrEqual","equalsOneOf","includesAllOf","includesOneOf","doesNotIncludeOneOf","doesNotIncludeAllOf","isClicked","isNotClicked","isAccepted","isBefore","isAfter","isBooked","isPartiallySubmitted","isCompletelySubmitted","isSet","isNotSet","isEmpty","isNotEmpty","isAnyOf"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.showIf.conditions.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"rightOperand":{"oneOf":[{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.1","typeLabel":"number"},{"type":"array","items":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value","typeLabel":"string | number | string[]"},"columnId":{"type":"string","minLength":1,"description":"On a matrix row condition, the id of the column. Read before `value` and wins when the two disagree, so the condition survives reordering. Must be a column of the matrix. Optional: when only `value` is sent, the id is filled in from the position on write.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnId","typeLabel":"string"},"columnIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition with `isAnyOf`, the ids of the columns `value` lists. Read before `value`, like `columnId`.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0","typeLabel":"object"},{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1","typeLabel":"object"}],"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.showIf.conditions.items.[INDEX].oneOf.0.rightOperand","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.showIf.conditions.items.[INDEX].oneOf.0","typeLabel":"object"},{}],"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.showIf.conditions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.showIf.conditions","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.showIf","typeLabel":"object"},"code":{"type":"string","maxLength":30,"pattern":"^[a-z][a-z0-9_]*$","description":"Question code, the name the question carries in exports, webhooks and links. Optional. Starts with a lowercase letter, then lowercase letters, digits and `_`; no `__`, no trailing `_`, at most 30 characters. It must not be an SPSS reserved word (`all`, `and`, `by`, `eq`, `ge`, `gt`, `le`, `lt`, `ne`, `not`, `or`, `to`, `with`) or an export column name (`response_id`, `language`, `outcome`, ...), and must be unique among the survey's question codes, Embedded Data names and the Question IDs of other questions, ignoring case. CTA elements have no code.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.code","typeLabel":"string"},"shuffleOption":{"type":"string","enum":["none","all","exceptLast","reverseOrderOccasionally","reverseOrderExceptLast"],"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.shuffleOption","typeLabel":"enum\u003cstring>"},"validation":{"type":"object","description":"Optional element-level validation rules.","required":["rules"],"properties":{"rules":{"type":"array","items":{"type":"object","required":["id","type","params"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.validation.rules.items.[INDEX].id","typeLabel":"string"},"type":{"type":"string","enum":["minLength","maxLength","pattern","email","url","phone","equals","doesNotEqual","contains","doesNotContain","minValue","maxValue","isGreaterThan","isLessThan","minSelections","maxSelections","minRanked","rankAll","minRowsAnswered","answerAllRows","isLaterThan","isEarlierThan","isBetween","isNotBetween","fileExtensionIs","fileExtensionIsNot"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.validation.rules.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"params":{"type":"object","additionalProperties":true,"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.validation.rules.items.[INDEX].params","typeLabel":"object"},"field":{"type":"string","enum":["addressLine1","addressLine2","city","state","zip","country","firstName","lastName","email","phone","company"],"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.validation.rules.items.[INDEX].field","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.validation.rules.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.validation.rules","typeLabel":"object[]"},"logic":{"type":"string","enum":["and","or"],"default":"and","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.validation.logic","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11.validation","typeLabel":"object"}},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.11","typeLabel":"object"},{"type":"object","description":"Survey element/question inside a block. Element ids are stable public identifiers used by\nlogic, recall strings, response data, quotas, integrations, and analysis. `type` selects the\nallowed shape; unsupported fields are rejected instead of ignored.\n","required":["addressLine1","addressLine2","city","state","zip","country","id","type","headline","required"],"properties":{"id":{"type":"string","pattern":"^[a-zA-Z0-9_-]+$","description":"Stable element id. Avoid spaces and reserved ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.12.id","typeLabel":"string"},"type":{"type":"string","enum":["address"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.12.type","typeLabel":"enum\u003cstring>"},"headline":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.12.headline.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.12.headline","typeLabel":"object"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.12.required","typeLabel":"boolean"},"addressLine1":{"type":"object","description":"Field config for address and contact info elements.","required":["show","required","placeholder"],"properties":{"show":{"type":"boolean","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.12.addressLine1.show","typeLabel":"boolean"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.12.addressLine1.required","typeLabel":"boolean"},"placeholder":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.12.addressLine1.placeholder.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.12.addressLine1.placeholder","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.12.addressLine1","typeLabel":"object"},"addressLine2":{"type":"object","description":"Field config for address and contact info elements.","required":["show","required","placeholder"],"properties":{"show":{"type":"boolean","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.12.addressLine2.show","typeLabel":"boolean"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.12.addressLine2.required","typeLabel":"boolean"},"placeholder":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.12.addressLine2.placeholder.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.12.addressLine2.placeholder","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.12.addressLine2","typeLabel":"object"},"city":{"type":"object","description":"Field config for address and contact info elements.","required":["show","required","placeholder"],"properties":{"show":{"type":"boolean","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.12.city.show","typeLabel":"boolean"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.12.city.required","typeLabel":"boolean"},"placeholder":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.12.city.placeholder.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.12.city.placeholder","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.12.city","typeLabel":"object"},"state":{"type":"object","description":"Field config for address and contact info elements.","required":["show","required","placeholder"],"properties":{"show":{"type":"boolean","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.12.state.show","typeLabel":"boolean"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.12.state.required","typeLabel":"boolean"},"placeholder":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.12.state.placeholder.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.12.state.placeholder","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.12.state","typeLabel":"object"},"zip":{"type":"object","description":"Field config for address and contact info elements.","required":["show","required","placeholder"],"properties":{"show":{"type":"boolean","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.12.zip.show","typeLabel":"boolean"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.12.zip.required","typeLabel":"boolean"},"placeholder":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.12.zip.placeholder.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.12.zip.placeholder","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.12.zip","typeLabel":"object"},"country":{"type":"object","description":"Field config for address and contact info elements.","required":["show","required","placeholder"],"properties":{"show":{"type":"boolean","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.12.country.show","typeLabel":"boolean"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.12.country.required","typeLabel":"boolean"},"placeholder":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.12.country.placeholder.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.12.country.placeholder","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.12.country","typeLabel":"object"},"subheader":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.12.subheader.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.12.subheader","typeLabel":"object"},"imageUrl":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.12.imageUrl","typeLabel":"string"},"imageAltText":{"type":"object","description":"Text alternative for `imageUrl`, read by screen readers. Omit or leave empty for a decorative image (rendered as `alt=\"\"`).","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.12.imageAltText.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.12.imageAltText","typeLabel":"object"},"videoUrl":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.12.videoUrl","typeLabel":"string"},"isDraft":{"type":"boolean","description":"Draft marker used by the editor and future update rules.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.12.isDraft","typeLabel":"boolean"},"showIf":{"type":"object","description":"Show-if: the element is shown only when this condition group matches, re-evaluated live as answers above it on the same page change. A hidden element is not validated (a hidden required element never blocks submission) and its answer is not submitted. Conditions use the same operands and operators as block `logic`. Reference rule: an element's show-if may use answers from earlier blocks and from elements above it in the same block, never itself or anything below it; a violation fails with `misordered_reference` at the exact condition path. Omit it, or send an empty group, for an element that is always shown.","required":["id","connector","conditions"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.12.showIf.id","typeLabel":"string\u003ccuid2>"},"connector":{"type":"string","enum":["and","or"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.12.showIf.connector","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","items":{"oneOf":[{"type":"object","description":"Single condition. Operators such as `isSubmitted`, `isSkipped`, `isClicked`, `isAccepted`,\n`isBooked`, `isSet`, and `isEmpty` do not use `rightOperand`; comparison operators do.\n","required":["id","leftOperand","operator"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.12.showIf.conditions.items.[INDEX].oneOf.0.id","typeLabel":"string\u003ccuid2>"},"leftOperand":{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.12.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.12.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.12.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.12.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.12.showIf.conditions.items.[INDEX].oneOf.0.leftOperand","typeLabel":"object"},"operator":{"type":"string","enum":["equals","doesNotEqual","contains","doesNotContain","startsWith","doesNotStartWith","endsWith","doesNotEndWith","isSubmitted","isSkipped","isGreaterThan","isLessThan","isGreaterThanOrEqual","isLessThanOrEqual","equalsOneOf","includesAllOf","includesOneOf","doesNotIncludeOneOf","doesNotIncludeAllOf","isClicked","isNotClicked","isAccepted","isBefore","isAfter","isBooked","isPartiallySubmitted","isCompletelySubmitted","isSet","isNotSet","isEmpty","isNotEmpty","isAnyOf"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.12.showIf.conditions.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"rightOperand":{"oneOf":[{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.12.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.12.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.12.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.1","typeLabel":"number"},{"type":"array","items":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.12.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.12.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.12.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value","typeLabel":"string | number | string[]"},"columnId":{"type":"string","minLength":1,"description":"On a matrix row condition, the id of the column. Read before `value` and wins when the two disagree, so the condition survives reordering. Must be a column of the matrix. Optional: when only `value` is sent, the id is filled in from the position on write.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.12.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnId","typeLabel":"string"},"columnIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.12.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition with `isAnyOf`, the ids of the columns `value` lists. Read before `value`, like `columnId`.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.12.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.12.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0","typeLabel":"object"},{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.12.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.12.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.12.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.12.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.12.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1","typeLabel":"object"}],"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.12.showIf.conditions.items.[INDEX].oneOf.0.rightOperand","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.12.showIf.conditions.items.[INDEX].oneOf.0","typeLabel":"object"},{}],"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.12.showIf.conditions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.12.showIf.conditions","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.12.showIf","typeLabel":"object"},"code":{"type":"string","maxLength":30,"pattern":"^[a-z][a-z0-9_]*$","description":"Question code, the name the question carries in exports, webhooks and links. Optional. Starts with a lowercase letter, then lowercase letters, digits and `_`; no `__`, no trailing `_`, at most 30 characters. It must not be an SPSS reserved word (`all`, `and`, `by`, `eq`, `ge`, `gt`, `le`, `lt`, `ne`, `not`, `or`, `to`, `with`) or an export column name (`response_id`, `language`, `outcome`, ...), and must be unique among the survey's question codes, Embedded Data names and the Question IDs of other questions, ignoring case. CTA elements have no code.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.12.code","typeLabel":"string"},"validation":{"type":"object","description":"Optional element-level validation rules.","required":["rules"],"properties":{"rules":{"type":"array","items":{"type":"object","required":["id","type","params"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.12.validation.rules.items.[INDEX].id","typeLabel":"string"},"type":{"type":"string","enum":["minLength","maxLength","pattern","email","url","phone","equals","doesNotEqual","contains","doesNotContain","minValue","maxValue","isGreaterThan","isLessThan","minSelections","maxSelections","minRanked","rankAll","minRowsAnswered","answerAllRows","isLaterThan","isEarlierThan","isBetween","isNotBetween","fileExtensionIs","fileExtensionIsNot"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.12.validation.rules.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"params":{"type":"object","additionalProperties":true,"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.12.validation.rules.items.[INDEX].params","typeLabel":"object"},"field":{"type":"string","enum":["addressLine1","addressLine2","city","state","zip","country","firstName","lastName","email","phone","company"],"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.12.validation.rules.items.[INDEX].field","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.12.validation.rules.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.12.validation.rules","typeLabel":"object[]"},"logic":{"type":"string","enum":["and","or"],"default":"and","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.12.validation.logic","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.12.validation","typeLabel":"object"}},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.12","typeLabel":"object"},{"type":"object","description":"Survey element/question inside a block. Element ids are stable public identifiers used by\nlogic, recall strings, response data, quotas, integrations, and analysis. `type` selects the\nallowed shape; unsupported fields are rejected instead of ignored.\n","required":["choices","id","type","headline","required"],"properties":{"id":{"type":"string","pattern":"^[a-zA-Z0-9_-]+$","description":"Stable element id. Avoid spaces and reserved ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.id","typeLabel":"string"},"type":{"type":"string","enum":["ranking"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.type","typeLabel":"enum\u003cstring>"},"headline":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.headline.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.headline","typeLabel":"object"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.required","typeLabel":"boolean"},"choices":{"type":"array","minItems":2,"maxItems":25,"items":{"type":"object","required":["id","label"],"properties":{"id":{"type":"string","description":"Stable choice id.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.choices.items.[INDEX].id","typeLabel":"string"},"label":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.choices.items.[INDEX].label.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.choices.items.[INDEX].label","typeLabel":"object"},"code":{"type":"string","maxLength":20,"pattern":"^[a-z0-9][a-z0-9_]*$","description":"Answer code of an option, a matrix row or a matrix column. Optional. Lowercase letters, digits and `_`; it may start with a digit, but not with `_`; no `__`, no trailing `_`, at most 20 characters. It must not be an SPSS reserved word or an export column name, and must be unique within its question (a matrix's rows and columns are checked separately), ignoring case.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.choices.items.[INDEX].code","typeLabel":"string"},"showIf":{"type":"object","description":"Option show-if: the option (or matrix row or column) is offered only when this condition group matches, re-evaluated live as earlier answers change. It may use what its element's show-if may use: answers from earlier blocks and from elements above its element in the same block, never its own element or anything below (`misordered_reference` at the exact condition path). A question left with no option to offer is skipped and recorded as not shown. Omit it, or send an empty group, for an option that is always offered. Allowed on published surveys.","required":["id","connector","conditions"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf.id","typeLabel":"string\u003ccuid2>"},"connector":{"type":"string","enum":["and","or"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf.connector","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","items":{"oneOf":[{"type":"object","description":"Single condition. Operators such as `isSubmitted`, `isSkipped`, `isClicked`, `isAccepted`,\n`isBooked`, `isSet`, and `isEmpty` do not use `rightOperand`; comparison operators do.\n","required":["id","leftOperand","operator"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.id","typeLabel":"string\u003ccuid2>"},"leftOperand":{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand","typeLabel":"object"},"operator":{"type":"string","enum":["equals","doesNotEqual","contains","doesNotContain","startsWith","doesNotStartWith","endsWith","doesNotEndWith","isSubmitted","isSkipped","isGreaterThan","isLessThan","isGreaterThanOrEqual","isLessThanOrEqual","equalsOneOf","includesAllOf","includesOneOf","doesNotIncludeOneOf","doesNotIncludeAllOf","isClicked","isNotClicked","isAccepted","isBefore","isAfter","isBooked","isPartiallySubmitted","isCompletelySubmitted","isSet","isNotSet","isEmpty","isNotEmpty","isAnyOf"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"rightOperand":{"oneOf":[{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.1","typeLabel":"number"},{"type":"array","items":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value","typeLabel":"string | number | string[]"},"columnId":{"type":"string","minLength":1,"description":"On a matrix row condition, the id of the column. Read before `value` and wins when the two disagree, so the condition survives reordering. Must be a column of the matrix. Optional: when only `value` is sent, the id is filled in from the position on write.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnId","typeLabel":"string"},"columnIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition with `isAnyOf`, the ids of the columns `value` lists. Read before `value`, like `columnId`.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0","typeLabel":"object"},{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1","typeLabel":"object"}],"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0","typeLabel":"object"},{}],"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf.conditions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf.conditions","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.choices.items.[INDEX].showIf","typeLabel":"object"},"hidden":{"type":"boolean","description":"Hidden: the option is never offered, whatever its `showIf` says, and is recorded as not shown. Use it to retire an option on a published survey instead of deleting it (deleting an option that existed at launch is refused): it keeps its id, answer code and earlier answers, and stays in results labelled Hidden.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.choices.items.[INDEX].hidden","typeLabel":"boolean"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.choices.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.choices","typeLabel":"object[]"},"subheader":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.subheader.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.subheader","typeLabel":"object"},"imageUrl":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.imageUrl","typeLabel":"string"},"imageAltText":{"type":"object","description":"Text alternative for `imageUrl`, read by screen readers. Omit or leave empty for a decorative image (rendered as `alt=\"\"`).","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.imageAltText.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.imageAltText","typeLabel":"object"},"videoUrl":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.videoUrl","typeLabel":"string"},"isDraft":{"type":"boolean","description":"Draft marker used by the editor and future update rules.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.isDraft","typeLabel":"boolean"},"showIf":{"type":"object","description":"Show-if: the element is shown only when this condition group matches, re-evaluated live as answers above it on the same page change. A hidden element is not validated (a hidden required element never blocks submission) and its answer is not submitted. Conditions use the same operands and operators as block `logic`. Reference rule: an element's show-if may use answers from earlier blocks and from elements above it in the same block, never itself or anything below it; a violation fails with `misordered_reference` at the exact condition path. Omit it, or send an empty group, for an element that is always shown.","required":["id","connector","conditions"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.showIf.id","typeLabel":"string\u003ccuid2>"},"connector":{"type":"string","enum":["and","or"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.showIf.connector","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","items":{"oneOf":[{"type":"object","description":"Single condition. Operators such as `isSubmitted`, `isSkipped`, `isClicked`, `isAccepted`,\n`isBooked`, `isSet`, and `isEmpty` do not use `rightOperand`; comparison operators do.\n","required":["id","leftOperand","operator"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.showIf.conditions.items.[INDEX].oneOf.0.id","typeLabel":"string\u003ccuid2>"},"leftOperand":{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.showIf.conditions.items.[INDEX].oneOf.0.leftOperand","typeLabel":"object"},"operator":{"type":"string","enum":["equals","doesNotEqual","contains","doesNotContain","startsWith","doesNotStartWith","endsWith","doesNotEndWith","isSubmitted","isSkipped","isGreaterThan","isLessThan","isGreaterThanOrEqual","isLessThanOrEqual","equalsOneOf","includesAllOf","includesOneOf","doesNotIncludeOneOf","doesNotIncludeAllOf","isClicked","isNotClicked","isAccepted","isBefore","isAfter","isBooked","isPartiallySubmitted","isCompletelySubmitted","isSet","isNotSet","isEmpty","isNotEmpty","isAnyOf"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.showIf.conditions.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"rightOperand":{"oneOf":[{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.1","typeLabel":"number"},{"type":"array","items":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value","typeLabel":"string | number | string[]"},"columnId":{"type":"string","minLength":1,"description":"On a matrix row condition, the id of the column. Read before `value` and wins when the two disagree, so the condition survives reordering. Must be a column of the matrix. Optional: when only `value` is sent, the id is filled in from the position on write.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnId","typeLabel":"string"},"columnIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition with `isAnyOf`, the ids of the columns `value` lists. Read before `value`, like `columnId`.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0","typeLabel":"object"},{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1","typeLabel":"object"}],"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.showIf.conditions.items.[INDEX].oneOf.0.rightOperand","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.showIf.conditions.items.[INDEX].oneOf.0","typeLabel":"object"},{}],"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.showIf.conditions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.showIf.conditions","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.showIf","typeLabel":"object"},"code":{"type":"string","maxLength":30,"pattern":"^[a-z][a-z0-9_]*$","description":"Question code, the name the question carries in exports, webhooks and links. Optional. Starts with a lowercase letter, then lowercase letters, digits and `_`; no `__`, no trailing `_`, at most 30 characters. It must not be an SPSS reserved word (`all`, `and`, `by`, `eq`, `ge`, `gt`, `le`, `lt`, `ne`, `not`, `or`, `to`, `with`) or an export column name (`response_id`, `language`, `outcome`, ...), and must be unique among the survey's question codes, Embedded Data names and the Question IDs of other questions, ignoring case. CTA elements have no code.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.code","typeLabel":"string"},"optionsCopiedFrom":{"type":"string","minLength":1,"description":"Copied options: the id of an earlier element whose options this element copies (\"only the brands you know\"). Choices copy from a single select, multi select or ranking; pictures from a picture selection (matrix rows are not copied: give rows a `showIf` on the source instead). Write the copies yourself: each copied option keeps the source option's `id` and `code`, and carries a `showIf` \"picked in the source\" (`includesOneOf` with its own id, or `equals` when the source is a single select), so the element offers exactly the options picked there. Copied codes follow the source's: a code sent for a copy is replaced by the source option's. Fixed options next to the copies (such as \"None of these\", id `none`) get the next code free in every linked element. The source must exist (`dangling_reference`), sit in an earlier block or above this element on its block (`misordered_reference`), and have options of the same kind (`invalid_reference`). To bring in options the source gained later, add them the same way.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.optionsCopiedFrom","typeLabel":"string"},"otherOptionPlaceholder":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.otherOptionPlaceholder.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.otherOptionPlaceholder","typeLabel":"object"},"shuffleOption":{"type":"string","enum":["none","all","exceptLast","reverseOrderOccasionally","reverseOrderExceptLast"],"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.shuffleOption","typeLabel":"enum\u003cstring>"},"validation":{"type":"object","description":"Optional element-level validation rules.","required":["rules"],"properties":{"rules":{"type":"array","items":{"type":"object","required":["id","type","params"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.validation.rules.items.[INDEX].id","typeLabel":"string"},"type":{"type":"string","enum":["minLength","maxLength","pattern","email","url","phone","equals","doesNotEqual","contains","doesNotContain","minValue","maxValue","isGreaterThan","isLessThan","minSelections","maxSelections","minRanked","rankAll","minRowsAnswered","answerAllRows","isLaterThan","isEarlierThan","isBetween","isNotBetween","fileExtensionIs","fileExtensionIsNot"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.validation.rules.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"params":{"type":"object","additionalProperties":true,"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.validation.rules.items.[INDEX].params","typeLabel":"object"},"field":{"type":"string","enum":["addressLine1","addressLine2","city","state","zip","country","firstName","lastName","email","phone","company"],"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.validation.rules.items.[INDEX].field","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.validation.rules.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.validation.rules","typeLabel":"object[]"},"logic":{"type":"string","enum":["and","or"],"default":"and","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.validation.logic","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13.validation","typeLabel":"object"}},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.13","typeLabel":"object"},{"type":"object","description":"Survey element/question inside a block. Element ids are stable public identifiers used by\nlogic, recall strings, response data, quotas, integrations, and analysis. `type` selects the\nallowed shape; unsupported fields are rejected instead of ignored.\n","required":["firstName","lastName","email","phone","company","id","type","headline","required"],"properties":{"id":{"type":"string","pattern":"^[a-zA-Z0-9_-]+$","description":"Stable element id. Avoid spaces and reserved ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.14.id","typeLabel":"string"},"type":{"type":"string","enum":["contactInfo"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.14.type","typeLabel":"enum\u003cstring>"},"headline":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.14.headline.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.14.headline","typeLabel":"object"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.14.required","typeLabel":"boolean"},"firstName":{"type":"object","description":"Field config for address and contact info elements.","required":["show","required","placeholder"],"properties":{"show":{"type":"boolean","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.14.firstName.show","typeLabel":"boolean"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.14.firstName.required","typeLabel":"boolean"},"placeholder":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.14.firstName.placeholder.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.14.firstName.placeholder","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.14.firstName","typeLabel":"object"},"lastName":{"type":"object","description":"Field config for address and contact info elements.","required":["show","required","placeholder"],"properties":{"show":{"type":"boolean","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.14.lastName.show","typeLabel":"boolean"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.14.lastName.required","typeLabel":"boolean"},"placeholder":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.14.lastName.placeholder.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.14.lastName.placeholder","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.14.lastName","typeLabel":"object"},"email":{"type":"object","description":"Field config for address and contact info elements.","required":["show","required","placeholder"],"properties":{"show":{"type":"boolean","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.14.email.show","typeLabel":"boolean"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.14.email.required","typeLabel":"boolean"},"placeholder":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.14.email.placeholder.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.14.email.placeholder","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.14.email","typeLabel":"object"},"phone":{"type":"object","description":"Field config for address and contact info elements.","required":["show","required","placeholder"],"properties":{"show":{"type":"boolean","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.14.phone.show","typeLabel":"boolean"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.14.phone.required","typeLabel":"boolean"},"placeholder":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.14.phone.placeholder.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.14.phone.placeholder","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.14.phone","typeLabel":"object"},"company":{"type":"object","description":"Field config for address and contact info elements.","required":["show","required","placeholder"],"properties":{"show":{"type":"boolean","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.14.company.show","typeLabel":"boolean"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.14.company.required","typeLabel":"boolean"},"placeholder":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.14.company.placeholder.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.14.company.placeholder","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.14.company","typeLabel":"object"},"subheader":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.14.subheader.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.14.subheader","typeLabel":"object"},"imageUrl":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.14.imageUrl","typeLabel":"string"},"imageAltText":{"type":"object","description":"Text alternative for `imageUrl`, read by screen readers. Omit or leave empty for a decorative image (rendered as `alt=\"\"`).","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.14.imageAltText.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.14.imageAltText","typeLabel":"object"},"videoUrl":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.14.videoUrl","typeLabel":"string"},"isDraft":{"type":"boolean","description":"Draft marker used by the editor and future update rules.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.14.isDraft","typeLabel":"boolean"},"showIf":{"type":"object","description":"Show-if: the element is shown only when this condition group matches, re-evaluated live as answers above it on the same page change. A hidden element is not validated (a hidden required element never blocks submission) and its answer is not submitted. Conditions use the same operands and operators as block `logic`. Reference rule: an element's show-if may use answers from earlier blocks and from elements above it in the same block, never itself or anything below it; a violation fails with `misordered_reference` at the exact condition path. Omit it, or send an empty group, for an element that is always shown.","required":["id","connector","conditions"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.14.showIf.id","typeLabel":"string\u003ccuid2>"},"connector":{"type":"string","enum":["and","or"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.14.showIf.connector","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","items":{"oneOf":[{"type":"object","description":"Single condition. Operators such as `isSubmitted`, `isSkipped`, `isClicked`, `isAccepted`,\n`isBooked`, `isSet`, and `isEmpty` do not use `rightOperand`; comparison operators do.\n","required":["id","leftOperand","operator"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.14.showIf.conditions.items.[INDEX].oneOf.0.id","typeLabel":"string\u003ccuid2>"},"leftOperand":{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.14.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.14.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.14.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.14.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.14.showIf.conditions.items.[INDEX].oneOf.0.leftOperand","typeLabel":"object"},"operator":{"type":"string","enum":["equals","doesNotEqual","contains","doesNotContain","startsWith","doesNotStartWith","endsWith","doesNotEndWith","isSubmitted","isSkipped","isGreaterThan","isLessThan","isGreaterThanOrEqual","isLessThanOrEqual","equalsOneOf","includesAllOf","includesOneOf","doesNotIncludeOneOf","doesNotIncludeAllOf","isClicked","isNotClicked","isAccepted","isBefore","isAfter","isBooked","isPartiallySubmitted","isCompletelySubmitted","isSet","isNotSet","isEmpty","isNotEmpty","isAnyOf"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.14.showIf.conditions.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"rightOperand":{"oneOf":[{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.14.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.14.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.14.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.1","typeLabel":"number"},{"type":"array","items":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.14.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.14.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.14.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value","typeLabel":"string | number | string[]"},"columnId":{"type":"string","minLength":1,"description":"On a matrix row condition, the id of the column. Read before `value` and wins when the two disagree, so the condition survives reordering. Must be a column of the matrix. Optional: when only `value` is sent, the id is filled in from the position on write.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.14.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnId","typeLabel":"string"},"columnIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.14.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition with `isAnyOf`, the ids of the columns `value` lists. Read before `value`, like `columnId`.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.14.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.14.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0","typeLabel":"object"},{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.14.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.14.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.14.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.14.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.14.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1","typeLabel":"object"}],"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.14.showIf.conditions.items.[INDEX].oneOf.0.rightOperand","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.14.showIf.conditions.items.[INDEX].oneOf.0","typeLabel":"object"},{}],"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.14.showIf.conditions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.14.showIf.conditions","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.14.showIf","typeLabel":"object"},"code":{"type":"string","maxLength":30,"pattern":"^[a-z][a-z0-9_]*$","description":"Question code, the name the question carries in exports, webhooks and links. Optional. Starts with a lowercase letter, then lowercase letters, digits and `_`; no `__`, no trailing `_`, at most 30 characters. It must not be an SPSS reserved word (`all`, `and`, `by`, `eq`, `ge`, `gt`, `le`, `lt`, `ne`, `not`, `or`, `to`, `with`) or an export column name (`response_id`, `language`, `outcome`, ...), and must be unique among the survey's question codes, Embedded Data names and the Question IDs of other questions, ignoring case. CTA elements have no code.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.14.code","typeLabel":"string"},"validation":{"type":"object","description":"Optional element-level validation rules.","required":["rules"],"properties":{"rules":{"type":"array","items":{"type":"object","required":["id","type","params"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.14.validation.rules.items.[INDEX].id","typeLabel":"string"},"type":{"type":"string","enum":["minLength","maxLength","pattern","email","url","phone","equals","doesNotEqual","contains","doesNotContain","minValue","maxValue","isGreaterThan","isLessThan","minSelections","maxSelections","minRanked","rankAll","minRowsAnswered","answerAllRows","isLaterThan","isEarlierThan","isBetween","isNotBetween","fileExtensionIs","fileExtensionIsNot"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.14.validation.rules.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"params":{"type":"object","additionalProperties":true,"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.14.validation.rules.items.[INDEX].params","typeLabel":"object"},"field":{"type":"string","enum":["addressLine1","addressLine2","city","state","zip","country","firstName","lastName","email","phone","company"],"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.14.validation.rules.items.[INDEX].field","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.14.validation.rules.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.14.validation.rules","typeLabel":"object[]"},"logic":{"type":"string","enum":["and","or"],"default":"and","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.14.validation.logic","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.14.validation","typeLabel":"object"}},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.14","typeLabel":"object"},{"type":"object","description":"Survey element/question inside a block. Element ids are stable public identifiers used by\nlogic, recall strings, response data, quotas, integrations, and analysis. `type` selects the\nallowed shape; unsupported fields are rejected instead of ignored.\n","required":["scale","range","id","type","headline","required"],"properties":{"id":{"type":"string","pattern":"^[a-zA-Z0-9_-]+$","description":"Stable element id. Avoid spaces and reserved ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.15.id","typeLabel":"string"},"type":{"type":"string","enum":["csat"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.15.type","typeLabel":"enum\u003cstring>"},"headline":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.15.headline.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.15.headline","typeLabel":"object"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.15.required","typeLabel":"boolean"},"scale":{"type":"string","enum":["number","smiley","star"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.15.scale","typeLabel":"enum\u003cstring>"},"range":{"type":"integer","enum":[5],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.15.range","typeLabel":"enum\u003cinteger>"},"subheader":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.15.subheader.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.15.subheader","typeLabel":"object"},"imageUrl":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.15.imageUrl","typeLabel":"string"},"imageAltText":{"type":"object","description":"Text alternative for `imageUrl`, read by screen readers. Omit or leave empty for a decorative image (rendered as `alt=\"\"`).","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.15.imageAltText.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.15.imageAltText","typeLabel":"object"},"videoUrl":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.15.videoUrl","typeLabel":"string"},"isDraft":{"type":"boolean","description":"Draft marker used by the editor and future update rules.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.15.isDraft","typeLabel":"boolean"},"showIf":{"type":"object","description":"Show-if: the element is shown only when this condition group matches, re-evaluated live as answers above it on the same page change. A hidden element is not validated (a hidden required element never blocks submission) and its answer is not submitted. Conditions use the same operands and operators as block `logic`. Reference rule: an element's show-if may use answers from earlier blocks and from elements above it in the same block, never itself or anything below it; a violation fails with `misordered_reference` at the exact condition path. Omit it, or send an empty group, for an element that is always shown.","required":["id","connector","conditions"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.15.showIf.id","typeLabel":"string\u003ccuid2>"},"connector":{"type":"string","enum":["and","or"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.15.showIf.connector","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","items":{"oneOf":[{"type":"object","description":"Single condition. Operators such as `isSubmitted`, `isSkipped`, `isClicked`, `isAccepted`,\n`isBooked`, `isSet`, and `isEmpty` do not use `rightOperand`; comparison operators do.\n","required":["id","leftOperand","operator"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.15.showIf.conditions.items.[INDEX].oneOf.0.id","typeLabel":"string\u003ccuid2>"},"leftOperand":{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.15.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.15.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.15.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.15.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.15.showIf.conditions.items.[INDEX].oneOf.0.leftOperand","typeLabel":"object"},"operator":{"type":"string","enum":["equals","doesNotEqual","contains","doesNotContain","startsWith","doesNotStartWith","endsWith","doesNotEndWith","isSubmitted","isSkipped","isGreaterThan","isLessThan","isGreaterThanOrEqual","isLessThanOrEqual","equalsOneOf","includesAllOf","includesOneOf","doesNotIncludeOneOf","doesNotIncludeAllOf","isClicked","isNotClicked","isAccepted","isBefore","isAfter","isBooked","isPartiallySubmitted","isCompletelySubmitted","isSet","isNotSet","isEmpty","isNotEmpty","isAnyOf"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.15.showIf.conditions.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"rightOperand":{"oneOf":[{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.15.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.15.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.15.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.1","typeLabel":"number"},{"type":"array","items":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.15.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.15.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.15.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value","typeLabel":"string | number | string[]"},"columnId":{"type":"string","minLength":1,"description":"On a matrix row condition, the id of the column. Read before `value` and wins when the two disagree, so the condition survives reordering. Must be a column of the matrix. Optional: when only `value` is sent, the id is filled in from the position on write.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.15.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnId","typeLabel":"string"},"columnIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.15.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition with `isAnyOf`, the ids of the columns `value` lists. Read before `value`, like `columnId`.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.15.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.15.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0","typeLabel":"object"},{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.15.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.15.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.15.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.15.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.15.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1","typeLabel":"object"}],"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.15.showIf.conditions.items.[INDEX].oneOf.0.rightOperand","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.15.showIf.conditions.items.[INDEX].oneOf.0","typeLabel":"object"},{}],"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.15.showIf.conditions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.15.showIf.conditions","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.15.showIf","typeLabel":"object"},"code":{"type":"string","maxLength":30,"pattern":"^[a-z][a-z0-9_]*$","description":"Question code, the name the question carries in exports, webhooks and links. Optional. Starts with a lowercase letter, then lowercase letters, digits and `_`; no `__`, no trailing `_`, at most 30 characters. It must not be an SPSS reserved word (`all`, `and`, `by`, `eq`, `ge`, `gt`, `le`, `lt`, `ne`, `not`, `or`, `to`, `with`) or an export column name (`response_id`, `language`, `outcome`, ...), and must be unique among the survey's question codes, Embedded Data names and the Question IDs of other questions, ignoring case. CTA elements have no code.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.15.code","typeLabel":"string"},"lowerLabel":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.15.lowerLabel.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.15.lowerLabel","typeLabel":"object"},"upperLabel":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.15.upperLabel.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.15.upperLabel","typeLabel":"object"},"isColorCodingEnabled":{"type":"boolean","default":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.15.isColorCodingEnabled","typeLabel":"boolean"}},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.15","typeLabel":"object"},{"type":"object","description":"Survey element/question inside a block. Element ids are stable public identifiers used by\nlogic, recall strings, response data, quotas, integrations, and analysis. `type` selects the\nallowed shape; unsupported fields are rejected instead of ignored.\n","required":["scale","range","id","type","headline","required"],"properties":{"id":{"type":"string","pattern":"^[a-zA-Z0-9_-]+$","description":"Stable element id. Avoid spaces and reserved ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.16.id","typeLabel":"string"},"type":{"type":"string","enum":["ces"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.16.type","typeLabel":"enum\u003cstring>"},"headline":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.16.headline.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.16.headline","typeLabel":"object"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.16.required","typeLabel":"boolean"},"scale":{"type":"string","enum":["number","smiley","star"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.16.scale","typeLabel":"enum\u003cstring>"},"range":{"type":"integer","enum":[5,7],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.16.range","typeLabel":"enum\u003cinteger>"},"subheader":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.16.subheader.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.16.subheader","typeLabel":"object"},"imageUrl":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.16.imageUrl","typeLabel":"string"},"imageAltText":{"type":"object","description":"Text alternative for `imageUrl`, read by screen readers. Omit or leave empty for a decorative image (rendered as `alt=\"\"`).","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.16.imageAltText.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.16.imageAltText","typeLabel":"object"},"videoUrl":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.16.videoUrl","typeLabel":"string"},"isDraft":{"type":"boolean","description":"Draft marker used by the editor and future update rules.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.16.isDraft","typeLabel":"boolean"},"showIf":{"type":"object","description":"Show-if: the element is shown only when this condition group matches, re-evaluated live as answers above it on the same page change. A hidden element is not validated (a hidden required element never blocks submission) and its answer is not submitted. Conditions use the same operands and operators as block `logic`. Reference rule: an element's show-if may use answers from earlier blocks and from elements above it in the same block, never itself or anything below it; a violation fails with `misordered_reference` at the exact condition path. Omit it, or send an empty group, for an element that is always shown.","required":["id","connector","conditions"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.16.showIf.id","typeLabel":"string\u003ccuid2>"},"connector":{"type":"string","enum":["and","or"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.16.showIf.connector","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","items":{"oneOf":[{"type":"object","description":"Single condition. Operators such as `isSubmitted`, `isSkipped`, `isClicked`, `isAccepted`,\n`isBooked`, `isSet`, and `isEmpty` do not use `rightOperand`; comparison operators do.\n","required":["id","leftOperand","operator"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.16.showIf.conditions.items.[INDEX].oneOf.0.id","typeLabel":"string\u003ccuid2>"},"leftOperand":{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.16.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.16.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.16.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.16.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.16.showIf.conditions.items.[INDEX].oneOf.0.leftOperand","typeLabel":"object"},"operator":{"type":"string","enum":["equals","doesNotEqual","contains","doesNotContain","startsWith","doesNotStartWith","endsWith","doesNotEndWith","isSubmitted","isSkipped","isGreaterThan","isLessThan","isGreaterThanOrEqual","isLessThanOrEqual","equalsOneOf","includesAllOf","includesOneOf","doesNotIncludeOneOf","doesNotIncludeAllOf","isClicked","isNotClicked","isAccepted","isBefore","isAfter","isBooked","isPartiallySubmitted","isCompletelySubmitted","isSet","isNotSet","isEmpty","isNotEmpty","isAnyOf"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.16.showIf.conditions.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"rightOperand":{"oneOf":[{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.16.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.16.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.16.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.1","typeLabel":"number"},{"type":"array","items":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.16.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.16.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.16.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value","typeLabel":"string | number | string[]"},"columnId":{"type":"string","minLength":1,"description":"On a matrix row condition, the id of the column. Read before `value` and wins when the two disagree, so the condition survives reordering. Must be a column of the matrix. Optional: when only `value` is sent, the id is filled in from the position on write.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.16.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnId","typeLabel":"string"},"columnIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.16.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition with `isAnyOf`, the ids of the columns `value` lists. Read before `value`, like `columnId`.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.16.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.16.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0","typeLabel":"object"},{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.16.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.16.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.16.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.16.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.16.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1","typeLabel":"object"}],"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.16.showIf.conditions.items.[INDEX].oneOf.0.rightOperand","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.16.showIf.conditions.items.[INDEX].oneOf.0","typeLabel":"object"},{}],"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.16.showIf.conditions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.16.showIf.conditions","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.16.showIf","typeLabel":"object"},"code":{"type":"string","maxLength":30,"pattern":"^[a-z][a-z0-9_]*$","description":"Question code, the name the question carries in exports, webhooks and links. Optional. Starts with a lowercase letter, then lowercase letters, digits and `_`; no `__`, no trailing `_`, at most 30 characters. It must not be an SPSS reserved word (`all`, `and`, `by`, `eq`, `ge`, `gt`, `le`, `lt`, `ne`, `not`, `or`, `to`, `with`) or an export column name (`response_id`, `language`, `outcome`, ...), and must be unique among the survey's question codes, Embedded Data names and the Question IDs of other questions, ignoring case. CTA elements have no code.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.16.code","typeLabel":"string"},"lowerLabel":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.16.lowerLabel.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.16.lowerLabel","typeLabel":"object"},"upperLabel":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.16.upperLabel.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.16.upperLabel","typeLabel":"object"},"isColorCodingEnabled":{"type":"boolean","default":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.16.isColorCodingEnabled","typeLabel":"boolean"}},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.16","typeLabel":"object"},{"type":"object","description":"Survey element/question inside a block. Element ids are stable public identifiers used by\nlogic, recall strings, response data, quotas, integrations, and analysis. `type` selects the\nallowed shape; unsupported fields are rejected instead of ignored.\n","required":["id","type","headline","required"],"properties":{"id":{"type":"string","pattern":"^[a-zA-Z0-9_-]+$","description":"Stable element id. Avoid spaces and reserved ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.17.id","typeLabel":"string"},"type":{"type":"string","enum":["signature"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.17.type","typeLabel":"enum\u003cstring>"},"headline":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.17.headline.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.17.headline","typeLabel":"object"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.17.required","typeLabel":"boolean"},"subheader":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.17.subheader.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.17.subheader","typeLabel":"object"},"imageUrl":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.17.imageUrl","typeLabel":"string"},"imageAltText":{"type":"object","description":"Text alternative for `imageUrl`, read by screen readers. Omit or leave empty for a decorative image (rendered as `alt=\"\"`).","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.17.imageAltText.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.17.imageAltText","typeLabel":"object"},"videoUrl":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.17.videoUrl","typeLabel":"string"},"isDraft":{"type":"boolean","description":"Draft marker used by the editor and future update rules.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.17.isDraft","typeLabel":"boolean"},"showIf":{"type":"object","description":"Show-if: the element is shown only when this condition group matches, re-evaluated live as answers above it on the same page change. A hidden element is not validated (a hidden required element never blocks submission) and its answer is not submitted. Conditions use the same operands and operators as block `logic`. Reference rule: an element's show-if may use answers from earlier blocks and from elements above it in the same block, never itself or anything below it; a violation fails with `misordered_reference` at the exact condition path. Omit it, or send an empty group, for an element that is always shown.","required":["id","connector","conditions"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.17.showIf.id","typeLabel":"string\u003ccuid2>"},"connector":{"type":"string","enum":["and","or"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.17.showIf.connector","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","items":{"oneOf":[{"type":"object","description":"Single condition. Operators such as `isSubmitted`, `isSkipped`, `isClicked`, `isAccepted`,\n`isBooked`, `isSet`, and `isEmpty` do not use `rightOperand`; comparison operators do.\n","required":["id","leftOperand","operator"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.17.showIf.conditions.items.[INDEX].oneOf.0.id","typeLabel":"string\u003ccuid2>"},"leftOperand":{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.17.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.17.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.17.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.17.showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.17.showIf.conditions.items.[INDEX].oneOf.0.leftOperand","typeLabel":"object"},"operator":{"type":"string","enum":["equals","doesNotEqual","contains","doesNotContain","startsWith","doesNotStartWith","endsWith","doesNotEndWith","isSubmitted","isSkipped","isGreaterThan","isLessThan","isGreaterThanOrEqual","isLessThanOrEqual","equalsOneOf","includesAllOf","includesOneOf","doesNotIncludeOneOf","doesNotIncludeAllOf","isClicked","isNotClicked","isAccepted","isBefore","isAfter","isBooked","isPartiallySubmitted","isCompletelySubmitted","isSet","isNotSet","isEmpty","isNotEmpty","isAnyOf"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.17.showIf.conditions.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"rightOperand":{"oneOf":[{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.17.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.17.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.17.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.1","typeLabel":"number"},{"type":"array","items":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.17.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.17.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.17.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value","typeLabel":"string | number | string[]"},"columnId":{"type":"string","minLength":1,"description":"On a matrix row condition, the id of the column. Read before `value` and wins when the two disagree, so the condition survives reordering. Must be a column of the matrix. Optional: when only `value` is sent, the id is filled in from the position on write.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.17.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnId","typeLabel":"string"},"columnIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.17.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition with `isAnyOf`, the ids of the columns `value` lists. Read before `value`, like `columnId`.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.17.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.17.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0","typeLabel":"object"},{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.17.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.17.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.17.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.17.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.17.showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1","typeLabel":"object"}],"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.17.showIf.conditions.items.[INDEX].oneOf.0.rightOperand","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.17.showIf.conditions.items.[INDEX].oneOf.0","typeLabel":"object"},{}],"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.17.showIf.conditions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.17.showIf.conditions","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.17.showIf","typeLabel":"object"},"code":{"type":"string","maxLength":30,"pattern":"^[a-z][a-z0-9_]*$","description":"Question code, the name the question carries in exports, webhooks and links. Optional. Starts with a lowercase letter, then lowercase letters, digits and `_`; no `__`, no trailing `_`, at most 30 characters. It must not be an SPSS reserved word (`all`, `and`, `by`, `eq`, `ge`, `gt`, `le`, `lt`, `ne`, `not`, `or`, `to`, `with`) or an export column name (`response_id`, `language`, `outcome`, ...), and must be unique among the survey's question codes, Embedded Data names and the Question IDs of other questions, ignoring case. CTA elements have no code.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.17.code","typeLabel":"string"},"allowTypedSignature":{"type":"boolean","default":true,"description":"Whether the respondent may type their name instead of drawing. The signature is stored as a single PNG image either way.","uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.17.allowTypedSignature","typeLabel":"boolean"}},"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX].oneOf.17","typeLabel":"object"}],"uniqueKey":"data.blocks.items.[INDEX].elements.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].elements","typeLabel":"object[]"},"logic":{"type":"array","items":{"type":"object","description":"Conditional logic rule evaluated at block level.","required":["id","conditions","actions"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].logic.items.[INDEX].id","typeLabel":"string\u003ccuid2>"},"conditions":{"type":"object","required":["id","connector","conditions"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].logic.items.[INDEX].conditions.id","typeLabel":"string\u003ccuid2>"},"connector":{"type":"string","enum":["and","or"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].logic.items.[INDEX].conditions.connector","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","items":{"oneOf":[{"type":"object","description":"Single condition. Operators such as `isSubmitted`, `isSkipped`, `isClicked`, `isAccepted`,\n`isBooked`, `isSet`, and `isEmpty` do not use `rightOperand`; comparison operators do.\n","required":["id","leftOperand","operator"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].logic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.id","typeLabel":"string\u003ccuid2>"},"leftOperand":{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].logic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.leftOperand.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].logic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.leftOperand.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].logic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.leftOperand.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].logic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.leftOperand.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].logic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.leftOperand","typeLabel":"object"},"operator":{"type":"string","enum":["equals","doesNotEqual","contains","doesNotContain","startsWith","doesNotStartWith","endsWith","doesNotEndWith","isSubmitted","isSkipped","isGreaterThan","isLessThan","isGreaterThanOrEqual","isLessThanOrEqual","equalsOneOf","includesAllOf","includesOneOf","doesNotIncludeOneOf","doesNotIncludeAllOf","isClicked","isNotClicked","isAccepted","isBefore","isAfter","isBooked","isPartiallySubmitted","isCompletelySubmitted","isSet","isNotSet","isEmpty","isNotEmpty","isAnyOf"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].logic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"rightOperand":{"oneOf":[{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].logic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].logic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].logic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.1","typeLabel":"number"},{"type":"array","items":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].logic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].logic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].logic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value","typeLabel":"string | number | string[]"},"columnId":{"type":"string","minLength":1,"description":"On a matrix row condition, the id of the column. Read before `value` and wins when the two disagree, so the condition survives reordering. Must be a column of the matrix. Optional: when only `value` is sent, the id is filled in from the position on write.","uniqueKey":"data.blocks.items.[INDEX].logic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnId","typeLabel":"string"},"columnIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"data.blocks.items.[INDEX].logic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition with `isAnyOf`, the ids of the columns `value` lists. Read before `value`, like `columnId`.","uniqueKey":"data.blocks.items.[INDEX].logic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].logic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0","typeLabel":"object"},{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].logic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].logic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].logic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].logic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].logic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1","typeLabel":"object"}],"uniqueKey":"data.blocks.items.[INDEX].logic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.rightOperand","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].logic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0","typeLabel":"object"},{}],"uniqueKey":"data.blocks.items.[INDEX].logic.items.[INDEX].conditions.conditions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].logic.items.[INDEX].conditions.conditions","typeLabel":"object[]"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].logic.items.[INDEX].conditions","typeLabel":"object"},"actions":{"type":"array","items":{"oneOf":[{"type":"object","description":"Logic action. Keep referenced ids stable: `calculate.variableId` points to a variable id,\n`requireAnswer.target` points to an element id, and `jumpToBlock.target` points to a block id\nor ending id. `markLowQuality` takes no target: it marks the response Low quality when the rule fires.\n","required":["id","objective","variableId","operator","value"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].logic.items.[INDEX].actions.items.[INDEX].oneOf.0.id","typeLabel":"string\u003ccuid2>"},"objective":{"type":"string","enum":["calculate"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].logic.items.[INDEX].actions.items.[INDEX].oneOf.0.objective","typeLabel":"enum\u003cstring>"},"variableId":{"type":"string","format":"cuid2","description":"The computed field's `storageKey` (a legacy variable id).","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].logic.items.[INDEX].actions.items.[INDEX].oneOf.0.variableId","typeLabel":"string\u003ccuid2>"},"operator":{"type":"string","enum":["assign","concat","add","subtract","multiply","divide"],"description":"An `expression` value takes `assign` only.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].logic.items.[INDEX].actions.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.0.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.0.value.oneOf.1","typeLabel":"number"},{"type":"array","items":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.0.value.oneOf.2.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.0.value.oneOf.2","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.0.value","typeLabel":"string | number | string[]"},"columnId":{"type":"string","minLength":1,"description":"On a matrix row condition, the id of the column. Read before `value` and wins when the two disagree, so the condition survives reordering. Must be a column of the matrix. Optional: when only `value` is sent, the id is filled in from the position on write.","uniqueKey":"data.blocks.items.[INDEX].logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.0.columnId","typeLabel":"string"},"columnIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"data.blocks.items.[INDEX].logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.0.columnIds.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition with `isAnyOf`, the ids of the columns `value` lists. Read before `value`, like `columnId`.","uniqueKey":"data.blocks.items.[INDEX].logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.0.columnIds","typeLabel":"string[]"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.0","typeLabel":"object"},{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.1","typeLabel":"object"},{"type":"object","description":"The value of a Set value step: an expression tree, evaluated in the respondent's browser without `eval`. Validation refuses text in arithmetic, unknown functions, wrong argument counts, references that don't exist and a result type that doesn't match the target field, each at its exact path (`…value.value.args.1`). Trees are at most 12 levels deep and 200 nodes.\n","required":["type","value"],"example":{"type":"expression","value":{"type":"call","fn":"round","args":[{"type":"call","fn":"add","args":[{"type":"element","value":"q1"},{"type":"call","fn":"multiply","args":[{"type":"element","value":"q2"},{"type":"static","value":2}]}]}]}},"properties":{"type":{"type":"string","enum":["expression"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.2.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"object","description":"One node of a Set value expression: a fixed value, a reference, or a function call.\n\n**Leaves.** `static` is a number or text (a text `2026-03-01` counts as a date where one is expected). `element` is an answer, by element id: rating, NPS, CSAT, CES and number open text are numbers; other open text is text; a date question is a date; a single select yields its answer code as text. Other question types can't be used. `variable` is a computed field and `hiddenField` an ingested field, by storage key, typed by their `dataType`; `reserved` is a reserved field by name.\n\n**Functions** (`call`): `add`, `multiply`, `min`, `max` take 2–50 numbers; `subtract` and `divide` exactly 2 (÷ 0 gives empty); `round` a number and optional fixed decimals (0–10, rounding half away from zero); `abs` 1 number; `ifEmpty` a value and a fallback of the same type; `concat` 2–50 values of any type (numbers and dates become text); `now` none (the device clock as a UTC ISO timestamp); `daysBetween` 2 dates (UTC calendar days from the first to the second, negative allowed).\n\n**Empty values.** An unanswered question or unset field is empty, and so is a value that isn't a number where a number is needed; every function except `ifEmpty` then gives empty.\n","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.2.value.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.2.value.oneOf.0.value.oneOf.0","typeLabel":"number"},{"type":"string","maxLength":5000,"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.2.value.oneOf.0.value.oneOf.1","typeLabel":"string"}],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.2.value.oneOf.0.value","typeLabel":"number | string"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.2.value.oneOf.0","typeLabel":"object"},{"type":"object","description":"One node of a Set value expression: a fixed value, a reference, or a function call.\n\n**Leaves.** `static` is a number or text (a text `2026-03-01` counts as a date where one is expected). `element` is an answer, by element id: rating, NPS, CSAT, CES and number open text are numbers; other open text is text; a date question is a date; a single select yields its answer code as text. Other question types can't be used. `variable` is a computed field and `hiddenField` an ingested field, by storage key, typed by their `dataType`; `reserved` is a reserved field by name.\n\n**Functions** (`call`): `add`, `multiply`, `min`, `max` take 2–50 numbers; `subtract` and `divide` exactly 2 (÷ 0 gives empty); `round` a number and optional fixed decimals (0–10, rounding half away from zero); `abs` 1 number; `ifEmpty` a value and a fallback of the same type; `concat` 2–50 values of any type (numbers and dates become text); `now` none (the device clock as a UTC ISO timestamp); `daysBetween` 2 dates (UTC calendar days from the first to the second, negative allowed).\n\n**Empty values.** An unanswered question or unset field is empty, and so is a value that isn't a number where a number is needed; every function except `ifEmpty` then gives empty.\n","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.2.value.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.2.value.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.2.value.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.2.value.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.2.value.oneOf.1","typeLabel":"object"},{"type":"object","description":"One node of a Set value expression: a fixed value, a reference, or a function call.\n\n**Leaves.** `static` is a number or text (a text `2026-03-01` counts as a date where one is expected). `element` is an answer, by element id: rating, NPS, CSAT, CES and number open text are numbers; other open text is text; a date question is a date; a single select yields its answer code as text. Other question types can't be used. `variable` is a computed field and `hiddenField` an ingested field, by storage key, typed by their `dataType`; `reserved` is a reserved field by name.\n\n**Functions** (`call`): `add`, `multiply`, `min`, `max` take 2–50 numbers; `subtract` and `divide` exactly 2 (÷ 0 gives empty); `round` a number and optional fixed decimals (0–10, rounding half away from zero); `abs` 1 number; `ifEmpty` a value and a fallback of the same type; `concat` 2–50 values of any type (numbers and dates become text); `now` none (the device clock as a UTC ISO timestamp); `daysBetween` 2 dates (UTC calendar days from the first to the second, negative allowed).\n\n**Empty values.** An unanswered question or unset field is empty, and so is a value that isn't a number where a number is needed; every function except `ifEmpty` then gives empty.\n","required":["type","fn","args"],"properties":{"type":{"type":"string","enum":["call"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.2.value.oneOf.2.type","typeLabel":"enum\u003cstring>"},"fn":{"type":"string","enum":["add","subtract","multiply","divide","round","min","max","abs","ifEmpty","concat","now","daysBetween"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.2.value.oneOf.2.fn","typeLabel":"enum\u003cstring>"},"args":{"type":"array","maxItems":50,"items":{"$circularRef":"05361453-d19c-419d-9183-f17ee4b34306"},"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.2.value.oneOf.2.args","typeLabel":"array"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.2.value.oneOf.2","typeLabel":"object"}],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.2.value","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.2","typeLabel":"object"}],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].logic.items.[INDEX].actions.items.[INDEX].oneOf.0.value","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].logic.items.[INDEX].actions.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","description":"Logic action. Keep referenced ids stable: `calculate.variableId` points to a variable id,\n`requireAnswer.target` points to an element id, and `jumpToBlock.target` points to a block id\nor ending id. `markLowQuality` takes no target: it marks the response Low quality when the rule fires.\n","required":["id","objective","target"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].logic.items.[INDEX].actions.items.[INDEX].oneOf.1.id","typeLabel":"string\u003ccuid2>"},"objective":{"type":"string","enum":["requireAnswer"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].logic.items.[INDEX].actions.items.[INDEX].oneOf.1.objective","typeLabel":"enum\u003cstring>"},"target":{"type":"string","description":"Target element id.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].logic.items.[INDEX].actions.items.[INDEX].oneOf.1.target","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].logic.items.[INDEX].actions.items.[INDEX].oneOf.1","typeLabel":"object"},{"type":"object","description":"Logic action. Keep referenced ids stable: `calculate.variableId` points to a variable id,\n`requireAnswer.target` points to an element id, and `jumpToBlock.target` points to a block id\nor ending id. `markLowQuality` takes no target: it marks the response Low quality when the rule fires.\n","required":["id","objective","target"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].logic.items.[INDEX].actions.items.[INDEX].oneOf.2.id","typeLabel":"string\u003ccuid2>"},"objective":{"type":"string","enum":["jumpToBlock"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].logic.items.[INDEX].actions.items.[INDEX].oneOf.2.objective","typeLabel":"enum\u003cstring>"},"target":{"type":"string","format":"cuid2","description":"Target block id or ending id.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].logic.items.[INDEX].actions.items.[INDEX].oneOf.2.target","typeLabel":"string\u003ccuid2>"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].logic.items.[INDEX].actions.items.[INDEX].oneOf.2","typeLabel":"object"},{"type":"object","description":"Logic action. Keep referenced ids stable: `calculate.variableId` points to a variable id,\n`requireAnswer.target` points to an element id, and `jumpToBlock.target` points to a block id\nor ending id. `markLowQuality` takes no target: it marks the response Low quality when the rule fires.\n","required":["id","objective"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].logic.items.[INDEX].actions.items.[INDEX].oneOf.3.id","typeLabel":"string\u003ccuid2>"},"objective":{"type":"string","enum":["markLowQuality"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].logic.items.[INDEX].actions.items.[INDEX].oneOf.3.objective","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].logic.items.[INDEX].actions.items.[INDEX].oneOf.3","typeLabel":"object"}],"uniqueKey":"data.blocks.items.[INDEX].logic.items.[INDEX].actions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].logic.items.[INDEX].actions","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].logic.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.blocks.items.[INDEX].logic","typeLabel":"object[]"},"logicFallback":{"type":"string","format":"cuid2","description":"Block or ending id used when no logic condition matches. Only valid when this same block\nhas at least one `logic` rule; omit it for normal sequential flow.\n","uniqueKey":"data.blocks.items.[INDEX].logicFallback","typeLabel":"string\u003ccuid2>"},"showIf":{"type":"object","description":"Show-if: the block is shown only when this condition group matches. A block whose show-if fails is skipped, and its `logic` still runs as if the block were submitted with no answers. A block whose elements are all hidden by their show-if is skipped the same way. Conditions use the same operands and operators as `logic`. Reference rule: a block's show-if may use answers from earlier blocks only (plus hidden fields, variables and reserved fields); a violation fails with `misordered_reference` at the exact condition path. Omit it, or send an empty group, for a block that is always shown.","required":["id","connector","conditions"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].showIf.id","typeLabel":"string\u003ccuid2>"},"connector":{"type":"string","enum":["and","or"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].showIf.connector","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","items":{"oneOf":[{"type":"object","description":"Single condition. Operators such as `isSubmitted`, `isSkipped`, `isClicked`, `isAccepted`,\n`isBooked`, `isSet`, and `isEmpty` do not use `rightOperand`; comparison operators do.\n","required":["id","leftOperand","operator"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.id","typeLabel":"string\u003ccuid2>"},"leftOperand":{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.leftOperand","typeLabel":"object"},"operator":{"type":"string","enum":["equals","doesNotEqual","contains","doesNotContain","startsWith","doesNotStartWith","endsWith","doesNotEndWith","isSubmitted","isSkipped","isGreaterThan","isLessThan","isGreaterThanOrEqual","isLessThanOrEqual","equalsOneOf","includesAllOf","includesOneOf","doesNotIncludeOneOf","doesNotIncludeAllOf","isClicked","isNotClicked","isAccepted","isBefore","isAfter","isBooked","isPartiallySubmitted","isCompletelySubmitted","isSet","isNotSet","isEmpty","isNotEmpty","isAnyOf"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"rightOperand":{"oneOf":[{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.1","typeLabel":"number"},{"type":"array","items":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value","typeLabel":"string | number | string[]"},"columnId":{"type":"string","minLength":1,"description":"On a matrix row condition, the id of the column. Read before `value` and wins when the two disagree, so the condition survives reordering. Must be a column of the matrix. Optional: when only `value` is sent, the id is filled in from the position on write.","uniqueKey":"data.blocks.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnId","typeLabel":"string"},"columnIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"data.blocks.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition with `isAnyOf`, the ids of the columns `value` lists. Read before `value`, like `columnId`.","uniqueKey":"data.blocks.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0","typeLabel":"object"},{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1","typeLabel":"object"}],"uniqueKey":"data.blocks.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0.rightOperand","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].showIf.conditions.items.[INDEX].oneOf.0","typeLabel":"object"},{}],"uniqueKey":"data.blocks.items.[INDEX].showIf.conditions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.blocks.items.[INDEX].showIf.conditions","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX].showIf","typeLabel":"object"},"buttonLabel":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].buttonLabel.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].buttonLabel","typeLabel":"object"},"backButtonLabel":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.blocks.items.[INDEX].backButtonLabel.additionalProperties","typeLabel":"string"},"uniqueKey":"data.blocks.items.[INDEX].backButtonLabel","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.blocks.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.blocks","typeLabel":"object[]"},"endings":{"type":"array","items":{"oneOf":[{"type":"object","description":"Ending reached after the last block or a jump action. `type` selects the allowed shape;\nunsupported fields are rejected instead of ignored.\n","required":["id","type"],"properties":{"id":{"type":"string","format":"cuid2","description":"Stable ending id. `jumpToBlock.target` may point to this id.","isRequired":true,"uniqueKey":"data.endings.items.[INDEX].oneOf.0.id","typeLabel":"string\u003ccuid2>"},"type":{"type":"string","enum":["endScreen"],"isRequired":true,"uniqueKey":"data.endings.items.[INDEX].oneOf.0.type","typeLabel":"enum\u003cstring>"},"headline":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.endings.items.[INDEX].oneOf.0.headline.additionalProperties","typeLabel":"string"},"uniqueKey":"data.endings.items.[INDEX].oneOf.0.headline","typeLabel":"object"},"subheader":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.endings.items.[INDEX].oneOf.0.subheader.additionalProperties","typeLabel":"string"},"uniqueKey":"data.endings.items.[INDEX].oneOf.0.subheader","typeLabel":"object"},"buttonLabel":{"type":"object","description":"Survey authoring text. `GET /api/v3/surveys/{surveyId}` always returns maps keyed by the emitted\n`languages[].code` values for this survey. Use `?lang=` to filter which language keys are included.\nThe internal storage key `default` is never exposed by v3.\n","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.endings.items.[INDEX].oneOf.0.buttonLabel.additionalProperties","typeLabel":"string"},"uniqueKey":"data.endings.items.[INDEX].oneOf.0.buttonLabel","typeLabel":"object"},"buttonLink":{"type":"string","uniqueKey":"data.endings.items.[INDEX].oneOf.0.buttonLink","typeLabel":"string"},"imageUrl":{"type":"string","uniqueKey":"data.endings.items.[INDEX].oneOf.0.imageUrl","typeLabel":"string"},"imageAltText":{"type":"object","description":"Text alternative for `imageUrl`, read by screen readers. Omit or leave empty for a decorative image (rendered as `alt=\"\"`).","maxProperties":256,"example":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"additionalProperties":{"type":"string","uniqueKey":"data.endings.items.[INDEX].oneOf.0.imageAltText.additionalProperties","typeLabel":"string"},"uniqueKey":"data.endings.items.[INDEX].oneOf.0.imageAltText","typeLabel":"object"},"videoUrl":{"type":"string","uniqueKey":"data.endings.items.[INDEX].oneOf.0.videoUrl","typeLabel":"string"},"hideDefaultIcon":{"type":"boolean","description":"Hides the default checkmark icon rendered above the headline when the ending carries no image or video. Omit to keep the icon.","uniqueKey":"data.endings.items.[INDEX].oneOf.0.hideDefaultIcon","typeLabel":"boolean"}},"additionalProperties":false,"uniqueKey":"data.endings.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","description":"Ending reached after the last block or a jump action. `type` selects the allowed shape;\nunsupported fields are rejected instead of ignored.\n","required":["id","type","url"],"properties":{"id":{"type":"string","format":"cuid2","description":"Stable ending id. `jumpToBlock.target` may point to this id.","isRequired":true,"uniqueKey":"data.endings.items.[INDEX].oneOf.1.id","typeLabel":"string\u003ccuid2>"},"type":{"type":"string","enum":["redirectToUrl"],"isRequired":true,"uniqueKey":"data.endings.items.[INDEX].oneOf.1.type","typeLabel":"enum\u003cstring>"},"url":{"type":"string","format":"uri","description":"External redirect URL. Requires the organization's external URL permission.","isRequired":true,"uniqueKey":"data.endings.items.[INDEX].oneOf.1.url","typeLabel":"string\u003curi>"},"label":{"type":"string","description":"Optional internal label for redirect endings.","uniqueKey":"data.endings.items.[INDEX].oneOf.1.label","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"data.endings.items.[INDEX].oneOf.1","typeLabel":"object"}],"uniqueKey":"data.endings.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.endings","typeLabel":"object[]"},"hiddenFields":{"type":"object","description":"Hidden fields, sometimes called embedded data in other survey products. Field ids are stable public identifiers and may be referenced by logic, recall, quotas, integrations, and response data.\n\n**Naming rule for new field ids** — the same rule the survey editor applies (ENG-2539): a new id must start with a lowercase letter and then contain only lowercase letters, numbers and underscores (`^[a-z][a-z0-9_]*$`), and must not take a reserved name. Reserved are the link-survey system params and internal ids — `userId`, `source`, `suid`, `end`, `start`, `welcomeCard`, `hidden`, `verifiedEmail`, `multiLanguage`, `embed`, `verify`, `suToken`, `lang`, `preview`, `startAt`, `skipPrefilled`, `offlineSupport` (matched case-insensitively) — and the names of auto-captured system fields, which every survey can already read without declaring them: `source`, `url`, `country`, `action`, `browser`, `os`, `deviceType`, `ipAddress`, `finished`, `language`, `locale`, `responseId`, `surveyId`, `durationSeconds`, `startedAt`, `finishedAt`, `pagePath`, `pageReferrer`, `utmSource`, `utmMedium`, `utmCampaign`, `utmTerm`, `utmContent`, `screenWidth`, `screenHeight`, `viewportWidth`, `viewportHeight`, `timezone`, `visitPagesViewed`, `visitUniquePagesViewed`, `visitTimeOnSite`, `visitEntryReferrer`, `visitUrls`, `openedByCreativeId`, `openedByCreativeName`.\n\n**Ids a survey already declares are grandfathered**: they always load, and re-sending the survey unchanged never fails validation — only *adding* such a name as a new field is refused. Deleting a grandfathered field spends the reprieve: once it is gone from the saved survey, the name can no longer be re-added. Note this means re-creating a survey from an exported document can fail with a 400 when the export declares a name the rule refuses; rename the field in the payload before importing. The `pattern` below describes what stored surveys may hold (the pre-existing lenient charset), not what a new id may look like.\n","required":["enabled"],"properties":{"enabled":{"type":"boolean","description":"Derived, not stored: `true` whenever the survey declares at least one hidden field. A value sent on create or update is ignored; to turn hidden fields off, remove them from `fieldIds`.\n","isRequired":true,"uniqueKey":"data.hiddenFields.enabled","typeLabel":"boolean"},"fieldIds":{"type":"array","maxItems":200,"items":{"type":"string","pattern":"^[a-zA-Z0-9_-]+$","uniqueKey":"data.hiddenFields.fieldIds.items.[INDEX]","typeLabel":"string"},"uniqueItems":true,"uniqueKey":"data.hiddenFields.fieldIds","typeLabel":"string[]"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.hiddenFields","typeLabel":"object"},"variables":{"type":"array","items":{"oneOf":[{"type":"object","description":"Survey variable. Variable ids are stable references used by logic and calculation actions.\nVariable names are human-readable labels and must be unique within the survey.\n","required":["id","name","type","value"],"properties":{"id":{"type":"string","format":"cuid2","description":"Stable variable id referenced from logic.","isRequired":true,"uniqueKey":"data.variables.items.[INDEX].oneOf.0.id","typeLabel":"string\u003ccuid2>"},"name":{"type":"string","pattern":"^[a-z0-9_]+$","description":"Unique variable name. `pattern` is the charset of a *stored* name; a newly declared one is held to more than that, and the extra rules split into two groups that behave differently.\n\n**400 `forbidden_identifier`, grandfathered.** A new name must match `^[a-z][a-z0-9_]*$` (no leading digit or underscore) and must not take a reserved name — the link-survey system params and internal ids (`userId`, `source`, `suid`, `end`, `start`, `welcomeCard`, `hidden`, `verifiedEmail`, `multiLanguage`, `embed`, `verify`, `suToken`, `lang`, `preview`, `startAt`, `skipPrefilled`, `offlineSupport`) or an auto-captured system field name (`country`, `browser`, `deviceType`, …; `SurveyHiddenFields` carries the full list, and the two sets are the same there). Names the survey already declares are grandfathered against these, so re-sending an existing document never trips them.\n\n**400 `duplicate_identifier`, not grandfathered.** A variable name that collides case-insensitively with a hidden field id on the same survey. This is checked by reference validation over the whole merged document rather than against the incoming names, so a survey that already holds such a clash is refused on **every** patch — including one that touches neither collection — until one side is renamed.\n","isRequired":true,"uniqueKey":"data.variables.items.[INDEX].oneOf.0.name","typeLabel":"string"},"type":{"type":"string","enum":["number"],"isRequired":true,"uniqueKey":"data.variables.items.[INDEX].oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"type":"number","description":"Default numeric value.","isRequired":true,"uniqueKey":"data.variables.items.[INDEX].oneOf.0.value","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"data.variables.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","description":"Survey variable. Variable ids are stable references used by logic and calculation actions.\nVariable names are human-readable labels and must be unique within the survey.\n","required":["id","name","type","value"],"properties":{"id":{"type":"string","format":"cuid2","description":"Stable variable id referenced from logic.","isRequired":true,"uniqueKey":"data.variables.items.[INDEX].oneOf.1.id","typeLabel":"string\u003ccuid2>"},"name":{"type":"string","pattern":"^[a-z0-9_]+$","description":"Unique variable name. `pattern` is the charset of a *stored* name; a newly declared one is held to more than that, and the extra rules split into two groups that behave differently.\n\n**400 `forbidden_identifier`, grandfathered.** A new name must match `^[a-z][a-z0-9_]*$` (no leading digit or underscore) and must not take a reserved name — the link-survey system params and internal ids (`userId`, `source`, `suid`, `end`, `start`, `welcomeCard`, `hidden`, `verifiedEmail`, `multiLanguage`, `embed`, `verify`, `suToken`, `lang`, `preview`, `startAt`, `skipPrefilled`, `offlineSupport`) or an auto-captured system field name (`country`, `browser`, `deviceType`, …; `SurveyHiddenFields` carries the full list, and the two sets are the same there). Names the survey already declares are grandfathered against these, so re-sending an existing document never trips them.\n\n**400 `duplicate_identifier`, not grandfathered.** A variable name that collides case-insensitively with a hidden field id on the same survey. This is checked by reference validation over the whole merged document rather than against the incoming names, so a survey that already holds such a clash is refused on **every** patch — including one that touches neither collection — until one side is renamed.\n","isRequired":true,"uniqueKey":"data.variables.items.[INDEX].oneOf.1.name","typeLabel":"string"},"type":{"type":"string","enum":["text"],"isRequired":true,"uniqueKey":"data.variables.items.[INDEX].oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Default text value.","isRequired":true,"uniqueKey":"data.variables.items.[INDEX].oneOf.1.value","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"data.variables.items.[INDEX].oneOf.1","typeLabel":"object"}],"uniqueKey":"data.variables.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.variables","typeLabel":"object[]"},"startLogic":{"type":"array","maxItems":100,"description":"Rules before the first question. The survey runs them as soon as it loads, before the welcome card, and also when a start-at link skips ahead. Each rule has the block-rule shape (`id`, `conditions`, `actions`), but only three actions are allowed: `jumpToBlock`, to a block or to an ending (an ending is a screen-out: the respondent sees only that ending, and a finished response is stored that counts as Completed), `calculate`, to set a computed field, and `markLowQuality`, which marks the response Low quality with its first write (a screen-out's finished response included). `requireAnswer` and any other action are rejected with a 422 naming `startLogic.\u003crule>.actions.\u003caction>`. Nothing has been answered yet, so conditions and values may read `hiddenField` (URL parameters), `variable` and `reserved` operands only; an `element` operand is rejected with a 422 naming `startLogic.\u003crule>.conditions` (or the action's `value`). A jump to a block or ending that does not exist is a `dangling_reference`. The first jump wins, every `calculate` runs, and with no jump the respondent continues to the first block (or the start-at target). `[]` means the survey has none.","items":{"type":"object","description":"Conditional logic rule evaluated at block level.","required":["id","conditions","actions"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"data.startLogic.items.[INDEX].id","typeLabel":"string\u003ccuid2>"},"conditions":{"type":"object","required":["id","connector","conditions"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"data.startLogic.items.[INDEX].conditions.id","typeLabel":"string\u003ccuid2>"},"connector":{"type":"string","enum":["and","or"],"isRequired":true,"uniqueKey":"data.startLogic.items.[INDEX].conditions.connector","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","items":{"oneOf":[{"type":"object","description":"Single condition. Operators such as `isSubmitted`, `isSkipped`, `isClicked`, `isAccepted`,\n`isBooked`, `isSet`, and `isEmpty` do not use `rightOperand`; comparison operators do.\n","required":["id","leftOperand","operator"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"data.startLogic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.id","typeLabel":"string\u003ccuid2>"},"leftOperand":{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"data.startLogic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.leftOperand.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"data.startLogic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.leftOperand.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"data.startLogic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.leftOperand.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"data.startLogic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.leftOperand.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.startLogic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.leftOperand","typeLabel":"object"},"operator":{"type":"string","enum":["equals","doesNotEqual","contains","doesNotContain","startsWith","doesNotStartWith","endsWith","doesNotEndWith","isSubmitted","isSkipped","isGreaterThan","isLessThan","isGreaterThanOrEqual","isLessThanOrEqual","equalsOneOf","includesAllOf","includesOneOf","doesNotIncludeOneOf","doesNotIncludeAllOf","isClicked","isNotClicked","isAccepted","isBefore","isAfter","isBooked","isPartiallySubmitted","isCompletelySubmitted","isSet","isNotSet","isEmpty","isNotEmpty","isAnyOf"],"isRequired":true,"uniqueKey":"data.startLogic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"rightOperand":{"oneOf":[{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"data.startLogic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.startLogic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.startLogic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.1","typeLabel":"number"},{"type":"array","items":{"type":"string","uniqueKey":"data.startLogic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.startLogic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value.oneOf.2","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"data.startLogic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.value","typeLabel":"string | number | string[]"},"columnId":{"type":"string","minLength":1,"description":"On a matrix row condition, the id of the column. Read before `value` and wins when the two disagree, so the condition survives reordering. Must be a column of the matrix. Optional: when only `value` is sent, the id is filled in from the position on write.","uniqueKey":"data.startLogic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnId","typeLabel":"string"},"columnIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"data.startLogic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition with `isAnyOf`, the ids of the columns `value` lists. Read before `value`, like `columnId`.","uniqueKey":"data.startLogic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0.columnIds","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"data.startLogic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.0","typeLabel":"object"},{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"data.startLogic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"data.startLogic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"data.startLogic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"data.startLogic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.startLogic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.rightOperand.oneOf.1","typeLabel":"object"}],"uniqueKey":"data.startLogic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0.rightOperand","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.startLogic.items.[INDEX].conditions.conditions.items.[INDEX].oneOf.0","typeLabel":"object"},{}],"uniqueKey":"data.startLogic.items.[INDEX].conditions.conditions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.startLogic.items.[INDEX].conditions.conditions","typeLabel":"object[]"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.startLogic.items.[INDEX].conditions","typeLabel":"object"},"actions":{"type":"array","items":{"oneOf":[{"type":"object","description":"Logic action. Keep referenced ids stable: `calculate.variableId` points to a variable id,\n`requireAnswer.target` points to an element id, and `jumpToBlock.target` points to a block id\nor ending id. `markLowQuality` takes no target: it marks the response Low quality when the rule fires.\n","required":["id","objective","variableId","operator","value"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"data.startLogic.items.[INDEX].actions.items.[INDEX].oneOf.0.id","typeLabel":"string\u003ccuid2>"},"objective":{"type":"string","enum":["calculate"],"isRequired":true,"uniqueKey":"data.startLogic.items.[INDEX].actions.items.[INDEX].oneOf.0.objective","typeLabel":"enum\u003cstring>"},"variableId":{"type":"string","format":"cuid2","description":"The computed field's `storageKey` (a legacy variable id).","isRequired":true,"uniqueKey":"data.startLogic.items.[INDEX].actions.items.[INDEX].oneOf.0.variableId","typeLabel":"string\u003ccuid2>"},"operator":{"type":"string","enum":["assign","concat","add","subtract","multiply","divide"],"description":"An `expression` value takes `assign` only.","isRequired":true,"uniqueKey":"data.startLogic.items.[INDEX].actions.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"data.startLogic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.startLogic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.0.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.startLogic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.0.value.oneOf.1","typeLabel":"number"},{"type":"array","items":{"type":"string","uniqueKey":"data.startLogic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.0.value.oneOf.2.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition, the 0-based position of the column (a list of positions for `isAnyOf`). Kept next to `columnId` / `columnIds` for the previous release, which reads positions only; every write rewrites it from the ids.","isRequired":true,"uniqueKey":"data.startLogic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.0.value.oneOf.2","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"data.startLogic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.0.value","typeLabel":"string | number | string[]"},"columnId":{"type":"string","minLength":1,"description":"On a matrix row condition, the id of the column. Read before `value` and wins when the two disagree, so the condition survives reordering. Must be a column of the matrix. Optional: when only `value` is sent, the id is filled in from the position on write.","uniqueKey":"data.startLogic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.0.columnId","typeLabel":"string"},"columnIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"data.startLogic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.0.columnIds.items.[INDEX]","typeLabel":"string"},"description":"On a matrix row condition with `isAnyOf`, the ids of the columns `value` lists. Read before `value`, like `columnId`.","uniqueKey":"data.startLogic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.0.columnIds","typeLabel":"string[]"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.startLogic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.0","typeLabel":"object"},{"type":"object","description":"Dynamic reference to another value in the survey document.","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"data.startLogic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"data.startLogic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"data.startLogic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"data.startLogic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.startLogic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.1","typeLabel":"object"},{"type":"object","description":"The value of a Set value step: an expression tree, evaluated in the respondent's browser without `eval`. Validation refuses text in arithmetic, unknown functions, wrong argument counts, references that don't exist and a result type that doesn't match the target field, each at its exact path (`…value.value.args.1`). Trees are at most 12 levels deep and 200 nodes.\n","required":["type","value"],"example":{"type":"expression","value":{"type":"call","fn":"round","args":[{"type":"call","fn":"add","args":[{"type":"element","value":"q1"},{"type":"call","fn":"multiply","args":[{"type":"element","value":"q2"},{"type":"static","value":2}]}]}]}},"properties":{"type":{"type":"string","enum":["expression"],"isRequired":true,"uniqueKey":"data.startLogic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.2.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"object","description":"One node of a Set value expression: a fixed value, a reference, or a function call.\n\n**Leaves.** `static` is a number or text (a text `2026-03-01` counts as a date where one is expected). `element` is an answer, by element id: rating, NPS, CSAT, CES and number open text are numbers; other open text is text; a date question is a date; a single select yields its answer code as text. Other question types can't be used. `variable` is a computed field and `hiddenField` an ingested field, by storage key, typed by their `dataType`; `reserved` is a reserved field by name.\n\n**Functions** (`call`): `add`, `multiply`, `min`, `max` take 2–50 numbers; `subtract` and `divide` exactly 2 (÷ 0 gives empty); `round` a number and optional fixed decimals (0–10, rounding half away from zero); `abs` 1 number; `ifEmpty` a value and a fallback of the same type; `concat` 2–50 values of any type (numbers and dates become text); `now` none (the device clock as a UTC ISO timestamp); `daysBetween` 2 dates (UTC calendar days from the first to the second, negative allowed).\n\n**Empty values.** An unanswered question or unset field is empty, and so is a value that isn't a number where a number is needed; every function except `ifEmpty` then gives empty.\n","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"data.startLogic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.2.value.oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"data.startLogic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.2.value.oneOf.0.value.oneOf.0","typeLabel":"number"},{"type":"string","maxLength":5000,"isRequired":true,"uniqueKey":"data.startLogic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.2.value.oneOf.0.value.oneOf.1","typeLabel":"string"}],"isRequired":true,"uniqueKey":"data.startLogic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.2.value.oneOf.0.value","typeLabel":"number | string"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.startLogic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.2.value.oneOf.0","typeLabel":"object"},{"type":"object","description":"One node of a Set value expression: a fixed value, a reference, or a function call.\n\n**Leaves.** `static` is a number or text (a text `2026-03-01` counts as a date where one is expected). `element` is an answer, by element id: rating, NPS, CSAT, CES and number open text are numbers; other open text is text; a date question is a date; a single select yields its answer code as text. Other question types can't be used. `variable` is a computed field and `hiddenField` an ingested field, by storage key, typed by their `dataType`; `reserved` is a reserved field by name.\n\n**Functions** (`call`): `add`, `multiply`, `min`, `max` take 2–50 numbers; `subtract` and `divide` exactly 2 (÷ 0 gives empty); `round` a number and optional fixed decimals (0–10, rounding half away from zero); `abs` 1 number; `ifEmpty` a value and a fallback of the same type; `concat` 2–50 values of any type (numbers and dates become text); `now` none (the device clock as a UTC ISO timestamp); `daysBetween` 2 dates (UTC calendar days from the first to the second, negative allowed).\n\n**Empty values.** An unanswered question or unset field is empty, and so is a value that isn't a number where a number is needed; every function except `ifEmpty` then gives empty.\n","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true,"uniqueKey":"data.startLogic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.2.value.oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true,"uniqueKey":"data.startLogic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.2.value.oneOf.1.value","typeLabel":"string"},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string","uniqueKey":"data.startLogic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.2.value.oneOf.1.meta.additionalProperties","typeLabel":"string"},"uniqueKey":"data.startLogic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.2.value.oneOf.1.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.startLogic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.2.value.oneOf.1","typeLabel":"object"},{"type":"object","description":"One node of a Set value expression: a fixed value, a reference, or a function call.\n\n**Leaves.** `static` is a number or text (a text `2026-03-01` counts as a date where one is expected). `element` is an answer, by element id: rating, NPS, CSAT, CES and number open text are numbers; other open text is text; a date question is a date; a single select yields its answer code as text. Other question types can't be used. `variable` is a computed field and `hiddenField` an ingested field, by storage key, typed by their `dataType`; `reserved` is a reserved field by name.\n\n**Functions** (`call`): `add`, `multiply`, `min`, `max` take 2–50 numbers; `subtract` and `divide` exactly 2 (÷ 0 gives empty); `round` a number and optional fixed decimals (0–10, rounding half away from zero); `abs` 1 number; `ifEmpty` a value and a fallback of the same type; `concat` 2–50 values of any type (numbers and dates become text); `now` none (the device clock as a UTC ISO timestamp); `daysBetween` 2 dates (UTC calendar days from the first to the second, negative allowed).\n\n**Empty values.** An unanswered question or unset field is empty, and so is a value that isn't a number where a number is needed; every function except `ifEmpty` then gives empty.\n","required":["type","fn","args"],"properties":{"type":{"type":"string","enum":["call"],"isRequired":true,"uniqueKey":"data.startLogic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.2.value.oneOf.2.type","typeLabel":"enum\u003cstring>"},"fn":{"type":"string","enum":["add","subtract","multiply","divide","round","min","max","abs","ifEmpty","concat","now","daysBetween"],"isRequired":true,"uniqueKey":"data.startLogic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.2.value.oneOf.2.fn","typeLabel":"enum\u003cstring>"},"args":{"type":"array","maxItems":50,"items":{"$circularRef":"05361453-d19c-419d-9183-f17ee4b34306"},"isRequired":true,"uniqueKey":"data.startLogic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.2.value.oneOf.2.args","typeLabel":"array"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.startLogic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.2.value.oneOf.2","typeLabel":"object"}],"isRequired":true,"uniqueKey":"data.startLogic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.2.value","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.startLogic.items.[INDEX].actions.items.[INDEX].oneOf.0.value.oneOf.2","typeLabel":"object"}],"isRequired":true,"uniqueKey":"data.startLogic.items.[INDEX].actions.items.[INDEX].oneOf.0.value","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.startLogic.items.[INDEX].actions.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","description":"Logic action. Keep referenced ids stable: `calculate.variableId` points to a variable id,\n`requireAnswer.target` points to an element id, and `jumpToBlock.target` points to a block id\nor ending id. `markLowQuality` takes no target: it marks the response Low quality when the rule fires.\n","required":["id","objective","target"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"data.startLogic.items.[INDEX].actions.items.[INDEX].oneOf.1.id","typeLabel":"string\u003ccuid2>"},"objective":{"type":"string","enum":["requireAnswer"],"isRequired":true,"uniqueKey":"data.startLogic.items.[INDEX].actions.items.[INDEX].oneOf.1.objective","typeLabel":"enum\u003cstring>"},"target":{"type":"string","description":"Target element id.","isRequired":true,"uniqueKey":"data.startLogic.items.[INDEX].actions.items.[INDEX].oneOf.1.target","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"data.startLogic.items.[INDEX].actions.items.[INDEX].oneOf.1","typeLabel":"object"},{"type":"object","description":"Logic action. Keep referenced ids stable: `calculate.variableId` points to a variable id,\n`requireAnswer.target` points to an element id, and `jumpToBlock.target` points to a block id\nor ending id. `markLowQuality` takes no target: it marks the response Low quality when the rule fires.\n","required":["id","objective","target"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"data.startLogic.items.[INDEX].actions.items.[INDEX].oneOf.2.id","typeLabel":"string\u003ccuid2>"},"objective":{"type":"string","enum":["jumpToBlock"],"isRequired":true,"uniqueKey":"data.startLogic.items.[INDEX].actions.items.[INDEX].oneOf.2.objective","typeLabel":"enum\u003cstring>"},"target":{"type":"string","format":"cuid2","description":"Target block id or ending id.","isRequired":true,"uniqueKey":"data.startLogic.items.[INDEX].actions.items.[INDEX].oneOf.2.target","typeLabel":"string\u003ccuid2>"}},"additionalProperties":false,"uniqueKey":"data.startLogic.items.[INDEX].actions.items.[INDEX].oneOf.2","typeLabel":"object"},{"type":"object","description":"Logic action. Keep referenced ids stable: `calculate.variableId` points to a variable id,\n`requireAnswer.target` points to an element id, and `jumpToBlock.target` points to a block id\nor ending id. `markLowQuality` takes no target: it marks the response Low quality when the rule fires.\n","required":["id","objective"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"data.startLogic.items.[INDEX].actions.items.[INDEX].oneOf.3.id","typeLabel":"string\u003ccuid2>"},"objective":{"type":"string","enum":["markLowQuality"],"isRequired":true,"uniqueKey":"data.startLogic.items.[INDEX].actions.items.[INDEX].oneOf.3.objective","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"data.startLogic.items.[INDEX].actions.items.[INDEX].oneOf.3","typeLabel":"object"}],"uniqueKey":"data.startLogic.items.[INDEX].actions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.startLogic.items.[INDEX].actions","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"data.startLogic.items.[INDEX]","typeLabel":"object"},"example":[{"id":"clrule12345678901234567890","conditions":{"id":"clgrp123456789012345678901","connector":"and","conditions":[{"id":"clcond12345678901234567890","leftOperand":{"type":"hiddenField","value":"panel_id"},"operator":"isNotSet"}]},"actions":[{"id":"clact123456789012345678901","objective":"jumpToBlock","target":"clend123456789012345678901"}]}],"isRequired":true,"uniqueKey":"data.startLogic","typeLabel":"object[]"},"embeddedFields":{"type":"array","description":"Typed Embedded Data (ADR 0028): the survey's complete set of fields, which `variables` and `hiddenFields` are derived from. Library fields carry their `key`.","items":{"type":"object","description":"One typed Embedded Data field the survey has. `embeddedFields` is the survey's complete set; the legacy `variables` (its computed fields) and `hiddenFields` (its ingested fields) are derived from it. Logic operands keep naming fields by storage key: a `variable` operand and a calculate action's `variableId` name a computed field's `storageKey`, a `hiddenField` operand an ingested field's.\n","required":["storageKey","key","name","source","dataType","defaultValue","locked"],"properties":{"storageKey":{"type":"string","pattern":"^[a-zA-Z0-9_-]+$","description":"The survey's address for the field: where responses store its value, and what logic names. A computed field's is a cuid2 (its legacy variable id); an ingested field's is the URL parameter or SDK key it arrives under (its legacy hidden field id).","examples":["plan_tier"],"isRequired":true,"uniqueKey":"data.embeddedFields.items.[INDEX].storageKey","typeLabel":"string"},"key":{"oneOf":[{"type":"string","description":"The workspace library key when the field is a linked library field, whose definition the workspace owns; `null` for a field local to this survey.","examples":["plan_tier"],"isRequired":true,"uniqueKey":"data.embeddedFields.items.[INDEX].key.oneOf.0","typeLabel":"string"},{"type":"null","description":"The workspace library key when the field is a linked library field, whose definition the workspace owns; `null` for a field local to this survey.","examples":["plan_tier"],"isRequired":true,"uniqueKey":"data.embeddedFields.items.[INDEX].key.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.embeddedFields.items.[INDEX].key","typeLabel":"string | null"},"name":{"type":"string","minLength":1,"description":"Display name.","examples":["Plan tier"],"isRequired":true,"uniqueKey":"data.embeddedFields.items.[INDEX].name","typeLabel":"string"},"source":{"type":"string","enum":["computed","ingested"],"description":"`computed`: set inside the survey by logic. `ingested`: arrives from outside, by URL parameter or SDK.","isRequired":true,"uniqueKey":"data.embeddedFields.items.[INDEX].source","typeLabel":"enum\u003cstring>"},"dataType":{"type":"string","enum":["string","number","boolean","date"],"description":"The type the value is read and coerced as. A computed field is `string`, `number` or `date`.","isRequired":true,"uniqueKey":"data.embeddedFields.items.[INDEX].dataType","typeLabel":"enum\u003cstring>"},"defaultValue":{"oneOf":[{"type":"string","description":"A computed field's initial value; an ingested field's value when nothing arrives. Matches `dataType`; a `date` default is an ISO 8601 date or date-time string.","isRequired":true,"uniqueKey":"data.embeddedFields.items.[INDEX].defaultValue.oneOf.0","typeLabel":"string"},{"type":"number","description":"A computed field's initial value; an ingested field's value when nothing arrives. Matches `dataType`; a `date` default is an ISO 8601 date or date-time string.","isRequired":true,"uniqueKey":"data.embeddedFields.items.[INDEX].defaultValue.oneOf.1","typeLabel":"number"},{"type":"boolean","description":"A computed field's initial value; an ingested field's value when nothing arrives. Matches `dataType`; a `date` default is an ISO 8601 date or date-time string.","isRequired":true,"uniqueKey":"data.embeddedFields.items.[INDEX].defaultValue.oneOf.2","typeLabel":"boolean"},{"type":"null","description":"A computed field's initial value; an ingested field's value when nothing arrives. Matches `dataType`; a `date` default is an ISO 8601 date or date-time string.","isRequired":true,"uniqueKey":"data.embeddedFields.items.[INDEX].defaultValue.oneOf.3","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.embeddedFields.items.[INDEX].defaultValue","typeLabel":"string | number | boolean | null"},"locked":{"type":"boolean","description":"Ingested fields only. A locked field refuses values from outside the survey.","isRequired":true,"uniqueKey":"data.embeddedFields.items.[INDEX].locked","typeLabel":"boolean"}},"additionalProperties":false,"uniqueKey":"data.embeddedFields.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.embeddedFields","typeLabel":"object[]"},"customCss":{"oneOf":[{"type":"object","description":"The survey's custom CSS **source** (ENG-3641), `null` when it has none. Compiled output and the processor version are internal and never exposed here. The full resource may be sent back with PATCH: unchanged source is not reprocessed and needs no plan.","required":["light","dark"],"properties":{"light":{"oneOf":[{"type":"string","description":"Base CSS, applied in light and dark appearance.","isRequired":true,"uniqueKey":"data.customCss.oneOf.0.light.oneOf.0","typeLabel":"string"},{"type":"null","description":"Base CSS, applied in light and dark appearance.","isRequired":true,"uniqueKey":"data.customCss.oneOf.0.light.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.customCss.oneOf.0.light","typeLabel":"string | null"},"dark":{"oneOf":[{"type":"string","description":"Additional CSS applied only in dark appearance.","isRequired":true,"uniqueKey":"data.customCss.oneOf.0.dark.oneOf.0","typeLabel":"string"},{"type":"null","description":"Additional CSS applied only in dark appearance.","isRequired":true,"uniqueKey":"data.customCss.oneOf.0.dark.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.customCss.oneOf.0.dark","typeLabel":"string | null"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.customCss.oneOf.0","typeLabel":"object"},{"type":"null","description":"The survey's custom CSS **source** (ENG-3641), `null` when it has none. Compiled output and the processor version are internal and never exposed here. The full resource may be sent back with PATCH: unchanged source is not reprocessed and needs no plan.","isRequired":true,"uniqueKey":"data.customCss.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.customCss","typeLabel":"object | null"},"visibility":{"type":"string","description":"The **enforced** visibility on this request. `restricted` whenever a change is pending, in either direction (fail closed). `workspace` for every survey while the deployment's readiness marker is unset, whatever the stored flag, and always `workspace` for API keys.","enum":["restricted","workspace"],"isRequired":true,"uniqueKey":"data.visibility","typeLabel":"enum\u003cstring>"},"owner":{"oneOf":[{"type":"object","description":"`null` when the author's account no longer exists (`Survey.ownerId` is set null on user deletion) or the survey was created with an API key. A survey with `owner: null` cannot be restricted; an organisation owner/manager can still make it workspace-visible.","required":["name"],"properties":{"name":{"type":"string","isRequired":true,"uniqueKey":"data.owner.oneOf.0.name","typeLabel":"string"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.owner.oneOf.0","typeLabel":"object"},{"type":"null","description":"`null` when the author's account no longer exists (`Survey.ownerId` is set null on user deletion) or the survey was created with an API key. A survey with `owner: null` cannot be restricted; an organisation owner/manager can still make it workspace-visible.","isRequired":true,"uniqueKey":"data.owner.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.owner","typeLabel":"object | null"},"access":{"type":"object","description":"Why **this caller** can see the survey, and whether they may change its visibility. Derived by the server per request; a rendering hint only — every mutation is re-authorised on the server.","required":["via","canManageVisibility"],"properties":{"via":{"type":"string","description":"Why this caller can see the survey. Known values today: `workspace` (the survey is workspace-visible and the caller has workspace read — always the value for API keys), `owner` (restricted, the caller owns it), `organizationRole` (restricted, the caller reaches it only as an organisation owner or manager — the case that shows the admin banner). **Open set, deliberately not an enum**: named person and team sharing will add values, so clients treat an unknown string as \"some other access path\" and never branch exhaustively. Explanatory metadata, not authorization truth — the server re-authorises every call.","examples":["workspace","owner","organizationRole"],"isRequired":true,"uniqueKey":"data.access.via","typeLabel":"string"},"canManageVisibility":{"type":"boolean","description":"Permission only: `true` when this caller holds `survey.change_visibility` — owner or organisation owner/manager, feature enabled for the organisation and deployment. It can be `true` while `allowedTargets` is empty (blockers, or no owner): it answers \"may this person manage visibility at all\", which is what shows or hides the controls; `allowedTargets` on `GET …/visibility` answers which transitions would succeed now. Stays `true` for an organisation manager on an ownerless restricted survey.","isRequired":true,"uniqueKey":"data.access.canManageVisibility","typeLabel":"boolean"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.access","typeLabel":"object"},"distribution":{"type":"object","description":"App-survey runtime/display settings. Present only for app surveys; omitted for link surveys.","example":{"displayOption":"displaySome","displayLimit":3,"displayPercentage":null,"recontactDays":7,"autoClose":null,"keepEndingCardOpen":false,"autoComplete":null,"delay":0,"showConditions":{"id":"grp1","connector":"and","conditions":[{"id":"cnd1","leftOperand":{"type":"page","value":"currentUrl"},"operator":"pathIsAnyOf","rightOperand":{"type":"static","value":["/plan-compare","/drug-coverage"]}},{"id":"cnd2","leftOperand":{"type":"visit","value":"pagesViewed"},"operator":"isGreaterThanOrEqual","rightOperand":{"type":"static","value":3}}]},"triggers":[{"actionClassId":"clyy1234567890123456789012"}]},"properties":{"displayOption":{"type":"string","enum":["displayOnce","displayMultiple","respondMultiple","displaySome"],"default":"displayOnce","description":"How often the survey may be shown to a contact. `displaySome` shows it up to `displayLimit` times (or until the contact responds, whichever comes first).\n","uniqueKey":"data.distribution.displayOption","typeLabel":"enum\u003cstring>"},"displayPercentage":{"oneOf":[{"type":"number","minimum":0.01,"maximum":100,"default":null,"description":"Independent throttle: show the survey to only this percentage of triggered contacts. Optional and valid with any `displayOption`; null/omitted means no throttle (shown to everyone).\n","uniqueKey":"data.distribution.displayPercentage.oneOf.0","typeLabel":"number"},{"type":"null","minimum":0.01,"maximum":100,"default":null,"description":"Independent throttle: show the survey to only this percentage of triggered contacts. Optional and valid with any `displayOption`; null/omitted means no throttle (shown to everyone).\n","uniqueKey":"data.distribution.displayPercentage.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.distribution.displayPercentage","typeLabel":"number | null"},"displayLimit":{"oneOf":[{"type":"integer","minimum":0,"default":null,"description":"Maximum number of times the survey is shown to a single contact. Required (must be >= 1) when `displayOption` is `displaySome`; otherwise optional.\n","uniqueKey":"data.distribution.displayLimit.oneOf.0","typeLabel":"integer"},{"type":"null","minimum":0,"default":null,"description":"Maximum number of times the survey is shown to a single contact. Required (must be >= 1) when `displayOption` is `displaySome`; otherwise optional.\n","uniqueKey":"data.distribution.displayLimit.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.distribution.displayLimit","typeLabel":"integer | null"},"recontactDays":{"oneOf":[{"type":"integer","minimum":0,"default":null,"description":"Days to wait before showing this survey again to the same contact. Null uses the workspace default.","uniqueKey":"data.distribution.recontactDays.oneOf.0","typeLabel":"integer"},{"type":"null","minimum":0,"default":null,"description":"Days to wait before showing this survey again to the same contact. Null uses the workspace default.","uniqueKey":"data.distribution.recontactDays.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.distribution.recontactDays","typeLabel":"integer | null"},"autoClose":{"oneOf":[{"type":"integer","minimum":0,"default":null,"description":"Seconds of inactivity after which the survey widget auto-closes. Null disables auto-close.","uniqueKey":"data.distribution.autoClose.oneOf.0","typeLabel":"integer"},{"type":"null","minimum":0,"default":null,"description":"Seconds of inactivity after which the survey widget auto-closes. Null disables auto-close.","uniqueKey":"data.distribution.autoClose.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.distribution.autoClose","typeLabel":"integer | null"},"keepEndingCardOpen":{"type":"boolean","default":false,"description":"Keep the ending card on screen until the respondent closes the survey. When false, the survey widget closes 3 seconds after the ending card appears. Has no effect on a survey with no ending card (it closes immediately) or whose first ending redirects to a URL. Independent of `autoClose`.\n","uniqueKey":"data.distribution.keepEndingCardOpen","typeLabel":"boolean"},"autoComplete":{"oneOf":[{"type":"integer","minimum":1,"default":null,"description":"Automatically stop collecting responses after this many completed responses. Null disables it.","uniqueKey":"data.distribution.autoComplete.oneOf.0","typeLabel":"integer"},{"type":"null","minimum":1,"default":null,"description":"Automatically stop collecting responses after this many completed responses. Null disables it.","uniqueKey":"data.distribution.autoComplete.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.distribution.autoComplete","typeLabel":"integer | null"},"delay":{"type":"integer","minimum":0,"default":0,"description":"Seconds to wait after a trigger fires before showing the survey.","uniqueKey":"data.distribution.delay","typeLabel":"integer"},"showConditions":{"oneOf":[{"type":"object","description":"Conditions on the page, the visit and the device, checked in the visitor's browser when a trigger fires and again when `delay` ends. The survey shows only if they hold. `null` (or an empty group) means no conditions. Available on every plan. At most 20 conditions, one nested group, 200 entries per list and 10 KB in total. Mobile SDKs ignore them.\n","required":["id","connector","conditions"],"properties":{"id":{"type":"string","description":"Client-generated id (cuid2), unique within the survey's conditions.","isRequired":true,"uniqueKey":"data.distribution.showConditions.oneOf.0.id","typeLabel":"string"},"connector":{"type":"string","enum":["and","or"],"isRequired":true,"uniqueKey":"data.distribution.showConditions.oneOf.0.connector","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","items":{"oneOf":[{"type":"object","description":"One check, read like a sentence: what to look at (`leftOperand`), how to compare (`operator`) and what to compare with (`rightOperand`). Text comparisons ignore upper and lower case.\n\n| `leftOperand.type` | `leftOperand.value` | Operators |\n| --- | --- | --- |\n| `page` | `currentUrl` (full URL, query included) | `pathIsAnyOf`, `pathIsNoneOf`, `containsAnyOf`, `containsNoneOf`, `equals`, `doesNotEqual`, `contains`, `doesNotContain`, `startsWith`, `endsWith` |\n| `page` | `pageReferrer`, `entryReferrer` (first page of the visit) | `equals`, `doesNotEqual`, `contains`, `doesNotContain`, `startsWith`, `endsWith`, `containsAnyOf`, `containsNoneOf` |\n| `page` | `queryParam` (name in `meta.key`) | `equals`, `doesNotEqual`, `contains`, `doesNotContain`, `startsWith`, `endsWith`, `isSet`, `isNotSet` |\n| `visit` | `pagesViewed`, `uniquePagesViewed`, `timeOnSite` (seconds) | `equals`, `isGreaterThan`, `isLessThan`, `isGreaterThanOrEqual`, `isLessThanOrEqual` |\n| `visit` | `visitedUrls` (pages seen in this visit, the current one included) | `includes`, `doesNotInclude` |\n| `device` | `deviceType` (`phone`, `tablet`, `desktop`), `browser` (`chrome`, `safari`, `firefox`, `edge`, `opera`, `samsung`, `other`) | `equals`, `doesNotEqual` |\n| `device` | `screenWidth` (browser window width, CSS px) | `equals`, `isGreaterThan`, `isLessThan`, `isGreaterThanOrEqual`, `isLessThanOrEqual` |\n\n`pathIsAnyOf` / `pathIsNoneOf` take a list of page paths, each compared exactly with the URL's path: case, a trailing slash, the query string and the `#hash` are ignored, and a full URL is reduced to its path. `/plans` matches `/plans?ref=email` but not `/plans/compare`. `containsAnyOf` / `containsNoneOf` take a list of fragments; a line passes when the URL contains it anywhere, so `/plans` also matches `/plans/compare`. `visitedUrls` takes one page path, compared exactly like a `pathIsAnyOf` line. `uniquePagesViewed` takes at most 200, the number of different pages a visit remembers. `isSet` / `isNotSet` take no `rightOperand`. A visit is one browser tab; if the browser blocks storage, visit conditions fail.\n","required":["id","leftOperand","operator"],"properties":{"id":{"type":"string","description":"Client-generated id (cuid2), unique within the survey's conditions.","isRequired":true,"uniqueKey":"data.distribution.showConditions.oneOf.0.conditions.items.[INDEX].oneOf.0.id","typeLabel":"string"},"leftOperand":{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["page","visit","device"],"isRequired":true,"uniqueKey":"data.distribution.showConditions.oneOf.0.conditions.items.[INDEX].oneOf.0.leftOperand.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","enum":["currentUrl","pageReferrer","entryReferrer","queryParam","pagesViewed","uniquePagesViewed","timeOnSite","visitedUrls","deviceType","browser","screenWidth"],"isRequired":true,"uniqueKey":"data.distribution.showConditions.oneOf.0.conditions.items.[INDEX].oneOf.0.leftOperand.value","typeLabel":"enum\u003cstring>"},"meta":{"type":"object","properties":{"key":{"type":"string","description":"The query parameter's name. Required for `queryParam`; matched ignoring case.","uniqueKey":"data.distribution.showConditions.oneOf.0.conditions.items.[INDEX].oneOf.0.leftOperand.meta.key","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"data.distribution.showConditions.oneOf.0.conditions.items.[INDEX].oneOf.0.leftOperand.meta","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.distribution.showConditions.oneOf.0.conditions.items.[INDEX].oneOf.0.leftOperand","typeLabel":"object"},"operator":{"type":"string","enum":["equals","doesNotEqual","contains","doesNotContain","startsWith","endsWith","containsAnyOf","containsNoneOf","pathIsAnyOf","pathIsNoneOf","isGreaterThan","isLessThan","isGreaterThanOrEqual","isLessThanOrEqual","includes","doesNotInclude","isSet","isNotSet"],"isRequired":true,"uniqueKey":"data.distribution.showConditions.oneOf.0.conditions.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"rightOperand":{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true,"uniqueKey":"data.distribution.showConditions.oneOf.0.conditions.items.[INDEX].oneOf.0.rightOperand.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","minLength":1,"isRequired":true,"uniqueKey":"data.distribution.showConditions.oneOf.0.conditions.items.[INDEX].oneOf.0.rightOperand.value.oneOf.0","typeLabel":"string"},{"type":"number","minimum":0,"isRequired":true,"uniqueKey":"data.distribution.showConditions.oneOf.0.conditions.items.[INDEX].oneOf.0.rightOperand.value.oneOf.1","typeLabel":"number"},{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"data.distribution.showConditions.oneOf.0.conditions.items.[INDEX].oneOf.0.rightOperand.value.oneOf.2.items.[INDEX]","typeLabel":"string"},"maxItems":200,"minItems":1,"isRequired":true,"uniqueKey":"data.distribution.showConditions.oneOf.0.conditions.items.[INDEX].oneOf.0.rightOperand.value.oneOf.2","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"data.distribution.showConditions.oneOf.0.conditions.items.[INDEX].oneOf.0.rightOperand.value","typeLabel":"string | number | string[]"}},"additionalProperties":false,"uniqueKey":"data.distribution.showConditions.oneOf.0.conditions.items.[INDEX].oneOf.0.rightOperand","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.distribution.showConditions.oneOf.0.conditions.items.[INDEX].oneOf.0","typeLabel":"object"},{}],"uniqueKey":"data.distribution.showConditions.oneOf.0.conditions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.distribution.showConditions.oneOf.0.conditions","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"data.distribution.showConditions.oneOf.0","typeLabel":"object"},{"type":"null","description":"Conditions on the page, the visit and the device, checked in the visitor's browser when a trigger fires and again when `delay` ends. The survey shows only if they hold. `null` (or an empty group) means no conditions. Available on every plan. At most 20 conditions, one nested group, 200 entries per list and 10 KB in total. Mobile SDKs ignore them.\n","uniqueKey":"data.distribution.showConditions.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.distribution.showConditions","typeLabel":"object | null"},"triggers":{"type":"array","default":[],"maxItems":50,"items":{"type":"object","description":"Reference to an existing workspace action class that triggers this app survey. Discover available action-class ids with `GET /api/v3/action-classes`.\n","required":["actionClassId"],"properties":{"actionClassId":{"type":"string","format":"cuid2","description":"Id of an action class in the same workspace.","isRequired":true,"uniqueKey":"data.distribution.triggers.items.[INDEX].actionClassId","typeLabel":"string\u003ccuid2>"}},"additionalProperties":false,"uniqueKey":"data.distribution.triggers.items.[INDEX]","typeLabel":"object"},"description":"Action classes that trigger the survey. Every id must reference an existing workspace action class. On PATCH this list fully replaces the survey's triggers — omitting it (or sending `[]`) removes all existing triggers.\n","uniqueKey":"data.distribution.triggers","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"data.distribution","typeLabel":"object"},"targeting":{"type":"object","description":"App-survey contact targeting. Present only for app surveys; omitted for link surveys.","required":["filters"],"properties":{"filters":{"type":"array","description":"Contact targeting filter tree. An empty array targets everyone. Each node joins the previous one via its `connector` (`and`/`or`; the first node's connector is null). A node's `resource` is either a single filter condition or a nested filter group (enabling parenthesized `and`/`or` logic).\n","items":{"type":"object","required":["id","connector","resource"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"data.targeting.filters.items.[INDEX].id","typeLabel":"string\u003ccuid2>"},"connector":{"oneOf":[{"type":"string","enum":["and","or",null],"description":"Logical connector joining this node to the previous one. Null for the first node.","isRequired":true,"uniqueKey":"data.targeting.filters.items.[INDEX].connector.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["and","or",null],"description":"Logical connector joining this node to the previous one. Null for the first node.","isRequired":true,"uniqueKey":"data.targeting.filters.items.[INDEX].connector.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.targeting.filters.items.[INDEX].connector","typeLabel":"enum\u003cstring> | null"},"resource":{"oneOf":[{"type":"object","title":"AttributeFilter","description":"A single filter condition, or a nested filter group for grouped logic.","required":["id","root","qualifier","value"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"data.targeting.filters.items.[INDEX].resource.oneOf.0.id","typeLabel":"string\u003ccuid2>"},"root":{"type":"object","required":["type","contactAttributeKey"],"properties":{"type":{"type":"string","enum":["attribute"],"isRequired":true,"uniqueKey":"data.targeting.filters.items.[INDEX].resource.oneOf.0.root.type","typeLabel":"enum\u003cstring>"},"contactAttributeKey":{"type":"string","description":"A contact-attribute key defined in the workspace (e.g. `plan`, `role`).","isRequired":true,"uniqueKey":"data.targeting.filters.items.[INDEX].resource.oneOf.0.root.contactAttributeKey","typeLabel":"string"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.targeting.filters.items.[INDEX].resource.oneOf.0.root","typeLabel":"object"},"qualifier":{"type":"object","required":["operator"],"properties":{"operator":{"type":"string","enum":["lessThan","lessEqual","greaterThan","greaterEqual","equals","notEquals","isSet","isNotSet","contains","doesNotContain","startsWith","endsWith","isOlderThan","isNewerThan","isBefore","isAfter","isBetween","isSameDay"],"isRequired":true,"uniqueKey":"data.targeting.filters.items.[INDEX].resource.oneOf.0.qualifier.operator","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.targeting.filters.items.[INDEX].resource.oneOf.0.qualifier","typeLabel":"object"},"value":{"oneOf":[{"type":"string","description":"Comparison value for a segment filter condition. A string or number for most operators; a relative-date object (`{ amount, unit }`) for `isOlderThan` / `isNewerThan`; a two-element `[from, to]` string array for `isBetween`. Ignored for `isSet` / `isNotSet` but still required.\n","isRequired":true,"uniqueKey":"data.targeting.filters.items.[INDEX].resource.oneOf.0.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"Comparison value for a segment filter condition. A string or number for most operators; a relative-date object (`{ amount, unit }`) for `isOlderThan` / `isNewerThan`; a two-element `[from, to]` string array for `isBetween`. Ignored for `isSet` / `isNotSet` but still required.\n","isRequired":true,"uniqueKey":"data.targeting.filters.items.[INDEX].resource.oneOf.0.value.oneOf.1","typeLabel":"number"},{"type":"object","description":"Comparison value for a segment filter condition. A string or number for most operators; a relative-date object (`{ amount, unit }`) for `isOlderThan` / `isNewerThan`; a two-element `[from, to]` string array for `isBetween`. Ignored for `isSet` / `isNotSet` but still required.\n","required":["amount","unit"],"properties":{"amount":{"type":"number","isRequired":true,"uniqueKey":"data.targeting.filters.items.[INDEX].resource.oneOf.0.value.oneOf.2.amount","typeLabel":"number"},"unit":{"type":"string","enum":["days","weeks","months","years"],"isRequired":true,"uniqueKey":"data.targeting.filters.items.[INDEX].resource.oneOf.0.value.oneOf.2.unit","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.targeting.filters.items.[INDEX].resource.oneOf.0.value.oneOf.2","typeLabel":"object"},{"type":"array","items":{"type":"string","uniqueKey":"data.targeting.filters.items.[INDEX].resource.oneOf.0.value.oneOf.3.items.[INDEX]","typeLabel":"string"},"description":"Comparison value for a segment filter condition. A string or number for most operators; a relative-date object (`{ amount, unit }`) for `isOlderThan` / `isNewerThan`; a two-element `[from, to]` string array for `isBetween`. Ignored for `isSet` / `isNotSet` but still required.\n","maxItems":2,"minItems":2,"isRequired":true,"uniqueKey":"data.targeting.filters.items.[INDEX].resource.oneOf.0.value.oneOf.3","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"data.targeting.filters.items.[INDEX].resource.oneOf.0.value","typeLabel":"string | number | object | string[]"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.targeting.filters.items.[INDEX].resource.oneOf.0","typeLabel":"AttributeFilter · object"},{"type":"object","title":"PersonFilter","description":"A single filter condition, or a nested filter group for grouped logic.","required":["id","root","qualifier","value"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"data.targeting.filters.items.[INDEX].resource.oneOf.1.id","typeLabel":"string\u003ccuid2>"},"root":{"type":"object","required":["type","personIdentifier"],"properties":{"type":{"type":"string","enum":["person"],"isRequired":true,"uniqueKey":"data.targeting.filters.items.[INDEX].resource.oneOf.1.root.type","typeLabel":"enum\u003cstring>"},"personIdentifier":{"type":"string","description":"A built-in person identifier (e.g. `userId`).","isRequired":true,"uniqueKey":"data.targeting.filters.items.[INDEX].resource.oneOf.1.root.personIdentifier","typeLabel":"string"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.targeting.filters.items.[INDEX].resource.oneOf.1.root","typeLabel":"object"},"qualifier":{"type":"object","required":["operator"],"properties":{"operator":{"type":"string","enum":["equals","notEquals","isSet","isNotSet","contains","doesNotContain","startsWith","endsWith"],"isRequired":true,"uniqueKey":"data.targeting.filters.items.[INDEX].resource.oneOf.1.qualifier.operator","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.targeting.filters.items.[INDEX].resource.oneOf.1.qualifier","typeLabel":"object"},"value":{"oneOf":[{"type":"string","description":"Comparison value for a segment filter condition. A string or number for most operators; a relative-date object (`{ amount, unit }`) for `isOlderThan` / `isNewerThan`; a two-element `[from, to]` string array for `isBetween`. Ignored for `isSet` / `isNotSet` but still required.\n","isRequired":true,"uniqueKey":"data.targeting.filters.items.[INDEX].resource.oneOf.1.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"Comparison value for a segment filter condition. A string or number for most operators; a relative-date object (`{ amount, unit }`) for `isOlderThan` / `isNewerThan`; a two-element `[from, to]` string array for `isBetween`. Ignored for `isSet` / `isNotSet` but still required.\n","isRequired":true,"uniqueKey":"data.targeting.filters.items.[INDEX].resource.oneOf.1.value.oneOf.1","typeLabel":"number"},{"type":"object","description":"Comparison value for a segment filter condition. A string or number for most operators; a relative-date object (`{ amount, unit }`) for `isOlderThan` / `isNewerThan`; a two-element `[from, to]` string array for `isBetween`. Ignored for `isSet` / `isNotSet` but still required.\n","required":["amount","unit"],"properties":{"amount":{"type":"number","isRequired":true,"uniqueKey":"data.targeting.filters.items.[INDEX].resource.oneOf.1.value.oneOf.2.amount","typeLabel":"number"},"unit":{"type":"string","enum":["days","weeks","months","years"],"isRequired":true,"uniqueKey":"data.targeting.filters.items.[INDEX].resource.oneOf.1.value.oneOf.2.unit","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.targeting.filters.items.[INDEX].resource.oneOf.1.value.oneOf.2","typeLabel":"object"},{"type":"array","items":{"type":"string","uniqueKey":"data.targeting.filters.items.[INDEX].resource.oneOf.1.value.oneOf.3.items.[INDEX]","typeLabel":"string"},"description":"Comparison value for a segment filter condition. A string or number for most operators; a relative-date object (`{ amount, unit }`) for `isOlderThan` / `isNewerThan`; a two-element `[from, to]` string array for `isBetween`. Ignored for `isSet` / `isNotSet` but still required.\n","maxItems":2,"minItems":2,"isRequired":true,"uniqueKey":"data.targeting.filters.items.[INDEX].resource.oneOf.1.value.oneOf.3","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"data.targeting.filters.items.[INDEX].resource.oneOf.1.value","typeLabel":"string | number | object | string[]"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.targeting.filters.items.[INDEX].resource.oneOf.1","typeLabel":"PersonFilter · object"},{"type":"object","title":"SegmentFilter","description":"A single filter condition, or a nested filter group for grouped logic.","required":["id","root","qualifier","value"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"data.targeting.filters.items.[INDEX].resource.oneOf.2.id","typeLabel":"string\u003ccuid2>"},"root":{"type":"object","required":["type","segmentId"],"properties":{"type":{"type":"string","enum":["segment"],"isRequired":true,"uniqueKey":"data.targeting.filters.items.[INDEX].resource.oneOf.2.root.type","typeLabel":"enum\u003cstring>"},"segmentId":{"type":"string","description":"Id of the segment to test membership against.","isRequired":true,"uniqueKey":"data.targeting.filters.items.[INDEX].resource.oneOf.2.root.segmentId","typeLabel":"string"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.targeting.filters.items.[INDEX].resource.oneOf.2.root","typeLabel":"object"},"qualifier":{"type":"object","required":["operator"],"properties":{"operator":{"type":"string","enum":["userIsIn","userIsNotIn"],"isRequired":true,"uniqueKey":"data.targeting.filters.items.[INDEX].resource.oneOf.2.qualifier.operator","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.targeting.filters.items.[INDEX].resource.oneOf.2.qualifier","typeLabel":"object"},"value":{"oneOf":[{"type":"string","description":"Comparison value for a segment filter condition. A string or number for most operators; a relative-date object (`{ amount, unit }`) for `isOlderThan` / `isNewerThan`; a two-element `[from, to]` string array for `isBetween`. Ignored for `isSet` / `isNotSet` but still required.\n","isRequired":true,"uniqueKey":"data.targeting.filters.items.[INDEX].resource.oneOf.2.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"Comparison value for a segment filter condition. A string or number for most operators; a relative-date object (`{ amount, unit }`) for `isOlderThan` / `isNewerThan`; a two-element `[from, to]` string array for `isBetween`. Ignored for `isSet` / `isNotSet` but still required.\n","isRequired":true,"uniqueKey":"data.targeting.filters.items.[INDEX].resource.oneOf.2.value.oneOf.1","typeLabel":"number"},{"type":"object","description":"Comparison value for a segment filter condition. A string or number for most operators; a relative-date object (`{ amount, unit }`) for `isOlderThan` / `isNewerThan`; a two-element `[from, to]` string array for `isBetween`. Ignored for `isSet` / `isNotSet` but still required.\n","required":["amount","unit"],"properties":{"amount":{"type":"number","isRequired":true,"uniqueKey":"data.targeting.filters.items.[INDEX].resource.oneOf.2.value.oneOf.2.amount","typeLabel":"number"},"unit":{"type":"string","enum":["days","weeks","months","years"],"isRequired":true,"uniqueKey":"data.targeting.filters.items.[INDEX].resource.oneOf.2.value.oneOf.2.unit","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.targeting.filters.items.[INDEX].resource.oneOf.2.value.oneOf.2","typeLabel":"object"},{"type":"array","items":{"type":"string","uniqueKey":"data.targeting.filters.items.[INDEX].resource.oneOf.2.value.oneOf.3.items.[INDEX]","typeLabel":"string"},"description":"Comparison value for a segment filter condition. A string or number for most operators; a relative-date object (`{ amount, unit }`) for `isOlderThan` / `isNewerThan`; a two-element `[from, to]` string array for `isBetween`. Ignored for `isSet` / `isNotSet` but still required.\n","maxItems":2,"minItems":2,"isRequired":true,"uniqueKey":"data.targeting.filters.items.[INDEX].resource.oneOf.2.value.oneOf.3","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"data.targeting.filters.items.[INDEX].resource.oneOf.2.value","typeLabel":"string | number | object | string[]"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.targeting.filters.items.[INDEX].resource.oneOf.2","typeLabel":"SegmentFilter · object"},{"type":"object","title":"DeviceFilter","description":"A single filter condition, or a nested filter group for grouped logic.","required":["id","root","qualifier","value"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"data.targeting.filters.items.[INDEX].resource.oneOf.3.id","typeLabel":"string\u003ccuid2>"},"root":{"type":"object","required":["type","deviceType"],"properties":{"type":{"type":"string","enum":["device"],"isRequired":true,"uniqueKey":"data.targeting.filters.items.[INDEX].resource.oneOf.3.root.type","typeLabel":"enum\u003cstring>"},"deviceType":{"type":"string","description":"Device type (e.g. `desktop`, `phone`).","isRequired":true,"uniqueKey":"data.targeting.filters.items.[INDEX].resource.oneOf.3.root.deviceType","typeLabel":"string"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.targeting.filters.items.[INDEX].resource.oneOf.3.root","typeLabel":"object"},"qualifier":{"type":"object","required":["operator"],"properties":{"operator":{"type":"string","enum":["equals","notEquals"],"isRequired":true,"uniqueKey":"data.targeting.filters.items.[INDEX].resource.oneOf.3.qualifier.operator","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.targeting.filters.items.[INDEX].resource.oneOf.3.qualifier","typeLabel":"object"},"value":{"oneOf":[{"type":"string","description":"Comparison value for a segment filter condition. A string or number for most operators; a relative-date object (`{ amount, unit }`) for `isOlderThan` / `isNewerThan`; a two-element `[from, to]` string array for `isBetween`. Ignored for `isSet` / `isNotSet` but still required.\n","isRequired":true,"uniqueKey":"data.targeting.filters.items.[INDEX].resource.oneOf.3.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"Comparison value for a segment filter condition. A string or number for most operators; a relative-date object (`{ amount, unit }`) for `isOlderThan` / `isNewerThan`; a two-element `[from, to]` string array for `isBetween`. Ignored for `isSet` / `isNotSet` but still required.\n","isRequired":true,"uniqueKey":"data.targeting.filters.items.[INDEX].resource.oneOf.3.value.oneOf.1","typeLabel":"number"},{"type":"object","description":"Comparison value for a segment filter condition. A string or number for most operators; a relative-date object (`{ amount, unit }`) for `isOlderThan` / `isNewerThan`; a two-element `[from, to]` string array for `isBetween`. Ignored for `isSet` / `isNotSet` but still required.\n","required":["amount","unit"],"properties":{"amount":{"type":"number","isRequired":true,"uniqueKey":"data.targeting.filters.items.[INDEX].resource.oneOf.3.value.oneOf.2.amount","typeLabel":"number"},"unit":{"type":"string","enum":["days","weeks","months","years"],"isRequired":true,"uniqueKey":"data.targeting.filters.items.[INDEX].resource.oneOf.3.value.oneOf.2.unit","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.targeting.filters.items.[INDEX].resource.oneOf.3.value.oneOf.2","typeLabel":"object"},{"type":"array","items":{"type":"string","uniqueKey":"data.targeting.filters.items.[INDEX].resource.oneOf.3.value.oneOf.3.items.[INDEX]","typeLabel":"string"},"description":"Comparison value for a segment filter condition. A string or number for most operators; a relative-date object (`{ amount, unit }`) for `isOlderThan` / `isNewerThan`; a two-element `[from, to]` string array for `isBetween`. Ignored for `isSet` / `isNotSet` but still required.\n","maxItems":2,"minItems":2,"isRequired":true,"uniqueKey":"data.targeting.filters.items.[INDEX].resource.oneOf.3.value.oneOf.3","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"data.targeting.filters.items.[INDEX].resource.oneOf.3.value","typeLabel":"string | number | object | string[]"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.targeting.filters.items.[INDEX].resource.oneOf.3","typeLabel":"DeviceFilter · object"},{"type":"object","title":"SurveyInteractionFilter","description":"A single filter condition, or a nested filter group for grouped logic.","required":["id","root","qualifier","value"],"properties":{"id":{"type":"string","format":"cuid2","isRequired":true,"uniqueKey":"data.targeting.filters.items.[INDEX].resource.oneOf.4.id","typeLabel":"string\u003ccuid2>"},"root":{"type":"object","required":["type"],"properties":{"type":{"type":"string","enum":["surveyInteraction"],"isRequired":true,"uniqueKey":"data.targeting.filters.items.[INDEX].resource.oneOf.4.root.type","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.targeting.filters.items.[INDEX].resource.oneOf.4.root","typeLabel":"object"},"qualifier":{"type":"object","required":["operator"],"properties":{"operator":{"type":"string","enum":["haveCompleted","haveNotCompleted","haveSeen","haveNotSeen","haveStartedRespondingTo"],"isRequired":true,"uniqueKey":"data.targeting.filters.items.[INDEX].resource.oneOf.4.qualifier.operator","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.targeting.filters.items.[INDEX].resource.oneOf.4.qualifier","typeLabel":"object"},"value":{"type":"object","required":["surveyScope","surveyIds","within"],"properties":{"surveyScope":{"type":"string","enum":["any","specific"],"description":"`any` matches every survey in the workspace; `specific` only `surveyIds`.","isRequired":true,"uniqueKey":"data.targeting.filters.items.[INDEX].resource.oneOf.4.value.surveyScope","typeLabel":"enum\u003cstring>"},"surveyIds":{"type":"array","maxItems":100,"items":{"type":"string","format":"cuid2","uniqueKey":"data.targeting.filters.items.[INDEX].resource.oneOf.4.value.surveyIds.items.[INDEX]","typeLabel":"string\u003ccuid2>"},"isRequired":true,"uniqueKey":"data.targeting.filters.items.[INDEX].resource.oneOf.4.value.surveyIds","typeLabel":"string\u003ccuid2>[]"},"within":{"type":"object","required":["amount","unit"],"properties":{"amount":{"type":"integer","minimum":1,"maximum":999,"isRequired":true,"uniqueKey":"data.targeting.filters.items.[INDEX].resource.oneOf.4.value.within.amount","typeLabel":"integer"},"unit":{"type":"string","enum":["days","weeks","months"],"isRequired":true,"uniqueKey":"data.targeting.filters.items.[INDEX].resource.oneOf.4.value.within.unit","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.targeting.filters.items.[INDEX].resource.oneOf.4.value.within","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.targeting.filters.items.[INDEX].resource.oneOf.4.value","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.targeting.filters.items.[INDEX].resource.oneOf.4","typeLabel":"SurveyInteractionFilter · object"},{"description":"A single filter condition, or a nested filter group for grouped logic.","isRequired":true,"uniqueKey":"data.targeting.filters.items.[INDEX].resource.oneOf.5","typeLabel":"any"}],"isRequired":true,"uniqueKey":"data.targeting.filters.items.[INDEX].resource","typeLabel":"AttributeFilter · object | PersonFilter · object | SegmentFilter · object | DeviceFilter · object | SurveyInteractionFilter · object | any"}},"additionalProperties":false,"uniqueKey":"data.targeting.filters.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.targeting.filters","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"data.targeting","typeLabel":"object"}},"isRequired":true,"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"data":{"id":"\u003cstring>","workspaceId":"\u003cstring>","createdAt":"2023-11-07T05:31:56Z","updatedAt":"2023-11-07T05:31:56Z","archivedAt":"2023-11-07T05:31:56Z","name":"\u003cstring>","type":"link","status":"draft","metadata":{"title":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"description":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"}},"defaultLanguage":"\u003cstring>","languages":[{"code":"en-US","default":true,"enabled":true,"alias":"english"}],"showLanguageSwitch":true,"autoSelectLanguage":true,"welcomeCard":{"enabled":true,"headline":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"subheader":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"buttonLabel":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"fileUrl":"\u003cstring>","videoUrl":"\u003cstring>","timeToFinish":true,"showResponseCount":true},"blocks":[{"id":"\u003cstring>","name":"\u003cstring>","elements":[{"id":"\u003cstring>","type":"openText","headline":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"required":true,"subheader":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"imageUrl":"\u003cstring>","imageAltText":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"videoUrl":"\u003cstring>","isDraft":true,"showIf":{"id":"\u003cstring>","connector":"and","conditions":[{"id":"\u003cstring>","leftOperand":{"type":"element","value":"\u003cstring>","meta":{}},"operator":"equals","rightOperand":{"type":"static","value":"\u003cstring>","columnId":"\u003cstring>","columnIds":["\u003cstring>"]}}]},"code":"\u003cstring>","placeholder":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"longAnswer":true,"inputType":"text","insightsEnabled":false,"charLimit":{"enabled":false,"min":123,"max":123},"validation":{"rules":[{"id":"\u003cstring>","type":"minLength","params":{},"field":"addressLine1"}],"logic":"and"}}],"logic":[{"id":"\u003cstring>","conditions":{"id":"\u003cstring>","connector":"and","conditions":[{"id":"\u003cstring>","leftOperand":{"type":"element","value":"\u003cstring>","meta":{}},"operator":"equals","rightOperand":{"type":"static","value":"\u003cstring>","columnId":"\u003cstring>","columnIds":["\u003cstring>"]}}]},"actions":[{"id":"\u003cstring>","objective":"calculate","variableId":"\u003cstring>","operator":"assign","value":{"type":"static","value":"\u003cstring>","columnId":"\u003cstring>","columnIds":["\u003cstring>"]}}]}],"logicFallback":"\u003cstring>","showIf":{"id":"\u003cstring>","connector":"and","conditions":[{"id":"\u003cstring>","leftOperand":{"type":"element","value":"\u003cstring>","meta":{}},"operator":"equals","rightOperand":{"type":"static","value":"\u003cstring>","columnId":"\u003cstring>","columnIds":["\u003cstring>"]}}]},"buttonLabel":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"backButtonLabel":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"}}],"endings":[{"id":"\u003cstring>","type":"endScreen","headline":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"subheader":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"buttonLabel":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"buttonLink":"\u003cstring>","imageUrl":"\u003cstring>","imageAltText":{"en-US":"What should we improve?","de-DE":"Was sollten wir verbessern?"},"videoUrl":"\u003cstring>","hideDefaultIcon":true}],"hiddenFields":{"enabled":true,"fieldIds":["\u003cstring>"]},"variables":[{"id":"\u003cstring>","name":"\u003cstring>","type":"number","value":123}],"startLogic":[{"id":"clrule12345678901234567890","conditions":{"id":"clgrp123456789012345678901","connector":"and","conditions":[{"id":"clcond12345678901234567890","leftOperand":{"type":"hiddenField","value":"panel_id"},"operator":"isNotSet"}]},"actions":[{"id":"clact123456789012345678901","objective":"jumpToBlock","target":"clend123456789012345678901"}]}],"embeddedFields":[{"storageKey":"plan_tier","key":"plan_tier","name":"Plan tier","source":"computed","dataType":"string","defaultValue":"\u003cstring>","locked":true}],"customCss":{"light":"\u003cstring>","dark":"\u003cstring>"},"visibility":"restricted","owner":{"name":"\u003cstring>"},"access":{"via":"workspace","canManageVisibility":true},"distribution":{"displayOption":"displaySome","displayLimit":3,"displayPercentage":null,"recontactDays":7,"autoClose":null,"keepEndingCardOpen":false,"autoComplete":null,"delay":0,"showConditions":{"id":"grp1","connector":"and","conditions":[{"id":"cnd1","leftOperand":{"type":"page","value":"currentUrl"},"operator":"pathIsAnyOf","rightOperand":{"type":"static","value":["/plan-compare","/drug-coverage"]}},{"id":"cnd2","leftOperand":{"type":"visit","value":"pagesViewed"},"operator":"isGreaterThanOrEqual","rightOperand":{"type":"static","value":3}}]},"triggers":[{"actionClassId":"clyy1234567890123456789012"}]},"targeting":{"filters":[{"id":"\u003cstring>","connector":"and","resource":{"id":"\u003cstring>","root":{"type":"attribute","contactAttributeKey":"\u003cstring>"},"qualifier":{"operator":"lessThan"},"value":"\u003cstring>"}}]}}}}},"exampleType":"generated"}},"exampleType":"generated"},"cc8dc1d4-12b6-4362-b6b7-f1fb7119ff26":{"description":"Bad Request — malformed JSON, invalid query/body/params, duplicate name, or unsupported field.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Request correlation ID"},"Cache-Control":{"schema":{"type":"string"},"example":"private, no-store"}},"content":{"application/problem+json":{"schema":{"type":"object","description":"RFC 9457 Problem Details for HTTP APIs (`application/problem+json`). Responses typically include a machine-readable `code` field alongside `title`, `status`, `detail`, and `requestId`.\n\nBranch on `code`, not on `detail` or `title`: `code` is stable and locale-independent, whereas `detail` is prose that may be reworded. No problem sets `type`, so per RFC 9457 §4.2.1 `title` is always the HTTP reason phrase for `status` and carries no information of its own.\n\nMember naming is frozen as published, mixed conventions included (`requestId` alongside `invalid_params` and `details.resource_type`): renaming any of them would break every client that reads them.","required":["title","status","detail","requestId"],"properties":{"title":{"type":"string","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"status":{"type":"integer","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"detail":{"type":"string","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"requestId":{"type":"string","isRequired":true,"uniqueKey":"requestId","typeLabel":"string"},"type":{"type":"string","format":"uri","uniqueKey":"type","typeLabel":"string\u003curi>"},"instance":{"type":"string","uniqueKey":"instance","typeLabel":"string"},"code":{"type":"string","enum":["ai_features_not_enabled","ai_generated_payload_invalid","ai_instance_not_configured","ai_output_too_long","ai_provider_auth_failed","ai_smart_tools_disabled","bad_gateway","bad_request","chart_in_use","conflict","creatives_not_entitled","custom_css_plan_required","dashboards_plan_required","forbidden","internal_server_error","invalid_workflow_state","not_authenticated","not_found","payload_too_large","projection_pending","service_unavailable","stored_survey_invalid","survey_has_linked_creatives","survey_not_workspace_visible","too_many_requests","unprocessable_content","visibility_blocked_by_connections","visibility_change_not_allowed","visibility_not_enabled","workflow_not_executable","workspace_survey_limit_reached"],"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"details":{"type":"object","uniqueKey":"details","typeLabel":"object"},"invalid_params":{"type":"array","items":{"type":"object","description":"Field-level validation error. `name` and `reason` are always intended for humans.\nOptional machine-readable fields are included when the API can identify the semantic error,\nespecially for survey locale, identifier, and reference validation used by MCP and agent clients.\n","required":["name","reason"],"properties":{"name":{"type":"string","description":"Dot-path to the invalid request field.","isRequired":true,"uniqueKey":"invalid_params.items.[INDEX].name","typeLabel":"string"},"reason":{"type":"string","description":"Human-readable repair guidance.","isRequired":true,"uniqueKey":"invalid_params.items.[INDEX].reason","typeLabel":"string"},"code":{"type":"string","enum":["dangling_reference","document_limit_exceeded","duplicate_identifier","duplicate_locale","file_limit_exceeded","file_type_unsupported","file_unreadable","forbidden_identifier","immutable_answer_code","immutable_identifier","immutable_option_deletion","immutable_option_text","immutable_question_code","immutable_question_type","invalid_locale","invalid_reference","limit_exceeded","missing_required_field","misordered_reference","missing_translation","qsf_limit_exceeded","qsf_not_recognized","read_only_field","unsupported_field","unsupported_locale"],"description":"Machine-readable validation category, when available.\n\nThis is the shared error shape every v3 operation returns, so it lists what the API can emit today and nothing more — `INVALID_PARAM_CODES` in `app/api/v3/lib/response.ts` is the registry, and a code absent from it is dropped before the response is built. Categories for operations that do not exist yet are added with the code that emits them, not ahead of it.\n\n`immutable_question_code`, `immutable_answer_code`, `immutable_question_type`, `immutable_option_text` and `immutable_option_deletion` come from the published-survey lock: once a survey has left `draft` (`inProgress`, `paused` or `completed`; a scheduled survey is `paused`), question codes, answer codes, question types and option text in every language are locked, and an option, matrix row or matrix column that existed when the survey was published cannot be deleted. `name` points at the offending field (at the option list for a deletion) and `identifier` is the option id, or the element id when the option is not the subject. Adding questions and options is still allowed.\n\n`limit_exceeded`: the field is well formed but past a limit the operation states, which `reason` names together with what to change. Chart queries use it for a date range that spans more time buckets than its granularity allows.\n\n`qsf_not_recognized` and `qsf_limit_exceeded` come from the Qualtrics import (an internal, session-only route sharing this shape): the file is not a Qualtrics export it can read, or it is one past an import limit, which `identifier` names.\n\n`file_type_unsupported`, `file_limit_exceeded` and `file_unreadable` come from the survey import too, about the uploaded file whatever its type: the import does not read this kind of file (`identifier` names what it recognized, if anything), the file is past an upload limit, which `identifier` names, or it is broken. A JSON file that does not parse has `identifier` `json_syntax`, and the problem's `details` give the `line` and `column` where it stops, when the parser says.\n\n`document_limit_exceeded` comes from the survey import of a questionnaire (Word, Excel or CSV): the document is past one of the import's limits, which `identifier` names.\n","uniqueKey":"invalid_params.items.[INDEX].code","typeLabel":"enum\u003cstring>"},"identifier":{"type":"string","description":"Identifier involved in the validation failure, when available. For language errors, this can be the normalized language code.","uniqueKey":"invalid_params.items.[INDEX].identifier","typeLabel":"string"},"referenceType":{"type":"string","enum":["block","element","ending","hiddenField","language","variable","variableName","recall"],"description":"Identifier namespace involved in the validation failure. Same rule as `code`: these are the namespaces the API emits today, and more arrive with the operations that emit them.","uniqueKey":"invalid_params.items.[INDEX].referenceType","typeLabel":"enum\u003cstring>"},"missingId":{"type":"string","description":"Referenced id that does not exist in the submitted survey document.","uniqueKey":"invalid_params.items.[INDEX].missingId","typeLabel":"string"},"firstUsedAt":{"type":"string","description":"Dot-path where a duplicate identifier was first used.","uniqueKey":"invalid_params.items.[INDEX].firstUsedAt","typeLabel":"string"},"conflictsWith":{"type":"string","description":"Dot-path to the existing identifier that conflicts with this field.","uniqueKey":"invalid_params.items.[INDEX].conflictsWith","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"invalid_params.items.[INDEX]","typeLabel":"object"},"uniqueKey":"invalid_params","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"title":"\u003cstring>","status":123,"detail":"\u003cstring>","requestId":"\u003cstring>","type":"\u003cstring>","instance":"\u003cstring>","code":"ai_features_not_enabled","details":{},"invalid_params":[{"name":"\u003cstring>","reason":"\u003cstring>","code":"dangling_reference","identifier":"\u003cstring>","referenceType":"block","missingId":"\u003cstring>","firstUsedAt":"\u003cstring>","conflictsWith":"\u003cstring>"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"15defb78-9a52-48e2-9802-c07bf309cd53":{"description":"Not authenticated (no valid session or API key).","headers":{"WWW-Authenticate":{"schema":{"type":"string"},"example":"Bearer realm=\"formbricks\"","description":"Authentication scheme challenge. RFC 9110 §15.5.2 asks a 401 for a challenge \"applicable to the target resource\", and Bearer is applicable here because these operations accept the API key as `Authorization: Bearer \u003ckey>` as well as `x-api-key`. Session-cookie-only operations send no challenge — see `V3UnauthorizedSession`. The MCP endpoints send a richer OAuth challenge carrying `resource_metadata` and `scope`."},"X-Request-Id":{"schema":{"type":"string"},"description":"Request correlation ID"},"Cache-Control":{"schema":{"type":"string"},"example":"private, no-store"}},"content":{"application/problem+json":{"schema":{"type":"object","description":"RFC 9457 Problem Details for HTTP APIs (`application/problem+json`). Responses typically include a machine-readable `code` field alongside `title`, `status`, `detail`, and `requestId`.\n\nBranch on `code`, not on `detail` or `title`: `code` is stable and locale-independent, whereas `detail` is prose that may be reworded. No problem sets `type`, so per RFC 9457 §4.2.1 `title` is always the HTTP reason phrase for `status` and carries no information of its own.\n\nMember naming is frozen as published, mixed conventions included (`requestId` alongside `invalid_params` and `details.resource_type`): renaming any of them would break every client that reads them.","required":["title","status","detail","requestId"],"properties":{"title":{"type":"string","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"status":{"type":"integer","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"detail":{"type":"string","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"requestId":{"type":"string","isRequired":true,"uniqueKey":"requestId","typeLabel":"string"},"type":{"type":"string","format":"uri","uniqueKey":"type","typeLabel":"string\u003curi>"},"instance":{"type":"string","uniqueKey":"instance","typeLabel":"string"},"code":{"type":"string","enum":["ai_features_not_enabled","ai_generated_payload_invalid","ai_instance_not_configured","ai_output_too_long","ai_provider_auth_failed","ai_smart_tools_disabled","bad_gateway","bad_request","chart_in_use","conflict","creatives_not_entitled","custom_css_plan_required","dashboards_plan_required","forbidden","internal_server_error","invalid_workflow_state","not_authenticated","not_found","payload_too_large","projection_pending","service_unavailable","stored_survey_invalid","survey_has_linked_creatives","survey_not_workspace_visible","too_many_requests","unprocessable_content","visibility_blocked_by_connections","visibility_change_not_allowed","visibility_not_enabled","workflow_not_executable","workspace_survey_limit_reached"],"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"details":{"type":"object","uniqueKey":"details","typeLabel":"object"},"invalid_params":{"type":"array","items":{"type":"object","description":"Field-level validation error. `name` and `reason` are always intended for humans.\nOptional machine-readable fields are included when the API can identify the semantic error,\nespecially for survey locale, identifier, and reference validation used by MCP and agent clients.\n","required":["name","reason"],"properties":{"name":{"type":"string","description":"Dot-path to the invalid request field.","isRequired":true,"uniqueKey":"invalid_params.items.[INDEX].name","typeLabel":"string"},"reason":{"type":"string","description":"Human-readable repair guidance.","isRequired":true,"uniqueKey":"invalid_params.items.[INDEX].reason","typeLabel":"string"},"code":{"type":"string","enum":["dangling_reference","document_limit_exceeded","duplicate_identifier","duplicate_locale","file_limit_exceeded","file_type_unsupported","file_unreadable","forbidden_identifier","immutable_answer_code","immutable_identifier","immutable_option_deletion","immutable_option_text","immutable_question_code","immutable_question_type","invalid_locale","invalid_reference","limit_exceeded","missing_required_field","misordered_reference","missing_translation","qsf_limit_exceeded","qsf_not_recognized","read_only_field","unsupported_field","unsupported_locale"],"description":"Machine-readable validation category, when available.\n\nThis is the shared error shape every v3 operation returns, so it lists what the API can emit today and nothing more — `INVALID_PARAM_CODES` in `app/api/v3/lib/response.ts` is the registry, and a code absent from it is dropped before the response is built. Categories for operations that do not exist yet are added with the code that emits them, not ahead of it.\n\n`immutable_question_code`, `immutable_answer_code`, `immutable_question_type`, `immutable_option_text` and `immutable_option_deletion` come from the published-survey lock: once a survey has left `draft` (`inProgress`, `paused` or `completed`; a scheduled survey is `paused`), question codes, answer codes, question types and option text in every language are locked, and an option, matrix row or matrix column that existed when the survey was published cannot be deleted. `name` points at the offending field (at the option list for a deletion) and `identifier` is the option id, or the element id when the option is not the subject. Adding questions and options is still allowed.\n\n`limit_exceeded`: the field is well formed but past a limit the operation states, which `reason` names together with what to change. Chart queries use it for a date range that spans more time buckets than its granularity allows.\n\n`qsf_not_recognized` and `qsf_limit_exceeded` come from the Qualtrics import (an internal, session-only route sharing this shape): the file is not a Qualtrics export it can read, or it is one past an import limit, which `identifier` names.\n\n`file_type_unsupported`, `file_limit_exceeded` and `file_unreadable` come from the survey import too, about the uploaded file whatever its type: the import does not read this kind of file (`identifier` names what it recognized, if anything), the file is past an upload limit, which `identifier` names, or it is broken. A JSON file that does not parse has `identifier` `json_syntax`, and the problem's `details` give the `line` and `column` where it stops, when the parser says.\n\n`document_limit_exceeded` comes from the survey import of a questionnaire (Word, Excel or CSV): the document is past one of the import's limits, which `identifier` names.\n","uniqueKey":"invalid_params.items.[INDEX].code","typeLabel":"enum\u003cstring>"},"identifier":{"type":"string","description":"Identifier involved in the validation failure, when available. For language errors, this can be the normalized language code.","uniqueKey":"invalid_params.items.[INDEX].identifier","typeLabel":"string"},"referenceType":{"type":"string","enum":["block","element","ending","hiddenField","language","variable","variableName","recall"],"description":"Identifier namespace involved in the validation failure. Same rule as `code`: these are the namespaces the API emits today, and more arrive with the operations that emit them.","uniqueKey":"invalid_params.items.[INDEX].referenceType","typeLabel":"enum\u003cstring>"},"missingId":{"type":"string","description":"Referenced id that does not exist in the submitted survey document.","uniqueKey":"invalid_params.items.[INDEX].missingId","typeLabel":"string"},"firstUsedAt":{"type":"string","description":"Dot-path where a duplicate identifier was first used.","uniqueKey":"invalid_params.items.[INDEX].firstUsedAt","typeLabel":"string"},"conflictsWith":{"type":"string","description":"Dot-path to the existing identifier that conflicts with this field.","uniqueKey":"invalid_params.items.[INDEX].conflictsWith","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"invalid_params.items.[INDEX]","typeLabel":"object"},"uniqueKey":"invalid_params","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"title":"\u003cstring>","status":123,"detail":"\u003cstring>","requestId":"\u003cstring>","type":"\u003cstring>","instance":"\u003cstring>","code":"ai_features_not_enabled","details":{},"invalid_params":[{"name":"\u003cstring>","reason":"\u003cstring>","code":"dangling_reference","identifier":"\u003cstring>","referenceType":"block","missingId":"\u003cstring>","firstUsedAt":"\u003cstring>","conflictsWith":"\u003cstring>"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"cf0dfd8a-664f-4d7b-a8a7-43fe66b97622":{"description":"Forbidden — no workspace access, or resource does not exist (404 not used; avoids existence leak).","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Request correlation ID"},"Cache-Control":{"schema":{"type":"string"},"example":"private, no-store"}},"content":{"application/problem+json":{"schema":{"type":"object","description":"RFC 9457 Problem Details for HTTP APIs (`application/problem+json`). Responses typically include a machine-readable `code` field alongside `title`, `status`, `detail`, and `requestId`.\n\nBranch on `code`, not on `detail` or `title`: `code` is stable and locale-independent, whereas `detail` is prose that may be reworded. No problem sets `type`, so per RFC 9457 §4.2.1 `title` is always the HTTP reason phrase for `status` and carries no information of its own.\n\nMember naming is frozen as published, mixed conventions included (`requestId` alongside `invalid_params` and `details.resource_type`): renaming any of them would break every client that reads them.","required":["title","status","detail","requestId"],"properties":{"title":{"type":"string","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"status":{"type":"integer","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"detail":{"type":"string","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"requestId":{"type":"string","isRequired":true,"uniqueKey":"requestId","typeLabel":"string"},"type":{"type":"string","format":"uri","uniqueKey":"type","typeLabel":"string\u003curi>"},"instance":{"type":"string","uniqueKey":"instance","typeLabel":"string"},"code":{"type":"string","enum":["ai_features_not_enabled","ai_generated_payload_invalid","ai_instance_not_configured","ai_output_too_long","ai_provider_auth_failed","ai_smart_tools_disabled","bad_gateway","bad_request","chart_in_use","conflict","creatives_not_entitled","custom_css_plan_required","dashboards_plan_required","forbidden","internal_server_error","invalid_workflow_state","not_authenticated","not_found","payload_too_large","projection_pending","service_unavailable","stored_survey_invalid","survey_has_linked_creatives","survey_not_workspace_visible","too_many_requests","unprocessable_content","visibility_blocked_by_connections","visibility_change_not_allowed","visibility_not_enabled","workflow_not_executable","workspace_survey_limit_reached"],"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"details":{"type":"object","uniqueKey":"details","typeLabel":"object"},"invalid_params":{"type":"array","items":{"type":"object","description":"Field-level validation error. `name` and `reason` are always intended for humans.\nOptional machine-readable fields are included when the API can identify the semantic error,\nespecially for survey locale, identifier, and reference validation used by MCP and agent clients.\n","required":["name","reason"],"properties":{"name":{"type":"string","description":"Dot-path to the invalid request field.","isRequired":true,"uniqueKey":"invalid_params.items.[INDEX].name","typeLabel":"string"},"reason":{"type":"string","description":"Human-readable repair guidance.","isRequired":true,"uniqueKey":"invalid_params.items.[INDEX].reason","typeLabel":"string"},"code":{"type":"string","enum":["dangling_reference","document_limit_exceeded","duplicate_identifier","duplicate_locale","file_limit_exceeded","file_type_unsupported","file_unreadable","forbidden_identifier","immutable_answer_code","immutable_identifier","immutable_option_deletion","immutable_option_text","immutable_question_code","immutable_question_type","invalid_locale","invalid_reference","limit_exceeded","missing_required_field","misordered_reference","missing_translation","qsf_limit_exceeded","qsf_not_recognized","read_only_field","unsupported_field","unsupported_locale"],"description":"Machine-readable validation category, when available.\n\nThis is the shared error shape every v3 operation returns, so it lists what the API can emit today and nothing more — `INVALID_PARAM_CODES` in `app/api/v3/lib/response.ts` is the registry, and a code absent from it is dropped before the response is built. Categories for operations that do not exist yet are added with the code that emits them, not ahead of it.\n\n`immutable_question_code`, `immutable_answer_code`, `immutable_question_type`, `immutable_option_text` and `immutable_option_deletion` come from the published-survey lock: once a survey has left `draft` (`inProgress`, `paused` or `completed`; a scheduled survey is `paused`), question codes, answer codes, question types and option text in every language are locked, and an option, matrix row or matrix column that existed when the survey was published cannot be deleted. `name` points at the offending field (at the option list for a deletion) and `identifier` is the option id, or the element id when the option is not the subject. Adding questions and options is still allowed.\n\n`limit_exceeded`: the field is well formed but past a limit the operation states, which `reason` names together with what to change. Chart queries use it for a date range that spans more time buckets than its granularity allows.\n\n`qsf_not_recognized` and `qsf_limit_exceeded` come from the Qualtrics import (an internal, session-only route sharing this shape): the file is not a Qualtrics export it can read, or it is one past an import limit, which `identifier` names.\n\n`file_type_unsupported`, `file_limit_exceeded` and `file_unreadable` come from the survey import too, about the uploaded file whatever its type: the import does not read this kind of file (`identifier` names what it recognized, if anything), the file is past an upload limit, which `identifier` names, or it is broken. A JSON file that does not parse has `identifier` `json_syntax`, and the problem's `details` give the `line` and `column` where it stops, when the parser says.\n\n`document_limit_exceeded` comes from the survey import of a questionnaire (Word, Excel or CSV): the document is past one of the import's limits, which `identifier` names.\n","uniqueKey":"invalid_params.items.[INDEX].code","typeLabel":"enum\u003cstring>"},"identifier":{"type":"string","description":"Identifier involved in the validation failure, when available. For language errors, this can be the normalized language code.","uniqueKey":"invalid_params.items.[INDEX].identifier","typeLabel":"string"},"referenceType":{"type":"string","enum":["block","element","ending","hiddenField","language","variable","variableName","recall"],"description":"Identifier namespace involved in the validation failure. Same rule as `code`: these are the namespaces the API emits today, and more arrive with the operations that emit them.","uniqueKey":"invalid_params.items.[INDEX].referenceType","typeLabel":"enum\u003cstring>"},"missingId":{"type":"string","description":"Referenced id that does not exist in the submitted survey document.","uniqueKey":"invalid_params.items.[INDEX].missingId","typeLabel":"string"},"firstUsedAt":{"type":"string","description":"Dot-path where a duplicate identifier was first used.","uniqueKey":"invalid_params.items.[INDEX].firstUsedAt","typeLabel":"string"},"conflictsWith":{"type":"string","description":"Dot-path to the existing identifier that conflicts with this field.","uniqueKey":"invalid_params.items.[INDEX].conflictsWith","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"invalid_params.items.[INDEX]","typeLabel":"object"},"uniqueKey":"invalid_params","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"title":"\u003cstring>","status":123,"detail":"\u003cstring>","requestId":"\u003cstring>","type":"\u003cstring>","instance":"\u003cstring>","code":"ai_features_not_enabled","details":{},"invalid_params":[{"name":"\u003cstring>","reason":"\u003cstring>","code":"dangling_reference","identifier":"\u003cstring>","referenceType":"block","missingId":"\u003cstring>","firstUsedAt":"\u003cstring>","conflictsWith":"\u003cstring>"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"1c11f9c7-7fd0-494e-a520-c741a77a2d78":{"description":"The survey changed since the `expectedUpdatedAt` you supplied. Nothing was written. The problem's `details` carries `expectedUpdatedAt` and the live `currentUpdatedAt`, so a client can re-read and retry without guessing.\n","content":{"application/problem+json":{"schema":{"type":"object","description":"RFC 9457 Problem Details for HTTP APIs (`application/problem+json`). Responses typically include a machine-readable `code` field alongside `title`, `status`, `detail`, and `requestId`.\n\nBranch on `code`, not on `detail` or `title`: `code` is stable and locale-independent, whereas `detail` is prose that may be reworded. No problem sets `type`, so per RFC 9457 §4.2.1 `title` is always the HTTP reason phrase for `status` and carries no information of its own.\n\nMember naming is frozen as published, mixed conventions included (`requestId` alongside `invalid_params` and `details.resource_type`): renaming any of them would break every client that reads them.","required":["title","status","detail","requestId"],"properties":{"title":{"type":"string","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"status":{"type":"integer","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"detail":{"type":"string","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"requestId":{"type":"string","isRequired":true,"uniqueKey":"requestId","typeLabel":"string"},"type":{"type":"string","format":"uri","uniqueKey":"type","typeLabel":"string\u003curi>"},"instance":{"type":"string","uniqueKey":"instance","typeLabel":"string"},"code":{"type":"string","enum":["ai_features_not_enabled","ai_generated_payload_invalid","ai_instance_not_configured","ai_output_too_long","ai_provider_auth_failed","ai_smart_tools_disabled","bad_gateway","bad_request","chart_in_use","conflict","creatives_not_entitled","custom_css_plan_required","dashboards_plan_required","forbidden","internal_server_error","invalid_workflow_state","not_authenticated","not_found","payload_too_large","projection_pending","service_unavailable","stored_survey_invalid","survey_has_linked_creatives","survey_not_workspace_visible","too_many_requests","unprocessable_content","visibility_blocked_by_connections","visibility_change_not_allowed","visibility_not_enabled","workflow_not_executable","workspace_survey_limit_reached"],"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"details":{"type":"object","uniqueKey":"details","typeLabel":"object"},"invalid_params":{"type":"array","items":{"type":"object","description":"Field-level validation error. `name` and `reason` are always intended for humans.\nOptional machine-readable fields are included when the API can identify the semantic error,\nespecially for survey locale, identifier, and reference validation used by MCP and agent clients.\n","required":["name","reason"],"properties":{"name":{"type":"string","description":"Dot-path to the invalid request field.","isRequired":true,"uniqueKey":"invalid_params.items.[INDEX].name","typeLabel":"string"},"reason":{"type":"string","description":"Human-readable repair guidance.","isRequired":true,"uniqueKey":"invalid_params.items.[INDEX].reason","typeLabel":"string"},"code":{"type":"string","enum":["dangling_reference","document_limit_exceeded","duplicate_identifier","duplicate_locale","file_limit_exceeded","file_type_unsupported","file_unreadable","forbidden_identifier","immutable_answer_code","immutable_identifier","immutable_option_deletion","immutable_option_text","immutable_question_code","immutable_question_type","invalid_locale","invalid_reference","limit_exceeded","missing_required_field","misordered_reference","missing_translation","qsf_limit_exceeded","qsf_not_recognized","read_only_field","unsupported_field","unsupported_locale"],"description":"Machine-readable validation category, when available.\n\nThis is the shared error shape every v3 operation returns, so it lists what the API can emit today and nothing more — `INVALID_PARAM_CODES` in `app/api/v3/lib/response.ts` is the registry, and a code absent from it is dropped before the response is built. Categories for operations that do not exist yet are added with the code that emits them, not ahead of it.\n\n`immutable_question_code`, `immutable_answer_code`, `immutable_question_type`, `immutable_option_text` and `immutable_option_deletion` come from the published-survey lock: once a survey has left `draft` (`inProgress`, `paused` or `completed`; a scheduled survey is `paused`), question codes, answer codes, question types and option text in every language are locked, and an option, matrix row or matrix column that existed when the survey was published cannot be deleted. `name` points at the offending field (at the option list for a deletion) and `identifier` is the option id, or the element id when the option is not the subject. Adding questions and options is still allowed.\n\n`limit_exceeded`: the field is well formed but past a limit the operation states, which `reason` names together with what to change. Chart queries use it for a date range that spans more time buckets than its granularity allows.\n\n`qsf_not_recognized` and `qsf_limit_exceeded` come from the Qualtrics import (an internal, session-only route sharing this shape): the file is not a Qualtrics export it can read, or it is one past an import limit, which `identifier` names.\n\n`file_type_unsupported`, `file_limit_exceeded` and `file_unreadable` come from the survey import too, about the uploaded file whatever its type: the import does not read this kind of file (`identifier` names what it recognized, if anything), the file is past an upload limit, which `identifier` names, or it is broken. A JSON file that does not parse has `identifier` `json_syntax`, and the problem's `details` give the `line` and `column` where it stops, when the parser says.\n\n`document_limit_exceeded` comes from the survey import of a questionnaire (Word, Excel or CSV): the document is past one of the import's limits, which `identifier` names.\n","uniqueKey":"invalid_params.items.[INDEX].code","typeLabel":"enum\u003cstring>"},"identifier":{"type":"string","description":"Identifier involved in the validation failure, when available. For language errors, this can be the normalized language code.","uniqueKey":"invalid_params.items.[INDEX].identifier","typeLabel":"string"},"referenceType":{"type":"string","enum":["block","element","ending","hiddenField","language","variable","variableName","recall"],"description":"Identifier namespace involved in the validation failure. Same rule as `code`: these are the namespaces the API emits today, and more arrive with the operations that emit them.","uniqueKey":"invalid_params.items.[INDEX].referenceType","typeLabel":"enum\u003cstring>"},"missingId":{"type":"string","description":"Referenced id that does not exist in the submitted survey document.","uniqueKey":"invalid_params.items.[INDEX].missingId","typeLabel":"string"},"firstUsedAt":{"type":"string","description":"Dot-path where a duplicate identifier was first used.","uniqueKey":"invalid_params.items.[INDEX].firstUsedAt","typeLabel":"string"},"conflictsWith":{"type":"string","description":"Dot-path to the existing identifier that conflicts with this field.","uniqueKey":"invalid_params.items.[INDEX].conflictsWith","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"invalid_params.items.[INDEX]","typeLabel":"object"},"uniqueKey":"invalid_params","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"example":{"title":"Conflict","status":409,"detail":"Survey was modified since it was last read; updatedAt is now 2026-04-21T11:30:00.000Z. Re-read the survey and retry.","code":"conflict","requestId":"6f1f7f3e-3b0e-4a1a-9f0a-7c9a1d2b3c4d","details":{"expectedUpdatedAt":"2026-04-21T10:00:00.000Z","currentUpdatedAt":"2026-04-21T11:30:00.000Z"}},"examples":{"Example":{"title":"Example","value":{"title":"Conflict","status":409,"detail":"Survey was modified since it was last read; updatedAt is now 2026-04-21T11:30:00.000Z. Re-read the survey and retry.","code":"conflict","requestId":"6f1f7f3e-3b0e-4a1a-9f0a-7c9a1d2b3c4d","details":{"expectedUpdatedAt":"2026-04-21T10:00:00.000Z","currentUpdatedAt":"2026-04-21T11:30:00.000Z"}}}},"exampleType":"examples"}},"exampleType":"examples"},"757e39dd-9bf9-48b4-ae21-ff23999dc9e3":{"description":"The request is well-formed but could not be applied. `invalid_params[].name` points at the operation that failed — `ops.\u003ci>.…` — including for problems found while validating the resulting document. The one exception is a block the request did not touch: those are reported at `blocks.\u003ci>`, where `\u003ci>` is the block's index in the stored survey — the same index `GET` returns, even when an earlier operation inserted or removed blocks before it — because the problem is in the stored survey rather than in any operation. A `stored_survey_invalid` response uses stored-survey paths throughout for the same reason.\n\nCommon codes: `dangling_reference` (an id that is not on the survey), `duplicate_identifier` (inserting an id that already exists), `missing_required_field` (an inserted block whose `id` is present but empty — omitting `id` entirely is fine, the server generates one), `immutable_identifier` (`block.id` contradicting the op's `id`), `immutable_question_code`, `immutable_answer_code`, `immutable_question_type`, `immutable_option_text` and `immutable_option_deletion` (an op that would change a code, a question type or option text of a published survey, or delete an option that existed at launch), and `stored_survey_invalid` when the stored survey itself fails the document contract. The edit is also refused when it newly *introduces* a loop in the conditional logic — jumps, fallbacks and next blocks leading back on themselves, so a respondent could never reach an ending — reported at the `logic` of each block a new looping step leaves. A survey that already loops stays editable.\n","content":{"application/problem+json":{"schema":{"type":"object","description":"RFC 9457 Problem Details for HTTP APIs (`application/problem+json`). Responses typically include a machine-readable `code` field alongside `title`, `status`, `detail`, and `requestId`.\n\nBranch on `code`, not on `detail` or `title`: `code` is stable and locale-independent, whereas `detail` is prose that may be reworded. No problem sets `type`, so per RFC 9457 §4.2.1 `title` is always the HTTP reason phrase for `status` and carries no information of its own.\n\nMember naming is frozen as published, mixed conventions included (`requestId` alongside `invalid_params` and `details.resource_type`): renaming any of them would break every client that reads them.","required":["title","status","detail","requestId"],"properties":{"title":{"type":"string","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"status":{"type":"integer","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"detail":{"type":"string","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"requestId":{"type":"string","isRequired":true,"uniqueKey":"requestId","typeLabel":"string"},"type":{"type":"string","format":"uri","uniqueKey":"type","typeLabel":"string\u003curi>"},"instance":{"type":"string","uniqueKey":"instance","typeLabel":"string"},"code":{"type":"string","enum":["ai_features_not_enabled","ai_generated_payload_invalid","ai_instance_not_configured","ai_output_too_long","ai_provider_auth_failed","ai_smart_tools_disabled","bad_gateway","bad_request","chart_in_use","conflict","creatives_not_entitled","custom_css_plan_required","dashboards_plan_required","forbidden","internal_server_error","invalid_workflow_state","not_authenticated","not_found","payload_too_large","projection_pending","service_unavailable","stored_survey_invalid","survey_has_linked_creatives","survey_not_workspace_visible","too_many_requests","unprocessable_content","visibility_blocked_by_connections","visibility_change_not_allowed","visibility_not_enabled","workflow_not_executable","workspace_survey_limit_reached"],"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"details":{"type":"object","uniqueKey":"details","typeLabel":"object"},"invalid_params":{"type":"array","items":{"type":"object","description":"Field-level validation error. `name` and `reason` are always intended for humans.\nOptional machine-readable fields are included when the API can identify the semantic error,\nespecially for survey locale, identifier, and reference validation used by MCP and agent clients.\n","required":["name","reason"],"properties":{"name":{"type":"string","description":"Dot-path to the invalid request field.","isRequired":true,"uniqueKey":"invalid_params.items.[INDEX].name","typeLabel":"string"},"reason":{"type":"string","description":"Human-readable repair guidance.","isRequired":true,"uniqueKey":"invalid_params.items.[INDEX].reason","typeLabel":"string"},"code":{"type":"string","enum":["dangling_reference","document_limit_exceeded","duplicate_identifier","duplicate_locale","file_limit_exceeded","file_type_unsupported","file_unreadable","forbidden_identifier","immutable_answer_code","immutable_identifier","immutable_option_deletion","immutable_option_text","immutable_question_code","immutable_question_type","invalid_locale","invalid_reference","limit_exceeded","missing_required_field","misordered_reference","missing_translation","qsf_limit_exceeded","qsf_not_recognized","read_only_field","unsupported_field","unsupported_locale"],"description":"Machine-readable validation category, when available.\n\nThis is the shared error shape every v3 operation returns, so it lists what the API can emit today and nothing more — `INVALID_PARAM_CODES` in `app/api/v3/lib/response.ts` is the registry, and a code absent from it is dropped before the response is built. Categories for operations that do not exist yet are added with the code that emits them, not ahead of it.\n\n`immutable_question_code`, `immutable_answer_code`, `immutable_question_type`, `immutable_option_text` and `immutable_option_deletion` come from the published-survey lock: once a survey has left `draft` (`inProgress`, `paused` or `completed`; a scheduled survey is `paused`), question codes, answer codes, question types and option text in every language are locked, and an option, matrix row or matrix column that existed when the survey was published cannot be deleted. `name` points at the offending field (at the option list for a deletion) and `identifier` is the option id, or the element id when the option is not the subject. Adding questions and options is still allowed.\n\n`limit_exceeded`: the field is well formed but past a limit the operation states, which `reason` names together with what to change. Chart queries use it for a date range that spans more time buckets than its granularity allows.\n\n`qsf_not_recognized` and `qsf_limit_exceeded` come from the Qualtrics import (an internal, session-only route sharing this shape): the file is not a Qualtrics export it can read, or it is one past an import limit, which `identifier` names.\n\n`file_type_unsupported`, `file_limit_exceeded` and `file_unreadable` come from the survey import too, about the uploaded file whatever its type: the import does not read this kind of file (`identifier` names what it recognized, if anything), the file is past an upload limit, which `identifier` names, or it is broken. A JSON file that does not parse has `identifier` `json_syntax`, and the problem's `details` give the `line` and `column` where it stops, when the parser says.\n\n`document_limit_exceeded` comes from the survey import of a questionnaire (Word, Excel or CSV): the document is past one of the import's limits, which `identifier` names.\n","uniqueKey":"invalid_params.items.[INDEX].code","typeLabel":"enum\u003cstring>"},"identifier":{"type":"string","description":"Identifier involved in the validation failure, when available. For language errors, this can be the normalized language code.","uniqueKey":"invalid_params.items.[INDEX].identifier","typeLabel":"string"},"referenceType":{"type":"string","enum":["block","element","ending","hiddenField","language","variable","variableName","recall"],"description":"Identifier namespace involved in the validation failure. Same rule as `code`: these are the namespaces the API emits today, and more arrive with the operations that emit them.","uniqueKey":"invalid_params.items.[INDEX].referenceType","typeLabel":"enum\u003cstring>"},"missingId":{"type":"string","description":"Referenced id that does not exist in the submitted survey document.","uniqueKey":"invalid_params.items.[INDEX].missingId","typeLabel":"string"},"firstUsedAt":{"type":"string","description":"Dot-path where a duplicate identifier was first used.","uniqueKey":"invalid_params.items.[INDEX].firstUsedAt","typeLabel":"string"},"conflictsWith":{"type":"string","description":"Dot-path to the existing identifier that conflicts with this field.","uniqueKey":"invalid_params.items.[INDEX].conflictsWith","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"invalid_params.items.[INDEX]","typeLabel":"object"},"uniqueKey":"invalid_params","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"unknownBlock":{"title":"unknownBlock","summary":"An operation names a block that is not on the survey","value":{"title":"Unprocessable Content","status":422,"detail":"Block operations could not be applied","code":"unprocessable_content","requestId":"6f1f7f3e-3b0e-4a1a-9f0a-7c9a1d2b3c4d","invalid_params":[{"name":"ops.1.id","reason":"Block 'n7m4q8w2e6r0t3y5u1i9o2p4' does not exist on this survey","code":"dangling_reference","identifier":"n7m4q8w2e6r0t3y5u1i9o2p4","referenceType":"block","missingId":"n7m4q8w2e6r0t3y5u1i9o2p4"}]}},"storedSurveyInvalid":{"title":"storedSurveyInvalid","summary":"The stored survey fails the document contract","value":{"title":"Unprocessable Content","status":422,"detail":"The stored survey does not satisfy the v3 survey document contract. The reported paths are into the stored survey, not your request; a patch that includes corrected values for those fields is accepted, or repair them in the editor.","code":"stored_survey_invalid","requestId":"6f1f7f3e-3b0e-4a1a-9f0a-7c9a1d2b3c4d","invalid_params":[{"name":"blocks.0.elements.0.headline","reason":"Translatable field is missing configured language 'de-DE'","code":"missing_translation"}]}}},"exampleType":"examples"}},"exampleType":"examples"},"7572a7db-f5a5-4785-bb53-2650cd0cd8f0":{"description":"Rate limit exceeded.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Request correlation ID"},"Cache-Control":{"schema":{"type":"string"},"example":"private, no-store"},"Retry-After":{"schema":{"type":"integer"},"description":"Seconds until the current rate-limit window resets."}},"content":{"application/problem+json":{"schema":{"type":"object","description":"RFC 9457 Problem Details for HTTP APIs (`application/problem+json`). Responses typically include a machine-readable `code` field alongside `title`, `status`, `detail`, and `requestId`.\n\nBranch on `code`, not on `detail` or `title`: `code` is stable and locale-independent, whereas `detail` is prose that may be reworded. No problem sets `type`, so per RFC 9457 §4.2.1 `title` is always the HTTP reason phrase for `status` and carries no information of its own.\n\nMember naming is frozen as published, mixed conventions included (`requestId` alongside `invalid_params` and `details.resource_type`): renaming any of them would break every client that reads them.","required":["title","status","detail","requestId"],"properties":{"title":{"type":"string","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"status":{"type":"integer","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"detail":{"type":"string","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"requestId":{"type":"string","isRequired":true,"uniqueKey":"requestId","typeLabel":"string"},"type":{"type":"string","format":"uri","uniqueKey":"type","typeLabel":"string\u003curi>"},"instance":{"type":"string","uniqueKey":"instance","typeLabel":"string"},"code":{"type":"string","enum":["ai_features_not_enabled","ai_generated_payload_invalid","ai_instance_not_configured","ai_output_too_long","ai_provider_auth_failed","ai_smart_tools_disabled","bad_gateway","bad_request","chart_in_use","conflict","creatives_not_entitled","custom_css_plan_required","dashboards_plan_required","forbidden","internal_server_error","invalid_workflow_state","not_authenticated","not_found","payload_too_large","projection_pending","service_unavailable","stored_survey_invalid","survey_has_linked_creatives","survey_not_workspace_visible","too_many_requests","unprocessable_content","visibility_blocked_by_connections","visibility_change_not_allowed","visibility_not_enabled","workflow_not_executable","workspace_survey_limit_reached"],"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"details":{"type":"object","uniqueKey":"details","typeLabel":"object"},"invalid_params":{"type":"array","items":{"type":"object","description":"Field-level validation error. `name` and `reason` are always intended for humans.\nOptional machine-readable fields are included when the API can identify the semantic error,\nespecially for survey locale, identifier, and reference validation used by MCP and agent clients.\n","required":["name","reason"],"properties":{"name":{"type":"string","description":"Dot-path to the invalid request field.","isRequired":true,"uniqueKey":"invalid_params.items.[INDEX].name","typeLabel":"string"},"reason":{"type":"string","description":"Human-readable repair guidance.","isRequired":true,"uniqueKey":"invalid_params.items.[INDEX].reason","typeLabel":"string"},"code":{"type":"string","enum":["dangling_reference","document_limit_exceeded","duplicate_identifier","duplicate_locale","file_limit_exceeded","file_type_unsupported","file_unreadable","forbidden_identifier","immutable_answer_code","immutable_identifier","immutable_option_deletion","immutable_option_text","immutable_question_code","immutable_question_type","invalid_locale","invalid_reference","limit_exceeded","missing_required_field","misordered_reference","missing_translation","qsf_limit_exceeded","qsf_not_recognized","read_only_field","unsupported_field","unsupported_locale"],"description":"Machine-readable validation category, when available.\n\nThis is the shared error shape every v3 operation returns, so it lists what the API can emit today and nothing more — `INVALID_PARAM_CODES` in `app/api/v3/lib/response.ts` is the registry, and a code absent from it is dropped before the response is built. Categories for operations that do not exist yet are added with the code that emits them, not ahead of it.\n\n`immutable_question_code`, `immutable_answer_code`, `immutable_question_type`, `immutable_option_text` and `immutable_option_deletion` come from the published-survey lock: once a survey has left `draft` (`inProgress`, `paused` or `completed`; a scheduled survey is `paused`), question codes, answer codes, question types and option text in every language are locked, and an option, matrix row or matrix column that existed when the survey was published cannot be deleted. `name` points at the offending field (at the option list for a deletion) and `identifier` is the option id, or the element id when the option is not the subject. Adding questions and options is still allowed.\n\n`limit_exceeded`: the field is well formed but past a limit the operation states, which `reason` names together with what to change. Chart queries use it for a date range that spans more time buckets than its granularity allows.\n\n`qsf_not_recognized` and `qsf_limit_exceeded` come from the Qualtrics import (an internal, session-only route sharing this shape): the file is not a Qualtrics export it can read, or it is one past an import limit, which `identifier` names.\n\n`file_type_unsupported`, `file_limit_exceeded` and `file_unreadable` come from the survey import too, about the uploaded file whatever its type: the import does not read this kind of file (`identifier` names what it recognized, if anything), the file is past an upload limit, which `identifier` names, or it is broken. A JSON file that does not parse has `identifier` `json_syntax`, and the problem's `details` give the `line` and `column` where it stops, when the parser says.\n\n`document_limit_exceeded` comes from the survey import of a questionnaire (Word, Excel or CSV): the document is past one of the import's limits, which `identifier` names.\n","uniqueKey":"invalid_params.items.[INDEX].code","typeLabel":"enum\u003cstring>"},"identifier":{"type":"string","description":"Identifier involved in the validation failure, when available. For language errors, this can be the normalized language code.","uniqueKey":"invalid_params.items.[INDEX].identifier","typeLabel":"string"},"referenceType":{"type":"string","enum":["block","element","ending","hiddenField","language","variable","variableName","recall"],"description":"Identifier namespace involved in the validation failure. Same rule as `code`: these are the namespaces the API emits today, and more arrive with the operations that emit them.","uniqueKey":"invalid_params.items.[INDEX].referenceType","typeLabel":"enum\u003cstring>"},"missingId":{"type":"string","description":"Referenced id that does not exist in the submitted survey document.","uniqueKey":"invalid_params.items.[INDEX].missingId","typeLabel":"string"},"firstUsedAt":{"type":"string","description":"Dot-path where a duplicate identifier was first used.","uniqueKey":"invalid_params.items.[INDEX].firstUsedAt","typeLabel":"string"},"conflictsWith":{"type":"string","description":"Dot-path to the existing identifier that conflicts with this field.","uniqueKey":"invalid_params.items.[INDEX].conflictsWith","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"invalid_params.items.[INDEX]","typeLabel":"object"},"uniqueKey":"invalid_params","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"title":"\u003cstring>","status":123,"detail":"\u003cstring>","requestId":"\u003cstring>","type":"\u003cstring>","instance":"\u003cstring>","code":"ai_features_not_enabled","details":{},"invalid_params":[{"name":"\u003cstring>","reason":"\u003cstring>","code":"dangling_reference","identifier":"\u003cstring>","referenceType":"block","missingId":"\u003cstring>","firstUsedAt":"\u003cstring>","conflictsWith":"\u003cstring>"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"6f56f1ae-2598-4c5b-a39a-294218fba096":{"description":"Internal Server Error.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Request correlation ID"},"Cache-Control":{"schema":{"type":"string"},"example":"private, no-store"}},"content":{"application/problem+json":{"schema":{"type":"object","description":"RFC 9457 Problem Details for HTTP APIs (`application/problem+json`). Responses typically include a machine-readable `code` field alongside `title`, `status`, `detail`, and `requestId`.\n\nBranch on `code`, not on `detail` or `title`: `code` is stable and locale-independent, whereas `detail` is prose that may be reworded. No problem sets `type`, so per RFC 9457 §4.2.1 `title` is always the HTTP reason phrase for `status` and carries no information of its own.\n\nMember naming is frozen as published, mixed conventions included (`requestId` alongside `invalid_params` and `details.resource_type`): renaming any of them would break every client that reads them.","required":["title","status","detail","requestId"],"properties":{"title":{"type":"string","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"status":{"type":"integer","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"detail":{"type":"string","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"requestId":{"type":"string","isRequired":true,"uniqueKey":"requestId","typeLabel":"string"},"type":{"type":"string","format":"uri","uniqueKey":"type","typeLabel":"string\u003curi>"},"instance":{"type":"string","uniqueKey":"instance","typeLabel":"string"},"code":{"type":"string","enum":["ai_features_not_enabled","ai_generated_payload_invalid","ai_instance_not_configured","ai_output_too_long","ai_provider_auth_failed","ai_smart_tools_disabled","bad_gateway","bad_request","chart_in_use","conflict","creatives_not_entitled","custom_css_plan_required","dashboards_plan_required","forbidden","internal_server_error","invalid_workflow_state","not_authenticated","not_found","payload_too_large","projection_pending","service_unavailable","stored_survey_invalid","survey_has_linked_creatives","survey_not_workspace_visible","too_many_requests","unprocessable_content","visibility_blocked_by_connections","visibility_change_not_allowed","visibility_not_enabled","workflow_not_executable","workspace_survey_limit_reached"],"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"details":{"type":"object","uniqueKey":"details","typeLabel":"object"},"invalid_params":{"type":"array","items":{"type":"object","description":"Field-level validation error. `name` and `reason` are always intended for humans.\nOptional machine-readable fields are included when the API can identify the semantic error,\nespecially for survey locale, identifier, and reference validation used by MCP and agent clients.\n","required":["name","reason"],"properties":{"name":{"type":"string","description":"Dot-path to the invalid request field.","isRequired":true,"uniqueKey":"invalid_params.items.[INDEX].name","typeLabel":"string"},"reason":{"type":"string","description":"Human-readable repair guidance.","isRequired":true,"uniqueKey":"invalid_params.items.[INDEX].reason","typeLabel":"string"},"code":{"type":"string","enum":["dangling_reference","document_limit_exceeded","duplicate_identifier","duplicate_locale","file_limit_exceeded","file_type_unsupported","file_unreadable","forbidden_identifier","immutable_answer_code","immutable_identifier","immutable_option_deletion","immutable_option_text","immutable_question_code","immutable_question_type","invalid_locale","invalid_reference","limit_exceeded","missing_required_field","misordered_reference","missing_translation","qsf_limit_exceeded","qsf_not_recognized","read_only_field","unsupported_field","unsupported_locale"],"description":"Machine-readable validation category, when available.\n\nThis is the shared error shape every v3 operation returns, so it lists what the API can emit today and nothing more — `INVALID_PARAM_CODES` in `app/api/v3/lib/response.ts` is the registry, and a code absent from it is dropped before the response is built. Categories for operations that do not exist yet are added with the code that emits them, not ahead of it.\n\n`immutable_question_code`, `immutable_answer_code`, `immutable_question_type`, `immutable_option_text` and `immutable_option_deletion` come from the published-survey lock: once a survey has left `draft` (`inProgress`, `paused` or `completed`; a scheduled survey is `paused`), question codes, answer codes, question types and option text in every language are locked, and an option, matrix row or matrix column that existed when the survey was published cannot be deleted. `name` points at the offending field (at the option list for a deletion) and `identifier` is the option id, or the element id when the option is not the subject. Adding questions and options is still allowed.\n\n`limit_exceeded`: the field is well formed but past a limit the operation states, which `reason` names together with what to change. Chart queries use it for a date range that spans more time buckets than its granularity allows.\n\n`qsf_not_recognized` and `qsf_limit_exceeded` come from the Qualtrics import (an internal, session-only route sharing this shape): the file is not a Qualtrics export it can read, or it is one past an import limit, which `identifier` names.\n\n`file_type_unsupported`, `file_limit_exceeded` and `file_unreadable` come from the survey import too, about the uploaded file whatever its type: the import does not read this kind of file (`identifier` names what it recognized, if anything), the file is past an upload limit, which `identifier` names, or it is broken. A JSON file that does not parse has `identifier` `json_syntax`, and the problem's `details` give the `line` and `column` where it stops, when the parser says.\n\n`document_limit_exceeded` comes from the survey import of a questionnaire (Word, Excel or CSV): the document is past one of the import's limits, which `identifier` names.\n","uniqueKey":"invalid_params.items.[INDEX].code","typeLabel":"enum\u003cstring>"},"identifier":{"type":"string","description":"Identifier involved in the validation failure, when available. For language errors, this can be the normalized language code.","uniqueKey":"invalid_params.items.[INDEX].identifier","typeLabel":"string"},"referenceType":{"type":"string","enum":["block","element","ending","hiddenField","language","variable","variableName","recall"],"description":"Identifier namespace involved in the validation failure. Same rule as `code`: these are the namespaces the API emits today, and more arrive with the operations that emit them.","uniqueKey":"invalid_params.items.[INDEX].referenceType","typeLabel":"enum\u003cstring>"},"missingId":{"type":"string","description":"Referenced id that does not exist in the submitted survey document.","uniqueKey":"invalid_params.items.[INDEX].missingId","typeLabel":"string"},"firstUsedAt":{"type":"string","description":"Dot-path where a duplicate identifier was first used.","uniqueKey":"invalid_params.items.[INDEX].firstUsedAt","typeLabel":"string"},"conflictsWith":{"type":"string","description":"Dot-path to the existing identifier that conflicts with this field.","uniqueKey":"invalid_params.items.[INDEX].conflictsWith","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"invalid_params.items.[INDEX]","typeLabel":"object"},"uniqueKey":"invalid_params","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"title":"\u003cstring>","status":123,"detail":"\u003cstring>","requestId":"\u003cstring>","type":"\u003cstring>","instance":"\u003cstring>","code":"ai_features_not_enabled","details":{},"invalid_params":[{"name":"\u003cstring>","reason":"\u003cstring>","code":"dangling_reference","identifier":"\u003cstring>","referenceType":"block","missingId":"\u003cstring>","firstUsedAt":"\u003cstring>","conflictsWith":"\u003cstring>"}]}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"d2f12a3d-fdbd-43ab-8776-626a3b0dee11":{"sessionAuth":{"type":"apiKey","in":"cookie","name":"next-auth.session-token","description":"NextAuth session JWT cookie. **Development:** often `next-auth.session-token`.\n**Production (HTTPS):** often `__Secure-next-auth.session-token`. Send the cookie your browser receives after sign-in.\n","scopes":[],"schemeName":"sessionAuth"}},"af2d6811-bc93-4593-b882-e0ca1d4851cc":{"apiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","description":"Management API key; must include **workspaceId** as an allowed workspace with read, write, or manage permission.\n","scopes":[],"schemeName":"apiKeyAuth"}},"21ee008f-a86c-4994-8cac-f4558956651e":{"bearerAuth":{"type":"http","scheme":"bearer","description":"The same management API key, presented as `Authorization: Bearer \u003ckey>` instead of `x-api-key`. Equivalent in every way — same key, same workspace permissions — and offered because it is what most HTTP clients and SDK generators reach for by default.\nA **401** from any operation that accepts it carries `WWW-Authenticate: Bearer realm=\"formbricks\"`. Session-only operations accept neither this nor `x-api-key`.\n","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"bd5c2733-e216-4c58-8da0-ee079ace60b2":{"url":"https://app.formbricks.com","description":"Formbricks Cloud. Paths in this spec already include the `/api/v3` prefix; self-hosted instances substitute their own origin."}},"schemas":{"05361453-d19c-419d-9183-f17ee4b34306":{"oneOf":[{"type":"object","description":"One node of a Set value expression: a fixed value, a reference, or a function call.\n\n**Leaves.** `static` is a number or text (a text `2026-03-01` counts as a date where one is expected). `element` is an answer, by element id: rating, NPS, CSAT, CES and number open text are numbers; other open text is text; a date question is a date; a single select yields its answer code as text. Other question types can't be used. `variable` is a computed field and `hiddenField` an ingested field, by storage key, typed by their `dataType`; `reserved` is a reserved field by name.\n\n**Functions** (`call`): `add`, `multiply`, `min`, `max` take 2–50 numbers; `subtract` and `divide` exactly 2 (÷ 0 gives empty); `round` a number and optional fixed decimals (0–10, rounding half away from zero); `abs` 1 number; `ifEmpty` a value and a fallback of the same type; `concat` 2–50 values of any type (numbers and dates become text); `now` none (the device clock as a UTC ISO timestamp); `daysBetween` 2 dates (UTC calendar days from the first to the second, negative allowed).\n\n**Empty values.** An unanswered question or unset field is empty, and so is a value that isn't a number where a number is needed; every function except `ifEmpty` then gives empty.\n","required":["type","value"],"properties":{"type":{"type":"string","enum":["static"],"isRequired":true},"value":{"oneOf":[{"type":"number","isRequired":true},{"type":"string","maxLength":5000,"isRequired":true}],"isRequired":true}},"additionalProperties":false},{"type":"object","description":"One node of a Set value expression: a fixed value, a reference, or a function call.\n\n**Leaves.** `static` is a number or text (a text `2026-03-01` counts as a date where one is expected). `element` is an answer, by element id: rating, NPS, CSAT, CES and number open text are numbers; other open text is text; a date question is a date; a single select yields its answer code as text. Other question types can't be used. `variable` is a computed field and `hiddenField` an ingested field, by storage key, typed by their `dataType`; `reserved` is a reserved field by name.\n\n**Functions** (`call`): `add`, `multiply`, `min`, `max` take 2–50 numbers; `subtract` and `divide` exactly 2 (÷ 0 gives empty); `round` a number and optional fixed decimals (0–10, rounding half away from zero); `abs` 1 number; `ifEmpty` a value and a fallback of the same type; `concat` 2–50 values of any type (numbers and dates become text); `now` none (the device clock as a UTC ISO timestamp); `daysBetween` 2 dates (UTC calendar days from the first to the second, negative allowed).\n\n**Empty values.** An unanswered question or unset field is empty, and so is a value that isn't a number where a number is needed; every function except `ifEmpty` then gives empty.\n","required":["type","value"],"properties":{"type":{"type":"string","enum":["element","variable","hiddenField","reserved"],"isRequired":true},"value":{"type":"string","description":"Element id, variable id, hidden field id, or — for `reserved` — the name of an Embedded Data field-catalog entry (`country`, `deviceType`, `utmSource`, …). Reserved names are checked for non-emptiness only, deliberately not against the catalog, so a survey authored against a newer catalog still parses on an older self-hosted deployment.","isRequired":true},"meta":{"type":"object","description":"On a matrix row condition: `row`, the 0-based position of the row, and `rowId`, its id. The id is read first and wins when the two disagree, so the condition survives reordering; it must be a row of the matrix. Either may be sent alone: the other is filled in on write. Positions stay for the previous release, which reads them only.","additionalProperties":{"type":"string"}}},"additionalProperties":false},{"type":"object","description":"One node of a Set value expression: a fixed value, a reference, or a function call.\n\n**Leaves.** `static` is a number or text (a text `2026-03-01` counts as a date where one is expected). `element` is an answer, by element id: rating, NPS, CSAT, CES and number open text are numbers; other open text is text; a date question is a date; a single select yields its answer code as text. Other question types can't be used. `variable` is a computed field and `hiddenField` an ingested field, by storage key, typed by their `dataType`; `reserved` is a reserved field by name.\n\n**Functions** (`call`): `add`, `multiply`, `min`, `max` take 2–50 numbers; `subtract` and `divide` exactly 2 (÷ 0 gives empty); `round` a number and optional fixed decimals (0–10, rounding half away from zero); `abs` 1 number; `ifEmpty` a value and a fallback of the same type; `concat` 2–50 values of any type (numbers and dates become text); `now` none (the device clock as a UTC ISO timestamp); `daysBetween` 2 dates (UTC calendar days from the first to the second, negative allowed).\n\n**Empty values.** An unanswered question or unset field is empty, and so is a value that isn't a number where a number is needed; every function except `ifEmpty` then gives empty.\n","required":["type","fn","args"],"properties":{"type":{"type":"string","enum":["call"],"isRequired":true},"fn":{"type":"string","enum":["add","subtract","multiply","divide","round","min","max","abs","ifEmpty","concat","now","daysBetween"],"isRequired":true},"args":{"type":"array","maxItems":50,"items":{"$circularRef":"05361453-d19c-419d-9183-f17ee4b34306"},"isRequired":true}},"additionalProperties":false}]}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"cookie","name":"next-auth.session-token","description":"NextAuth session JWT cookie. **Development:** often `next-auth.session-token`.\n**Production (HTTPS):** often `__Secure-next-auth.session-token`. Send the cookie your browser receives after sign-in.\n","scopes":[],"schemeName":"sessionAuth"},"schema":{"title":"next-auth.session-token","type":"string","description":"NextAuth session JWT cookie. **Development:** often `next-auth.session-token`.\n**Production (HTTPS):** often `__Secure-next-auth.session-token`. Send the cookie your browser receives after sign-in.\n","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"sessionAuth","name":"next-auth.session-token"}],"title":"sessionAuth"},{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"x-api-key","description":"Management API key; must include **workspaceId** as an allowed workspace with read, write, or manage permission.\n","scopes":[],"schemeName":"apiKeyAuth"},"schema":{"title":"x-api-key","type":"string","description":"Management API key; must include **workspaceId** as an allowed workspace with read, write, or manage permission.\n","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"apiKeyAuth","name":"x-api-key"}],"title":"apiKeyAuth"},{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"The same management API key, presented as `Authorization: Bearer \u003ckey>` instead of `x-api-key`. Equivalent in every way — same key, same workspace permissions — and offered because it is what most HTTP clients and SDK generators reach for by default.\nA **401** from any operation that accepts it carries `WWW-Authenticate: Bearer realm=\"formbricks\"`. Session-only operations accept neither this nor `x-api-key`.\n","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"The same management API key, presented as `Authorization: Bearer \u003ckey>` instead of `x-api-key`. Equivalent in every way — same key, same workspace permissions — and offered because it is what most HTTP clients and SDK generators reach for by default.\nA **401** from any operation that accepts it carries `WWW-Authenticate: Bearer realm=\"formbricks\"`. Session-only operations accept neither this nor `x-api-key`.\n","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"api-v3-reference/openapi.yml"},"subdomain":"formbricks","siteName":"Documentation - Formbricks","title":"Edit survey blocks - Documentation - Formbricks","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-15T13:34:19.840Z","originalFileLocation":"api-v3-reference/v3-surveys/edit-survey-blocks.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Edits a survey\u0026#x27;s blocks in place — update, insert or remove whole blocks without resending the ones you are not changing. Operations apply in order against a single snapshot and are applied atomically: either all of them land or none do. Blocks are addressed by id, never by position, so a concurrent edit cannot silently redirect an operation onto a different block. An update replaces the target block entirely, the same whole-subtree rule PATCH /api/v3/surveys/{surveyId} uses, and the replacement must carry every language the survey has configured. Pass expectedUpdatedAt (the updatedAt from your last read) to make the write conditional; see the 409 response. Session cookie or x-api-key.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Documentation - Formbricks\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003cmeta data-mint-head name=\"robots\" content=\"noindex\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/formbricks/GlZ4IqkvkQlhFmAc/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/docs/mintlify-assets/_mintlify/favicons/formbricks/GlZ4IqkvkQlhFmAc/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/formbricks/GlZ4IqkvkQlhFmAc/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/formbricks/GlZ4IqkvkQlhFmAc/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/formbricks/GlZ4IqkvkQlhFmAc/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/formbricks/GlZ4IqkvkQlhFmAc/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/formbricks/GlZ4IqkvkQlhFmAc/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/formbricks/GlZ4IqkvkQlhFmAc/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/formbricks/GlZ4IqkvkQlhFmAc/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Edit survey blocks - Documentation - Formbricks\">\u003cmeta data-mint-head property=\"og:description\" content=\"Edits a survey\u0026#x27;s blocks in place — update, insert or remove whole blocks without resending the ones you are not changing. Operations apply in order against a single snapshot and are applied atomically: either all of them land or none do. Blocks are addressed by id, never by position, so a concurrent edit cannot silently redirect an operation onto a different block. An update replaces the target block entirely, the same whole-subtree rule PATCH /api/v3/surveys/{surveyId} uses, and the replacement must carry every language the survey has configured. Pass expectedUpdatedAt (the updatedAt from your last read) to make the write conditional; see the 409 response. Session cookie or x-api-key.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Documentation - Formbricks\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://formbricks.com/docs/api-v3-reference/v3-surveys/edit-survey-blocks\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://formbricks.mintlify.site/docs/_mintlify/api/og/v2?division=V3+Surveys\u0026amp;title=Edit+survey+blocks\u0026amp;description=Edits+a+survey%27s+blocks+in+place+%E2%80%94+update%2C+insert+or+remove+whole+blocks+without+resending+the+ones+you+are+not+changing.+Operations+apply+in+order+against+a+si\u0026amp;theme=ad31bfbf4dbc0f4212be5b08\u0026amp;signature=393f5cd1ae8f7f74d92558a0a744db7c5d7131cac798eda0b5cf8651554858f4\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Edit survey blocks - Documentation - Formbricks\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Edits a survey\u0026#x27;s blocks in place — update, insert or remove whole blocks without resending the ones you are not changing. Operations apply in order against a single snapshot and are applied atomically: either all of them land or none do. Blocks are addressed by id, never by position, so a concurrent edit cannot silently redirect an operation onto a different block. An update replaces the target block entirely, the same whole-subtree rule PATCH /api/v3/surveys/{surveyId} uses, and the replacement must carry every language the survey has configured. Pass expectedUpdatedAt (the updatedAt from your last read) to make the write conditional; see the 409 response. Session cookie or x-api-key.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://formbricks.mintlify.site/docs/_mintlify/api/og/v2?division=V3+Surveys\u0026amp;title=Edit+survey+blocks\u0026amp;description=Edits+a+survey%27s+blocks+in+place+%E2%80%94+update%2C+insert+or+remove+whole+blocks+without+resending+the+ones+you+are+not+changing.+Operations+apply+in+order+against+a+si\u0026amp;theme=ad31bfbf4dbc0f4212be5b08\u0026amp;signature=393f5cd1ae8f7f74d92558a0a744db7c5d7131cac798eda0b5cf8651554858f4\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/docs/mintlify-assets/_mintlify/favicons/formbricks/GlZ4IqkvkQlhFmAc/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Documentation - Formbricks\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#00C4B8\">\u003clink data-mint-head rel=\"canonical\" href=\"https://formbricks.com/docs/api-v3-reference/v3-surveys/edit-survey-blocks\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/api-v3-reference/v3-surveys/edit-survey-blocks.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://formbricks.com/#organization\",\"name\":\"Documentation - Formbricks\",\"url\":\"https://formbricks.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/formbricks/wqEbm3FT1QK_6-vL/images/logo-light.svg?fit=max\u0026auto=format\u0026n=wqEbm3FT1QK_6-vL\u0026q=85\u0026s=365e5fb767b72b4fbbb2016860fd92ba\"}},{\"@type\":\"WebSite\",\"@id\":\"https://formbricks.com/docs#website\",\"name\":\"Documentation - Formbricks\",\"url\":\"https://formbricks.com/docs\",\"publisher\":{\"@id\":\"https://formbricks.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://formbricks.com/docs/api-v3-reference/v3-surveys/edit-survey-blocks#webpage\",\"url\":\"https://formbricks.com/docs/api-v3-reference/v3-surveys/edit-survey-blocks\",\"name\":\"Edit survey blocks\",\"description\":\"Edits a survey's blocks in place — update, insert or remove whole blocks without resending the ones you are not changing. Operations apply in order against a single snapshot and are applied atomically: either all of them land or none do. Blocks are addressed by id, never by position, so a concurrent edit cannot silently redirect an operation onto a different block. An update replaces the target block entirely, the same whole-subtree rule PATCH /api/v3/surveys/{surveyId} uses, and the replacement must carry every language the survey has configured. Pass expectedUpdatedAt (the updatedAt from your last read) to make the write conditional; see the 409 response. Session cookie or x-api-key.\",\"dateModified\":\"2026-11-15T13:34:19.840Z\",\"isPartOf\":{\"@id\":\"https://formbricks.com/docs#website\"},\"breadcrumb\":{\"@id\":\"https://formbricks.com/docs/api-v3-reference/v3-surveys/edit-survey-blocks#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://formbricks.com/docs/api-v3-reference/v3-surveys/edit-survey-blocks#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"V3 Surveys\",\"item\":\"https://formbricks.com/docs/api-v3-reference/v3-surveys/list-surveys\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Edit survey blocks\",\"item\":\"https://formbricks.com/docs/api-v3-reference/v3-surveys/edit-survey-blocks\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://formbricks.com/docs/api-v3-reference/v3-surveys/edit-survey-blocks#apireference\",\"headline\":\"Edit survey blocks\",\"name\":\"Edit survey blocks\",\"description\":\"Edits a survey's blocks in place — update, insert or remove whole blocks without resending the ones you are not changing. Operations apply in order against a single snapshot and are applied atomically: either all of them land or none do. Blocks are addressed by id, never by position, so a concurrent edit cannot silently redirect an operation onto a different block. An update replaces the target block entirely, the same whole-subtree rule PATCH /api/v3/surveys/{surveyId} uses, and the replacement must carry every language the survey has configured. Pass expectedUpdatedAt (the updatedAt from your last read) to make the write conditional; see the 409 response. Session cookie or x-api-key.\",\"url\":\"https://formbricks.com/docs/api-v3-reference/v3-surveys/edit-survey-blocks\",\"mainEntityOfPage\":{\"@id\":\"https://formbricks.com/docs/api-v3-reference/v3-surveys/edit-survey-blocks#webpage\"},\"dateModified\":\"2026-11-15T13:34:19.840Z\",\"publisher\":{\"@id\":\"https://formbricks.com/#organization\"},\"isPartOf\":{\"@id\":\"https://formbricks.com/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Documentation - Formbricks\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Documentation - Formbricks\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/api-v3-reference/v3-surveys/edit-survey-blocks.md","siteName":"Documentation - Formbricks","nav":{"global":null,"tabs":[{"tab":"Platform","pages":[{"title":"Platform","href":"/platform/introduction"}]},{"tab":"Surveys (Ask)","pages":[{"title":"Surveys (Ask)","href":"/surveys/overview"}]},{"tab":"Unify Feedback (Analyze)","pages":[{"title":"Unify Feedback (Analyze)","href":"/unify-feedback/overview"}]},{"tab":"Workflows (Act)","pages":[{"title":"Workflows (Act)","href":"/workflows/overview"}]},{"tab":"Self Hosting","pages":[{"title":"Self Hosting","href":"/self-hosting/overview"}]},{"tab":"Development","pages":[{"title":"Development","href":"/development/overview"}]},{"tab":"Integrate","pages":[{"title":"Integrate","href":"/integrate/overview"}]},{"tab":"API v1 Reference","pages":[{"title":"API v1 Reference","href":"/api-reference/rest-api"}]},{"tab":"API v2 Reference (Beta)","pages":[{"title":"API v2 Reference (Beta)","href":"/api-v2-reference/introduction"}]},{"tab":"API v3 Reference (Private Beta)","hidden":true,"groups":[{"group":"API v3 Documentation (Private Beta)","pages":[{"title":"API v3 Reference (Private Beta)","description":"The next generation of the Formbricks management API, including the Feedback Records API","icon":"code-compare","href":"/api-v3-reference/introduction"}]},{"group":"V3 Surveys","pages":[{"title":"List surveys","description":"Returns the surveys in the workspace **that the caller may read**. A restricted survey is listed only\nto its owner and to the organisation's owners and managers; to everyone else, API keys included, it\ndoes not exist here. `meta.totalCount` and `meta.workspaceSurveyCount` count that same readable set,\nso neither number reveals a restricted survey to someone who cannot see it. The visibility predicate\nis applied in the query and the cursor, never after the fact: `limit` keeps its meaning and\n`meta.nextCursor` being `null` remains the only end-of-collection signal.\n\n`view=full` returns each survey's whole document alongside its summary fields, so an export does not\nneed one `GET /api/v3/surveys/{surveyId}` per survey. Pages are not snapshots: a survey created or\ndeleted while you page may be missed or skipped, so a full extraction should page with\n`sortBy=createdAt` and reconcile on a later run.\n\nSession cookie, `x-api-key`, or a Bearer token.\n","deprecated":null,"version":null,"openapi":"/api-v3-reference/openapi.yml get /api/v3/surveys","href":"/api-v3-reference/v3-surveys/list-surveys"},{"title":"Create a survey","description":"Creates a block-based survey template from one strict survey document. The endpoint accepts\nmultilingual authoring maps keyed by real locale codes and converts them to Formbricks'\ninternal default-language representation. Non-default locale keys in translated content\nmust be declared in `languages`; undeclared locale keys return `unsupported_locale` in\n`invalid_params` instead of silently mutating workspace languages.\n\n`blocks[].id` and `variables[].id` are stable public identifiers. They may be omitted on\ncreate, in which case the server generates cuid2 ids. If the same create request needs to\nreference a block or variable from logic, provide explicit valid ids and use those references\nconsistently.\n\nFor normal sequential surveys, omit `logic` and `logicFallback`. `logicFallback` is only valid\nwhen the same block has at least one `logic` rule; otherwise the API returns\n`invalid_reference`.\n\n`type` may be omitted or set to `link` or `app`. App surveys additionally accept the `distribution` (display options + triggers) and `targeting` (contact segment filters) objects; both are rejected for link surveys. Trigger ids must reference existing workspace action classes (discover them via `GET /api/v3/action-classes`), and `targeting.filters` references (contact-attribute keys and segments) must exist in the workspace. Unsupported fields are rejected instead of ignored.\n","deprecated":null,"version":null,"openapi":"/api-v3-reference/openapi.yml post /api/v3/surveys","href":"/api-v3-reference/v3-surveys/create-a-survey"},{"title":"Create a survey draft payload with AI","description":"Creates a strict v3 `POST /api/v3/surveys` create payload from a creator prompt and returns\nvalidation metadata. This endpoint is single-purpose: it does **not** persist the survey.\nClients should validate the returned payload with `/api/v3/surveys/validate` or use the\nembedded validation metadata, then create the draft through `POST /api/v3/surveys`.\n\nThe generated payload always sets `status: draft`. Both `type: link` and `type: app` are\nsupported; for `app`, the payload includes a default `distribution` (display once, no triggers,\nno targeting) that you finish configuring in the editor or via the create request.\n\nPrompt privacy: prompt text is sent to the configured AI provider to create the payload, but\nthis endpoint does not store prompts and server logs should use request ids and failure\ncategories instead of raw prompt content.\n","deprecated":null,"version":null,"openapi":"/api-v3-reference/openapi.yml post /api/v3/surveys/generate","href":"/api-v3-reference/v3-surveys/create-a-survey-draft-payload-with-ai"},{"title":"Validate a survey document","description":"Validates a future create or patch survey payload without writing data, creating languages,\nor creating survey versions. Invalid survey documents return `200` with `data.valid=false`\nso agents and MCP clients can repair payloads from structured `invalid_params`.\n\nUse `400` only for malformed validation envelopes, unsupported operations, invalid `surveyId`,\nor unsupported query parameters.\n\n**Custom CSS.** A create or patch payload that carries `customCss` is also run through the custom CSS processor; the result adds the compiled `customCss` and `warnings`, or `errors` and `valid=false`. `operation: customCss` validates CSS alone for a live preview — with `scope: workspace | survey` and, optionally, an existing `surveyId` in `workspaceId`, or a `creativeType` for a creative's own CSS — and returns the compiled CSS and warnings. Validation never saves, versions, touches timestamps or invalidates caches, needs only read access, and grants nothing: the write itself checks permissions and the plan again. Requests that process custom CSS also count against a separate budget of 60 per minute per user or API key, shared with the workspace custom CSS endpoint, with survey creates and updates that add or edit custom CSS, and with the MCP tools; beyond it they return **429**.\n","deprecated":null,"version":null,"openapi":"/api-v3-reference/openapi.yml post /api/v3/surveys/validate","href":"/api-v3-reference/v3-surveys/validate-a-survey-document"},{"title":"Retrieve a survey","description":"Returns the public v3 survey management resource for one survey. By default, translatable\nfields are returned as stable multilingual maps keyed by the language codes emitted in\n`languages[].code`. Use `lang` to filter those maps to one or more requested language selectors.\n","deprecated":null,"version":null,"openapi":"/api-v3-reference/openapi.yml get /api/v3/surveys/{surveyId}","href":"/api-v3-reference/v3-surveys/retrieve-a-survey"},{"title":"Delete a survey","description":"Deletes a survey by id. Session cookie, `x-api-key`, or a Bearer token.\n\nRefused with **409** (`survey_has_linked_creatives`) while non-archived creatives open the survey; `details.creatives` names them. Archived creatives don't block the delete: they are unlinked with it, and each unlink is audited as an update of that creative.\n","deprecated":null,"version":null,"openapi":"/api-v3-reference/openapi.yml delete /api/v3/surveys/{surveyId}","href":"/api-v3-reference/v3-surveys/delete-a-survey"},{"title":"Update a survey","description":"Updates a survey through a strict top-level partial document. Omitted top-level fields are\npreserved. Provided top-level objects and arrays replace that whole subtree; this endpoint\ndoes not deep-merge nested objects and does not implement JSON Patch.\n\nThis write endpoint accepts the canonical multilingual authoring document only. Translatable\nfields must be locale-code maps, not strings. `PATCH ?lang=...` and `?version=...` are not\nsupported in Scope 1.\n\nFor MCP and AI-agent workflows, fetch the current survey first, modify only the intended\ntop-level fields, call `/api/v3/surveys/validate` with `operation: patch` for preflight, then\nsubmit the same patch here. Missing ids in replaced arrays are treated as deletions. Variable\nname renames are allowed but may be destructive for downstream exports or integrations.\nElement id changes are rejected once the survey and element are no longer drafts.\n\nServer-owned fields that `GET` returns (`id`, `workspaceId`, `type`, `createdAt`, `archivedAt`, `defaultLanguage`, `languages[].alias`) are accepted and verified, so the output of a `GET` can be sent straight back. Echoing the value you were given is a no-op; changing one is a **422** `read_only_field`.\n\nA round-tripped `updatedAt` acts as an optimistic-concurrency precondition: the write is applied only if the survey has not changed since your read, and is otherwise rejected with **409**. Omit it and overlapping writes remain last-write-wins. Header-based preconditions (`ETag` / `If-Match`) are still future work.\n","deprecated":null,"version":null,"openapi":"/api-v3-reference/openapi.yml patch /api/v3/surveys/{surveyId}","href":"/api-v3-reference/v3-surveys/update-a-survey"},{"title":"Edit survey blocks","deprecated":null,"version":null,"openapi":"/api-v3-reference/openapi.yml patch /api/v3/surveys/{surveyId}/blocks","href":"/api-v3-reference/v3-surveys/edit-survey-blocks"},{"title":"Set survey block order","description":"Replaces the order of a survey's blocks. The body lists every current block id exactly once, in the order you want; block content is untouched.\n\nIdempotent: the same `order` always yields the same survey, and an order that already matches performs no write at all, so `updatedAt` does not move and other callers' preconditions stay valid. A stale `expectedUpdatedAt` is still rejected with **409** on that path — the precondition is evaluated before the method, so a no-op outcome never reports success to a stale caller. Because the list must be a permutation, a dropped or duplicated block is rejected rather than silently applied — the failure mode that resending the whole `blocks` array cannot catch.\n\nPass `expectedUpdatedAt` (the `updatedAt` from your last read) to make the write conditional; see the **409** response. Session cookie or x-api-key.\n","deprecated":null,"version":null,"openapi":"/api-v3-reference/openapi.yml put /api/v3/surveys/{surveyId}/blocks/order","href":"/api-v3-reference/v3-surveys/set-survey-block-order"},{"title":"Archive a survey","description":"Archives (soft-deletes) a survey by id. Archived surveys are hidden from the default list, stop collecting responses, and become read-only until restored — a subsequent `PATCH` returns **422**. Works on any survey, including legacy question-based surveys, so this endpoint returns a minimal lifecycle acknowledgement rather than the full survey resource. Session cookie, `x-api-key`, or a Bearer token.\n","deprecated":null,"version":null,"openapi":"/api-v3-reference/openapi.yml post /api/v3/surveys/{surveyId}/archive","href":"/api-v3-reference/v3-surveys/archive-a-survey"},{"title":"Restore a survey","description":"Restores a previously archived (soft-deleted) survey by id, clearing its archive marker so it reappears in the default list and becomes editable again. Works on any survey, including legacy question-based surveys, so this endpoint returns a minimal lifecycle acknowledgement rather than the full survey resource. Session cookie, `x-api-key`, or a Bearer token.\n","deprecated":null,"version":null,"openapi":"/api-v3-reference/openapi.yml post /api/v3/surveys/{surveyId}/restore","href":"/api-v3-reference/v3-surveys/restore-a-survey"},{"title":"Read a survey's visibility and the impact of changing it","description":"Returns the survey's enforced visibility, its owner, the caller's access, and what a change would do: `blockers[]` lists the outbound connections that currently make `restricted` refusable (webhooks, integrations, active feedback sources, draft or enabled workflows, and non-archived creatives that open it), `impact` carries the numbers the confirmation dialogues show, `allowedTargets[]` the values a `POST` would act on right now, and `pending` / `version` describe a change still in flight. Read this before offering \"Make restricted\"; the `POST` answers **409** while `blockers[]` is non-empty.\n\nRequires `survey.change_visibility`, the same permission as the `POST`: the survey's owner while they still hold read access to the workspace, or an organisation owner/manager, with the feature enabled. Everyone else — read or write members, team-level managers, every API key, and anyone who cannot see the survey at all — answers **403** with the same body as an unknown id. Connection names and ids are configuration, not survey content, and only the people who may act on them get to read them.\n\nWhile `pending` is non-null the survey is restricted for everyone but its owner (within their workspace access: read to view, write to edit) and the organisation's owners and managers, whichever direction is queued — the application fails closed until the graph acknowledges the change — so `visibility` reads `restricted` in that state and `allowedTargets` includes the value that cancels the pending change.\n","deprecated":null,"version":null,"openapi":"/api-v3-reference/openapi.yml get /api/v3/surveys/{surveyId}/visibility","href":"/api-v3-reference/v3-surveys/read-a-surveys-visibility-and-the-impact-of-changing-it"},{"title":"Change a survey's visibility","description":"Sets the survey to `restricted` or `workspace`.\n\n**Restrictions take effect at once.** A `workspace → restricted` request stores the flag, a new `version` and a pending marker in one transaction. From that instant the survey is restricted on every path — single reads, lists and counts, responses, exports — for everyone but the owner and the organisation's owners and managers, whether or not the graph has caught up (fail closed). The owner keeps only the access their workspace role gives them — read to view, write to edit; an owner who loses workspace access loses the survey too. The relationships are then projected; the answer is **200** either way, with `pending: null` when the graph acknowledged this `version` inside the request and `pending: \"restricted\"` when the outbox will finish it.\n\n**Grants take effect when enforced.** A `restricted → workspace` request answers **200** only once the graph has acknowledged this exact `version`; until then the survey stays restricted. If the in-request projection fails, the answer is **503** `projection_pending`: the change is stored and queued, `GET …/visibility` shows `pending: \"workspace\"`, and retrying is safe.\n\n**Fencing.** Every accepted change increments the survey's `version`. Projection work carries the version it was issued for, and a projector holding an older version never writes, so a worker leased before a newer change cannot overtake it — including one that crashed before its verification pass. A **200** for a grant means the graph holds this exact version.\n\n**No-ops and cancellation.** Requesting the value the survey already enforces, with nothing pending, is a **200** no-op: nothing is written or audited and `changedAt` / `changedBy` are unchanged. Requesting the enforced value while the *opposite* is pending **cancels** the pending change: a new version is stored, the queued work is superseded, and the answer is **200** with `pending: null`. Requesting the pending value again re-attempts the projection (200 or 503).\n\nWhen `restricted` is refused for two reasons at once — no owner **and** outbound connections — the **422** wins: the missing owner cannot be fixed, so listing connections to remove would send the caller down a dead end.\n\nAllowed for the survey's owner (while they still hold read access to the workspace) and for the organisation's owners and managers. **Not** for workspace members with write or team-level manage rights, and never for API keys. Every successful change is audit-logged with the actor.\n\nGoing `workspace → restricted` is refused with **409** while any outbound connection depends on the survey; resolve them first. Archived creatives don't block it: a restriction unlinks them (each unlink is audited as an update of that creative), so restoring one later needs a new Destination. It is refused with **422** when the survey has no owner, because \"restricted\" would then mean \"administrators only\" — duplicate the survey for a restricted copy. Going `restricted → workspace` has no preconditions.\n\nThis is the only way to change visibility: `PATCH /api/v3/surveys/{surveyId}` accepts `visibility`, `owner` and `access` only as the exact values `GET` returned (so a fetched survey round-trips), and rejects any other value as an unsupported field. Publishing does not change visibility; the publish dialogue chains this call before the status change.\n","deprecated":null,"version":null,"openapi":"/api-v3-reference/openapi.yml post /api/v3/surveys/{surveyId}/visibility","href":"/api-v3-reference/v3-surveys/change-a-surveys-visibility"}]},{"group":"V3 Responses","pages":[{"title":"List responses","description":"Returns responses for a workspace, newest first. Session cookie, `x-api-key`, or a Bearer token, with read access.\n\n**Scoping.** `workspaceId` is required, as on every v3 collection read. Add `surveyId` to narrow to one survey — the common case, and the one the storage layer is indexed for (`(surveyId, createdAt)`). A workspace-wide list has to reach responses through their surveys and is correspondingly slower, so pass `surveyId` whenever you know it. `contactId` narrows to one respondent.\n\n**Pagination is keyset**, on `(createdAt, id)`. The `cursor` is opaque and bound to the sort order and the filter set it was issued for; changing either invalidates it. `meta.nextCursor` being `null` is the only end-of-collection signal — do not infer the end from a short page.\n\n`id` is there purely as a tie-breaker, and it makes the order **total**, so no row is ever skipped or repeated across pages. What it is not is a finer-grained clock: `createdAt` is stored to millisecond precision, so responses sharing a millisecond — everything written in one bulk insert, for instance — come back in an order that is stable and repeatable but is not their true creation order. Do not read the sequence within a millisecond as meaningful.\n\n**Filters are allow-listed**, and each one on its own is either served by an index or bounded by one. `filter[finished][eq]` and `filter[language][in]` additionally require `surveyId` or `contactId`, because both are heap residuals that are only bounded when the scan is anchored to one survey or one contact; sending either without such a scope returns **400**.\n\nBe aware that **combining** a `filter[createdAt]` bound with `filter[finished][eq]` is the one case no single index covers: the ordered scan uses `(surveyId, createdAt)` and `finished` stays a heap residual, so a page whose matches are sparse reads far more rows than it returns. Prefer narrowing by `surveyId` and a tight `createdAt` window, and treat that combination as the slow path until a covering index exists.\n\n**What this endpoint deliberately does not filter on:** individual answers, hidden-field values, submission metadata (`source`, `url`, `country`, `browser`, `os`, `deviceType`), contact attributes, quotas, and tags. Each is a JSON path or an unindexed join on the largest table in the database, where the honest outcome is a timeout rather than a slow query. The in-app dashboard does offer these, so this endpoint is knowingly behind it; closing the gap needs index work and is tracked separately rather than quietly omitted.\n","deprecated":null,"version":null,"openapi":"/api-v3-reference/openapi.yml get /api/v3/responses","href":"/api-v3-reference/v3-responses/list-responses"},{"title":"Create a response","description":"Records a survey response. Requires read-write access to the workspace, which is resolved from `surveyId` rather than supplied by the caller.\n\n**This performs a real submission.** It runs the full response pipeline — webhooks, integrations, follow-ups, quota evaluation, and Hub ingestion once the response is finished — and it consumes one metered monthly response. That is the same power a v1/v2 management create has today, and the same power an API key with write access already carries; it is called out because an agent holding that key can create genuine submissions. Use `POST /api/v3/responses/validate` to check a payload without any of that happening.\n\n`createdAt` cannot be supplied. Bulk historical loading is therefore not what this endpoint is for — see `ResponseListItem.createdAt` for why, and use v2 while a dedicated import path is outstanding.\n","deprecated":null,"version":null,"openapi":"/api-v3-reference/openapi.yml post /api/v3/responses","href":"/api-v3-reference/v3-responses/create-a-response"},{"title":"Count responses","description":"Returns how many responses match a scope and filter set, without fetching any of them.\n\nThis exists as its own operation because \"how many match this?\" is the question asked most often and it should not require paging through data to answer — particularly for agent clients, where a page of payloads to obtain a single integer is pure waste. It takes the same scope and filter parameters as `GET /api/v3/responses`, minus pagination and sorting, so a count and a page are always answering the same question.\n\nThe list endpoint's `meta.totalCount` covers the other case: a caller already paging that also wants the total. That one is opt-in; this one is the direct route.\n","deprecated":null,"version":null,"openapi":"/api-v3-reference/openapi.yml get /api/v3/responses/count","href":"/api-v3-reference/v3-responses/count-responses"},{"title":"Validate a response payload","description":"Checks a create or patch payload and reports what a real write would do — **without writing anything**. Never has side effects: no response is created, no pipeline fires, nothing is metered.\n\nDeliberately the same shape as `POST /api/v3/surveys/validate`: same dual auth, a request discriminated on `operation` carrying the body the real call would take, and a result of `valid`, `operation` and `invalid_params` with document-relative paths. The value is that the two endpoints behave alike, so a client can validate uniformly. Answers are checked against the survey's own validation rules, so a payload this endpoint accepts is one the real write accepts.\n\n**It reports effects, not just a verdict.** When `valid` is `true`, `effects` names the language that would be stamped, the contact and display that would be linked, the quotas that would count, whether the pipeline would fire, and whether the write would be metered. The language is the field that motivated this endpoint: an importer can see that a payload produces language-less responses *before* writing thousands of them.\n\nAuthorization is the same as the operation being validated — read-write for `create` and `patch` — so this cannot be used as a cheaper cross-tenant existence probe than the write itself. An inaccessible `responseId` on a patch validation answers **403**, as the patch would.\n\n**What it does not do:** an endpoint lets a caller check; it cannot stop a caller writing a bad record anyway. Consistency across the write paths comes from all of them calling the same validator — this endpoint is that validator's public face, not a gate in front of it.\n","deprecated":null,"version":null,"openapi":"/api-v3-reference/openapi.yml post /api/v3/responses/validate","href":"/api-v3-reference/v3-responses/validate-a-response-payload"},{"title":"Delete responses in bulk","description":"Deletes up to 100 responses in one transaction. Requires `manage` access to the workspace.\n\n**A POST custom method, not a `DELETE` on the collection.** A collection-level `DELETE` that loses its filters — through a client bug, a proxy stripping a query string, a copied curl command — degrades into erasing every response in scope. A distinct path cannot be reached by accident. AIP-165 blesses `batchDelete` for exactly this reason.\n\n**It scope-filters rather than rejecting.** Ids belonging to another workspace, and ids that no longer exist, are ignored; the ids in the caller's own workspace are deleted and `deleted` reports how many that was. Rejecting the whole call on a foreign id would do two bad things at once: leak that the id exists somewhere, and break retries — after a partially-applied call, an already-deleted id is indistinguishable from a foreign one. Scope-filtering is idempotent and leaks nothing, so a client can safely retry the same batch.\n\nBecause `deleted` can therefore be lower than the number of ids sent — or zero — do not treat a shortfall as an error. Deletion also removes the responses' uploaded files and their Hub copies: both are queued in the delete's transaction and cleaned up after it commits, files at once and Hub feedback records within minutes, retried until done. This differs from the single-response delete, which does not yet remove the Hub copy (see that operation).\n\n**`workspaceId` is the scope, and it is required.** Unlike the single-response delete — which resolves the workspace *from* the response so a caller cannot pair someone else's id with a scope it happens to hold — a batch has no single response to resolve from, and scope-filtering is only meaningful against a known workspace. Supplying it is safe here because the same value is both what `manage` is checked against and what the delete is filtered by: the two cannot diverge, so a foreign id matches nothing rather than being deleted under a scope the caller does hold.\n","deprecated":null,"version":null,"openapi":"/api-v3-reference/openapi.yml post /api/v3/responses/batch-delete","href":"/api-v3-reference/v3-responses/delete-responses-in-bulk"},{"title":"Mark responses Low quality in bulk","description":"Sets `outcome` on up to 100 responses in one transaction: `lowQuality` marks them, `null` restores them. Nothing is deleted. Requires read-write access to the workspace and write access to every survey the responses belong to.\n\n**It scope-filters rather than rejecting**, exactly like `batch-delete`. Ids belonging to another workspace, ids that no longer exist, and responses of a survey the caller cannot see are ignored, and `updated` reports how many responses in the caller's scope now carry the requested outcome — including ones that already did, so a client can safely retry the same batch. If the batch reaches a survey the caller can see but may not write to, the whole call answers **403** and nothing is changed.\n\nEach response whose outcome actually changed emits `responseUpdated`, so webhooks and integrations hear about a mark and a restore. A response that already carried the outcome is left untouched and emits nothing.\n\n**`workspaceId` is the scope, and it is required**, for the reason `batch-delete` explains.\n","deprecated":null,"version":null,"openapi":"/api-v3-reference/openapi.yml post /api/v3/responses/batch-outcome","href":"/api-v3-reference/v3-responses/mark-responses-low-quality-in-bulk"},{"title":"Get a response","description":"Returns one response in the detailed view — everything the list view carries, plus `contact`, `displayId`, `singleUseId`, and the stored answer map `data`.\n\nThe workspace is resolved from the response itself, so the caller cannot choose which scope it is authorized against and no `workspaceId` parameter is accepted. An unknown or inaccessible `responseId` answers **403**, not **404**, so response ids cannot be probed for existence.\n\n**Round-tripping.** This read returns `data` in the stored, write-shaped form, so the simplest correction is to take it, change one entry and `PATCH` it back. Embedded Data round-trips through `embeddedData[]` instead: the `key` you read is the `key` a write accepts. `answers[]` is the typed view of the same information, offered alongside. Independently of that, a client working from a *list* row — which omits the maps — can still rebuild the write-shaped payload: `answers[]`, `embeddedData[]` and `unresolved[]` together carry every stored key and value **verbatim**, with no need to refetch the survey. Two rules make that guarantee hold, and both are contractual:\n\n`rawKey`, `rawValue`, `valueText`, `valueDate`, `fileUrls`, `imageUrl` and composite slot values are always the stored bytes, never resolved or reformatted — the resolved forms live in the separate `elementLabel`, `optionId`, `optionLabel`, `rowId` and `columnId` fields. And **empty-but-present values are returned, not omitted**: the `\"\"` of an unchecked consent, the `\"\"` of a selected but unfilled Other, a blank composite slot. That second rule matters because `PATCH` replaces `data` wholesale, so an omitted key is a deleted answer rather than an unchanged one.\n","deprecated":null,"version":null,"openapi":"/api-v3-reference/openapi.yml get /api/v3/responses/{responseId}","href":"/api-v3-reference/v3-responses/get-a-response"},{"title":"Delete a response","description":"Permanently deletes a response. Requires `manage` access; the workspace is resolved from the response, and an unknown or inaccessible `responseId` answers **403**.\n\nDeletion cascades to any files uploaded with the response, which are removed from storage after the row is committed. No `responseDeleted` webhook is emitted — no such trigger exists.\n\n**The Hub copy is not removed.** A submission forwarded to the Hub stays there and stays searchable through the feedback-record endpoints after this returns 204. That cascade is ENG-2855 and lands after the Hub release; until then, an erasure workflow has to delete the feedback record itself. Stated because a caller cannot cheaply verify deletion semantics on a destructive endpoint.\n","deprecated":null,"version":null,"openapi":"/api-v3-reference/openapi.yml delete /api/v3/responses/{responseId}","href":"/api-v3-reference/v3-responses/delete-a-response"},{"title":"Update a response","description":"Partially updates a response. Requires read-write access; the workspace is resolved from the response. An unknown or inaccessible `responseId` answers **403**.\n\n`PATCH` is the only update verb — there is no `PUT`. Within it, `data` is replaced wholesale rather than deep-merged, so send the complete answer map; `embeddedData` merges by field name. Unknown top-level keys are rejected with **400** rather than ignored.\n\nEvery patch emits `responseUpdated` and runs the response pipeline, including Hub ingestion. Transitioning `finished` to `true` additionally emits `responseFinished`; patching a response that is already finished does not re-emit it.\n\n`outcome` marks a response **Low quality** (`\"lowQuality\"`) or clears the mark (`null`). Nothing is deleted: the response keeps counting in summaries, counts, lists, webhooks and integrations, and the mark only changes the Analysis export default, the Outcome column and filter, and Feedback Records. A mark or a restore emits `responseUpdated` like any other patch.\n","deprecated":null,"version":null,"openapi":"/api-v3-reference/openapi.yml patch /api/v3/responses/{responseId}","href":"/api-v3-reference/v3-responses/update-a-response"}]},{"group":"V3 Workflows","pages":[{"title":"List workflows","description":"Returns workflow list items for a workspace, sorted by `sortBy` (default `updatedAt`,\nnewest first). Workflows are workspace-scoped and exposed through the same v3\nsession-or-API-key authorization model as surveys.\n\nList items are intentionally slim: they include the derived `triggerType` and `surveyId`\nplus a `lastRun` summary, but not the full `definition`. Use\n`GET /api/v3/workflows/{workflowId}` to read the definition.\n\n`archived` workflows are excluded unless explicitly requested with\n`filter[status][in]=archived`.\n","deprecated":null,"version":null,"openapi":"/api-v3-reference/openapi.yml get /api/v3/workflows","href":"/api-v3-reference/v3-workflows/list-workflows"},{"title":"Create a workflow","description":"Creates a `draft` workflow. The workflow definition is the public source of truth used by\nthe dashboard and external clients, following the document-first pattern established by the\nv3 Survey API. Runtime persistence, revision creation, and version snapshotting are\nimplementation details behind this contract.\n\nWorkflows are always created as drafts; use `POST /api/v3/workflows/{workflowId}/enable` to\nmake them respond to trigger events. Graph reference failures (duplicate node ids, edges\npointing at missing nodes, `entryNodeId` not referencing the trigger, unknown `surveyId` or\n`endingCardIds` in the workspace) are rejected with **400** and structured `invalid_params`.\n","deprecated":null,"version":null,"openapi":"/api-v3-reference/openapi.yml post /api/v3/workflows","href":"/api-v3-reference/v3-workflows/create-a-workflow"},{"title":"List workflow runs","description":"Returns workflow run summaries for a workspace, newest first (`createdAt` descending). Use\n`workflowId` to narrow the list to one workflow, or `responseId` to find the runs a specific\nsurvey response produced.\n\nList items are summaries without `triggerPayload`, `data`, or `logs`; fetch\n`GET /api/v3/workflows/runs/{runId}` for the full debug-oriented payload. This keeps\nresponse-level data out of list reads by default.\n","deprecated":null,"version":null,"openapi":"/api-v3-reference/openapi.yml get /api/v3/workflows/runs","href":"/api-v3-reference/v3-workflows/list-workflow-runs"},{"title":"Retrieve a workflow run","description":"Returns one workflow run by globally unique run id, including the full debug payload: the\ncaptured `triggerPayload`, the run `data` (per-step results), the persisted `logs` trace,\nand retry metadata (`attempt`, `nextAttemptAt`, `lastErrorAt`). Scope 1 deliberately exposes\nthese as JSON dumps so users and agents can understand exactly what happened in a run.\n\nPoll this endpoint after `POST /api/v3/workflows/{workflowId}/test`: runs execute\nasynchronously and transition `queued` → `running` → `completed`/`failed`/`canceled`.\n\nUnknown or inaccessible run ids return `403` rather than `404` to avoid leaking\ncross-workspace resource existence.\n","deprecated":null,"version":null,"openapi":"/api-v3-reference/openapi.yml get /api/v3/workflows/runs/{runId}","href":"/api-v3-reference/v3-workflows/retrieve-a-workflow-run"},{"title":"Retrieve a workflow","description":"Returns one workflow definition by id. Unknown or inaccessible workflow ids return `403`\nrather than `404` to avoid leaking cross-workspace resource existence.\n","deprecated":null,"version":null,"openapi":"/api-v3-reference/openapi.yml get /api/v3/workflows/{workflowId}","href":"/api-v3-reference/v3-workflows/retrieve-a-workflow"},{"title":"Delete a workflow","description":"Permanently deletes a workflow by id. Deletion cascades to the workflow's versions, runs,\nand run logs so no response-derived data is left behind (GDPR requirement). This is\nirreversible; use `POST /api/v3/workflows/{workflowId}/archive` for a reversible\nsoft-delete that keeps history. Returns `204 No Content`.\n","deprecated":null,"version":null,"openapi":"/api-v3-reference/openapi.yml delete /api/v3/workflows/{workflowId}","href":"/api-v3-reference/v3-workflows/delete-a-workflow"},{"title":"Update a workflow","description":"Updates human-facing workflow metadata and/or the workflow definition. Status changes are\nhandled by lifecycle endpoints (`enable`, `disable`, `archive`, `unarchive`) so the state\nmachine remains explicit. Provided fields replace the corresponding stored fields; this\nendpoint does not implement JSON Patch.\n\n`name` and `description` can be updated in any state except `archived`. The `definition`\ncan only be updated while the workflow is `draft` or `disabled`: the live version of an\n`enabled` workflow is an immutable snapshot, so definition changes require disabling (or\nmoving to draft) first and re-enabling afterwards. Violations return **422** with code\n`invalid_workflow_state`. A structurally invalid definition returns **400** with structured `invalid_params`; the referenced survey and ending cards are not verified here — that existence check runs when the workflow is enabled.\n","deprecated":null,"version":null,"openapi":"/api-v3-reference/openapi.yml patch /api/v3/workflows/{workflowId}","href":"/api-v3-reference/v3-workflows/update-a-workflow"},{"title":"Duplicate a workflow","description":"Creates a new `draft` workflow by copying an existing workflow's definition, name (or the\nprovided override), and description. The duplicate receives its own id and timestamps and\nstarts with empty run and version history; the source workflow is unchanged. Archived\nworkflows can be duplicated (the copy starts as a normal draft).\n","deprecated":null,"version":null,"openapi":"/api-v3-reference/openapi.yml post /api/v3/workflows/{workflowId}/duplicate","href":"/api-v3-reference/v3-workflows/duplicate-a-workflow"},{"title":"Enable a workflow","description":"Moves a workflow from `draft` or `disabled` to `enabled`. Only enabled workflows respond to\ntrigger events.\n\nEnabling validates that the definition is executable — the trigger has exactly one outgoing\nedge (trigger-only drafts cannot be enabled), the graph is acyclic, every node is\nreachable from the trigger, only Scope 1 node types are present, the referenced survey\nand ending cards still exist, and every `send_email` action addressing a *literal* email address\ntargets someone who can access this workspace (an element-id `to` resolves to the respondent's own\naddress and is exempt) — and then snapshots an immutable workflow version. Runs\nreference that snapshot via `workflowVersionId`, so later draft edits never change what an\nenabled workflow executes. Validation failures return **422** with code\n`workflow_not_executable` and structured `invalid_params`; calling enable in a state other\nthan `draft` or `disabled` returns **422** with code `invalid_workflow_state`. Two concurrent enable requests race to publish the next version; the loser is rejected with **409** code `conflict` and can safely retry.\n","deprecated":null,"version":null,"openapi":"/api-v3-reference/openapi.yml post /api/v3/workflows/{workflowId}/enable","href":"/api-v3-reference/v3-workflows/enable-a-workflow"},{"title":"Disable a workflow","description":"Moves an `enabled` workflow to `disabled`. Disabled workflows keep their configuration but\ndo not respond to trigger events; runs that are already queued or running are not canceled.\nCalling disable in any other state returns **422** with code `invalid_workflow_state`.\n","deprecated":null,"version":null,"openapi":"/api-v3-reference/openapi.yml post /api/v3/workflows/{workflowId}/disable","href":"/api-v3-reference/v3-workflows/disable-a-workflow"},{"title":"Archive a workflow","description":"Soft-deletes a workflow by moving it from any non-archived state to `archived`. Archived\nworkflows stop responding to trigger events immediately, become read-only, and are excluded\nfrom list responses unless requested with `filter[status][in]=archived`. Their runs, version\nhistory, and definition are preserved, and the workflow can be restored with\n`POST /api/v3/workflows/{workflowId}/unarchive`. Archiving an already archived workflow\nreturns **422** with code `invalid_workflow_state`.\n","deprecated":null,"version":null,"openapi":"/api-v3-reference/openapi.yml post /api/v3/workflows/{workflowId}/archive","href":"/api-v3-reference/v3-workflows/archive-a-workflow"},{"title":"Unarchive a workflow","description":"Restores an `archived` workflow to `draft`. Unarchiving never re-enables a workflow\nautomatically: re-enable explicitly with `POST /api/v3/workflows/{workflowId}/enable`, which\nre-validates the definition (the referenced survey or ending cards may have changed while\nthe workflow was archived). Calling unarchive on a non-archived workflow returns **422**\nwith code `invalid_workflow_state`.\n","deprecated":null,"version":null,"openapi":"/api-v3-reference/openapi.yml post /api/v3/workflows/{workflowId}/unarchive","href":"/api-v3-reference/v3-workflows/unarchive-a-workflow"},{"title":"Dry-run (validate) a workflow","description":"Validates a workflow without running it or causing any side effect. It checks that the workflow's current definition is executable, that the trigger's referenced survey and ending cards still exist in the workspace, and that every `send_email` action addressing a *literal* email address targets someone who can access this workspace. **No** workflow run is created and **no** email or webhook is sent.\n\nThe response is always `200` with `{ data: { workflowId, ok, problems } }`. `data.ok` is `true` when the workflow would execute; otherwise `data.problems` lists every issue found — each with a machine-readable `code` and the offending `field` — so they can be fixed in a single pass.\n\nDrafts are testable — validating the setup before going live is the point of a dry run. Only an `archived` workflow is rejected, with **422** and code `invalid_workflow_state`.\n","deprecated":null,"version":null,"openapi":"/api-v3-reference/openapi.yml post /api/v3/workflows/{workflowId}/test","href":"/api-v3-reference/v3-workflows/dry-run-validate-a-workflow"}]},{"group":"V3 Charts","pages":[{"title":"List charts","description":"Lists a workspace's charts, newest first, page by page. Each chart embeds the dashboards that\nhold it. Needs read access to the workspace. Session cookie, `x-api-key`, or a Bearer token.\n","deprecated":null,"version":null,"openapi":"/api-v3-reference/openapi.yml get /api/v3/charts","href":"/api-v3-reference/v3-charts/list-charts"},{"title":"Create a chart","description":"Creates a chart on a Feedback Dataset. The chart query goes through the chart query validator\n(422 naming each problem); write it against `GET /api/v3/charts/fields` and check it with\n`POST /api/v3/charts/preview` first. Needs write access to the workspace and to the Feedback\nDataset. A name already used in the workspace answers 409.\n","deprecated":null,"version":null,"openapi":"/api-v3-reference/openapi.yml post /api/v3/charts","href":"/api-v3-reference/v3-charts/create-a-chart"},{"title":"List chart fields","description":"Returns the field catalog for a Feedback Dataset: every field a chart query may use, with its\nkind, type, label, description, filter operators and granularities, plus the date presets.\nWrite chart queries against this list — the chart query validator refuses any field that is not\nin it, so the catalog cannot drift from what the API accepts.\n\nNeeds read access to the workspace and to the Feedback Dataset. Session cookie, `x-api-key`, or\na Bearer token.\n","deprecated":null,"version":null,"openapi":"/api-v3-reference/openapi.yml get /api/v3/charts/fields","href":"/api-v3-reference/v3-charts/list-chart-fields"},{"title":"List a field's values","description":"Returns up to 100 distinct stored values of a field, so a filter can use a value that really\noccurs — an `equals` filter on a picked value cannot miss on casing or spacing. Only fields the\ncatalog marks `valueLookup: true` qualify; any other field, or one outside the catalog, answers\n422. Narrow a field with more values using `search`. The list is not paged.\n\nNeeds read access to the workspace and the Feedback Dataset. Counts against the chart-query\nbudget (600 per minute, 20 at once, per user or API key), not the v3 default.\n","deprecated":null,"version":null,"openapi":"/api-v3-reference/openapi.yml get /api/v3/charts/fields/{field}/values","href":"/api-v3-reference/v3-charts/list-a-fields-values"},{"title":"Preview a chart","description":"Runs an unsaved chart and returns its rows, so a caller can check it shows what was meant before\nsaving it. Saves nothing. The chart query is checked by the chart query validator first: a field\noutside the catalog, a refused Cube option, a `timezone`, a bound exceeded or an invalid date\nrange answers 422 naming each problem in `invalid_params`. On a chart grouped by time\nalone, a date range wider than 10,000 buckets of its granularity is one such bound\n(`limit_exceeded`).\n\nNeeds read access to the workspace and the Feedback Dataset. Counts against the chart-query\nbudget (600 per minute, 20 at once, per user or API key), not the v3 default.\n","deprecated":null,"version":null,"openapi":"/api-v3-reference/openapi.yml post /api/v3/charts/preview","href":"/api-v3-reference/v3-charts/preview-a-chart"},{"title":"Get a chart","description":"Returns one chart with the dashboards that hold it. The workspace is resolved from the chart, so\nthe operation takes no query parameters — a `workspaceId` is refused with 400. Needs read access\nto the chart's workspace; a chart the caller cannot see, or that does not exist, answers 403.\n","deprecated":null,"version":null,"openapi":"/api-v3-reference/openapi.yml get /api/v3/charts/{chartId}","href":"/api-v3-reference/v3-charts/get-a-chart"},{"title":"Delete a chart","description":"Deletes a chart that sits on no dashboard. A chart still on one is refused with 409\n`chart_in_use`, naming those dashboards in `details.dashboards` — remove it from them first\n(`DELETE /api/v3/dashboards/{dashboardId}/widgets/{widgetId}`); there is no force option. The\ncheck and the delete are one transaction, so a widget added at the same moment is never removed\nwith the chart. Needs write access to the chart's workspace and, while its Feedback Dataset is\nassigned to that workspace and not archived, to the dataset; a chart whose dataset was unassigned\nor archived can still be deleted.\n","deprecated":null,"version":null,"openapi":"/api-v3-reference/openapi.yml delete /api/v3/charts/{chartId}","href":"/api-v3-reference/v3-charts/delete-a-chart"},{"title":"Update a chart","description":"Edits a chart's name, type, chart query or display settings. The chart may sit on several\ndashboards (`dashboards` in the response), and the edit shows on every one of them — duplicate\nthe chart and repoint one dashboard's widget to change it there only. A chart's Feedback Dataset\ncannot change. Needs write access to the chart's workspace and, while its Feedback Dataset is\nassigned to that workspace and not archived, to the dataset, as a delete does. Once the dataset is\nunassigned or archived, the chart can still be renamed or restyled, but its `query` and `type` can\nno longer change.\n","deprecated":null,"version":null,"openapi":"/api-v3-reference/openapi.yml patch /api/v3/charts/{chartId}","href":"/api-v3-reference/v3-charts/update-a-chart"},{"title":"Get a chart's data","description":"Runs a saved chart and returns its rows. A date range given here replaces the chart's own range\non `FeedbackRecords.collectedAt`, exactly as a dashboard's date filter does: a chart saved for the\nlast 30 days read for the last 12 months shows the last 12 months. `dateRange=all-time` drops the\nchart's saved range, except for a chart grouped by time, which keeps it; no date range leaves the\nsaved range as it is. Every range is read in the organization's display time zone; a `timezone`\nparameter is refused with 400. For a chart grouped by time alone, a requested range that spans\nmore than 10,000 buckets of its granularity answers 422 `limit_exceeded` on `dateRange`:\nrequest a shorter range, or use a chart with a coarser granularity.\n\nDashboards read their widgets' data through\n`GET /api/v3/dashboards/{dashboardId}/charts/{chartId}/data`, which also applies the\ndashboard's filter picks.\n\nNeeds read access to the chart's workspace and to its Feedback Dataset. Counts against the\nchart-query budget (600 per minute, 20 at once, per user or API key), not the v3 default.\n","deprecated":null,"version":null,"openapi":"/api-v3-reference/openapi.yml get /api/v3/charts/{chartId}/data","href":"/api-v3-reference/v3-charts/get-a-charts-data"},{"title":"Duplicate a chart","description":"Copies a chart — same Feedback Dataset, type, chart query and display settings — so the copy can\nchange without touching the dashboards that show the original. With `dashboardId`, the copy is\nalso put on that dashboard (first open slot, or `layout`) in the same transaction, and the\ndashboard's `updatedAt` moves; a dashboard already holding 250 widgets, or with no open slot above\nthe grid's last row, answers 409 and no copy is made. Needs write access to the chart's workspace and to its Feedback Dataset.\n","deprecated":null,"version":null,"openapi":"/api-v3-reference/openapi.yml post /api/v3/charts/{chartId}/duplicate","href":"/api-v3-reference/v3-charts/duplicate-a-chart"}]},{"group":"V3 Dashboards","pages":[{"title":"List dashboards","description":"Lists a workspace's dashboards, newest first, page by page, each with its widget count.\n`filter[chartId][eq]` lists the dashboards that hold a chart. Needs read access to the workspace.\n","deprecated":null,"version":null,"openapi":"/api-v3-reference/openapi.yml get /api/v3/dashboards","href":"/api-v3-reference/v3-dashboards/list-dashboards"},{"title":"Create a dashboard","description":"Creates an empty dashboard in a workspace. Needs write access to the workspace. A name already\nused in the workspace answers 409.\n","deprecated":null,"version":null,"openapi":"/api-v3-reference/openapi.yml post /api/v3/dashboards","href":"/api-v3-reference/v3-dashboards/create-a-dashboard"},{"title":"Get a dashboard","description":"Returns a dashboard with every widget and its full chart, and its filters, so one call tells a\ncaller what is on it. Read each widget's numbers from\n`GET /api/v3/dashboards/{dashboardId}/charts/{chartId}/data`. The workspace is resolved\nfrom the dashboard, so the operation takes no query parameters. Needs read access to the\ndashboard's workspace; a dashboard the caller cannot see, or that does not exist, answers 403.\n","deprecated":null,"version":null,"openapi":"/api-v3-reference/openapi.yml get /api/v3/dashboards/{dashboardId}","href":"/api-v3-reference/v3-dashboards/get-a-dashboard"},{"title":"Save a whole dashboard","description":"Replaces a dashboard's name and every widget's place in one transaction — all of it or none of\nit. A widget left out is removed; its chart is kept. Widgets may leave gaps but not overlap (422).\nSend the `updatedAt` from your read as `expectedUpdatedAt`: if the dashboard changed since, the save\nis refused with 409 and nothing is written. Needs write access to the dashboard's workspace.\n\n`filters`, when sent, replace the dashboard's filters. A filter on an embedded-data field\n(`FeedbackRecords.ed_*`) must name a key that the Feedback Dataset of at least one widget the save\nkeeps has; otherwise the save answers 422 naming `filters[\u003cindex>].field` with\n`invalid_reference`. A filter already saved on the dashboard is not asked again, so it keeps\nsaving after its key leaves every chart.\n","deprecated":null,"version":null,"openapi":"/api-v3-reference/openapi.yml put /api/v3/dashboards/{dashboardId}","href":"/api-v3-reference/v3-dashboards/save-a-whole-dashboard"},{"title":"Delete a dashboard","description":"Deletes a dashboard and its widgets. Every chart stays, including charts no other dashboard\nholds; delete those with `DELETE /api/v3/charts/{chartId}`. Needs write access to the\ndashboard's workspace.\n","deprecated":null,"version":null,"openapi":"/api-v3-reference/openapi.yml delete /api/v3/dashboards/{dashboardId}","href":"/api-v3-reference/v3-dashboards/delete-a-dashboard"},{"title":"Rename a dashboard","description":"Renames a dashboard and moves its `updatedAt`, so an editor holding the dashboard from before is\ntold when saving. Needs write access to the dashboard's workspace. A name already used in the\nworkspace answers 409.\n","deprecated":null,"version":null,"openapi":"/api-v3-reference/openapi.yml patch /api/v3/dashboards/{dashboardId}","href":"/api-v3-reference/v3-dashboards/rename-a-dashboard"},{"title":"Duplicate a dashboard","description":"Copies a dashboard, in one transaction, with its layout. The copy **shares** the original's\ncharts: its widgets point at the same charts, so editing one of them changes both dashboards. To\nchange a chart on the copy only, duplicate the chart and repoint the copy's widget. Needs write\naccess to the dashboard's workspace. A `name` already used in the workspace answers 409.\n","deprecated":null,"version":null,"openapi":"/api-v3-reference/openapi.yml post /api/v3/dashboards/{dashboardId}/duplicate","href":"/api-v3-reference/v3-dashboards/duplicate-a-dashboard"},{"title":"Add a chart to a dashboard","description":"Puts an existing chart on a dashboard. Without a `layout` the chart lands in the first open slot\nat its chart type's default size; with one, exactly there. Widgets may leave gaps but not overlap:\na layout covering another widget answers 422 naming it. A chart appears at most once per\ndashboard (409), and must live in the dashboard's workspace. A dashboard holds at most 250\nwidgets, and a new widget takes the first open slot: an add past the cap, or with no open slot\nabove the grid's last row, answers 409. Moves the dashboard's `updatedAt`.\nNeeds write access to the dashboard's workspace.\n","deprecated":null,"version":null,"openapi":"/api-v3-reference/openapi.yml post /api/v3/dashboards/{dashboardId}/widgets","href":"/api-v3-reference/v3-dashboards/add-a-chart-to-a-dashboard"},{"title":"Get a widget","description":"Returns one widget on a dashboard with its full chart: the resource an add's `Location` names.\nNeeds read access to the dashboard's workspace; a widget that is not on the dashboard, or a\ndashboard the caller cannot see, answers 403.\n","deprecated":null,"version":null,"openapi":"/api-v3-reference/openapi.yml get /api/v3/dashboards/{dashboardId}/widgets/{widgetId}","href":"/api-v3-reference/v3-dashboards/get-a-widget"},{"title":"Remove a chart from a dashboard","description":"Takes a widget off its dashboard. The chart is kept, with every other dashboard it sits on. Moves\nthe dashboard's `updatedAt`. Needs write access to the dashboard's workspace.\n","deprecated":null,"version":null,"openapi":"/api-v3-reference/openapi.yml delete /api/v3/dashboards/{dashboardId}/widgets/{widgetId}","href":"/api-v3-reference/v3-dashboards/remove-a-chart-from-a-dashboard"},{"title":"Move a widget or show another chart in it","description":"Moves or resizes a widget, points it at another chart, or both. A layout covering another widget\nanswers 422 naming it; a chart already on the dashboard answers 409. Moves the dashboard's\n`updatedAt`. Needs write access to the dashboard's workspace.\n","deprecated":null,"version":null,"openapi":"/api-v3-reference/openapi.yml patch /api/v3/dashboards/{dashboardId}/widgets/{widgetId}","href":"/api-v3-reference/v3-dashboards/move-a-widget-or-show-another-chart-in-it"},{"title":"Get a chart's data through its dashboard","description":"Runs a chart that is a widget on this dashboard and returns its rows — the endpoint every\ndashboard widget loads its data from. The body is the chart data body (`GET\n/api/v3/charts/{chartId}/data`) plus `unfilterableFilters`.\n\nThe filters narrow the chart's saved query and never widen it; the date range sets its period:\n\n- **Date range.** `dateRange`, or `from` and `to`, replaces the chart's own range on\n `FeedbackRecords.collectedAt`: a chart saved for the last 30 days read for the last 12 months\n shows the last 12 months.\n- **Filters.** Each `filter[\u003cid>]` with values in `picks[\u003cid>]` is ANDed onto the chart's saved\n filters and never widens them; a saved rule on the same field is kept, at any depth. A filter\n on a field the chart's Feedback Dataset lacks answers empty `rows` and names the filter in\n `unfilterableFilters`, as does a Sentiment, Sentiment Score or Emotions filter that needs a\n value, on a chart that reads no text answer (see `unfilterableFilters`). Picks may take at\n most 4000 characters in all, each value counted percent-encoded as the URL carries it\n (`MAX_DASHBOARD_FILTER_PICKS_CHARS`); past it the request answers 422 naming `picks` with\n `limit_exceeded`.\n\nA chart that is not a widget on the dashboard answers 404, whether it exists elsewhere or not.\nNeeds read access to the dashboard's workspace and to the chart's Feedback Dataset. Counts\nagainst the chart-query budget (600 per minute, 20 at once, per user or API key), not the v3\ndefault.\n","deprecated":null,"version":null,"openapi":"/api-v3-reference/openapi.yml get /api/v3/dashboards/{dashboardId}/charts/{chartId}/data","href":"/api-v3-reference/v3-dashboards/get-a-charts-data-through-its-dashboard"},{"title":"List a dashboard filter's values","description":"The values a list filter offers — one whose operator is `equals` or `notEquals` on a categorical\nfield (`valueLookup` in the field catalog, `FeedbackRecords.valueId`, a yes/no field, or an\nembedded-data field): only values\nthat occur, so for a fixed-option field (sentiment, value band, yes/no) it says which options the\ncharts have. A yes/no field lists `true` / `false` and ignores `search`. They are the values the dashboard's\ncharts let through under their own saved filters, narrowed by the dashboard date range and the\nother filters' picks. `filterId` is the `\u003cid>` of one of the request's `filter[\u003cid>]` parameters. The filter's own pick\nnever narrows its list. Charts whose Feedback Dataset lacks the field, or lacks another picked\nfilter's field, offer nothing.\n\nUp to 100 values, alphabetical; `hasMore` says more match, and `search` narrows them\n(case-insensitive, contains). Values stored as ids a survey names carry the `label` they are\nshown by: an answer's option (`FeedbackRecords.valueId`) its option label, a source id\n(`FeedbackRecords.sourceId`) its survey's name, an ending (`FeedbackRecords.metadataEndingId`) its\nheadline. Labels come only from the surveys mapped into the dashboard's Feedback Datasets; an id\nnone of them names has no `label`. Such a list is in label order, and `search` also finds a value\nwhose label contains it. A filter the request does not name, or one that takes a typed\nvalue (free text such as `FeedbackRecords.valueText`), answers 422.\n\nPicks may take at most 4000 characters in all, each value counted percent-encoded as the URL\ncarries it (`MAX_DASHBOARD_FILTER_PICKS_CHARS`); past it the request answers 422 naming `picks`\nwith `limit_exceeded`. A list whose charts would need more than 40 Cube queries\n(`MAX_FILTER_VALUE_QUERIES`: one per Feedback Dataset, up to two per chart showing only its top\ngroups, more when the charts' answer filters or filter conditions do not fit one query) answers 422 naming\n`filterId` with `limit_exceeded`: type a value instead, or split the dashboard.\n\nNeeds read access to the dashboard's workspace and to every Feedback Dataset its charts read.\nEvery request counts against the default v3 budget, cached or not. Lists are cached\nfor 60 seconds per dashboard version, chart versions, filter, picks, date range and search,\nshared by everyone who may read the dashboard; an uncached list also counts one unit of the\nchart-query budget (600 per minute, 20 at once, per user or API key) per Cube query it runs.\n","deprecated":null,"version":null,"openapi":"/api-v3-reference/openapi.yml get /api/v3/dashboards/{dashboardId}/filters/{filterId}/values","href":"/api-v3-reference/v3-dashboards/list-a-dashboard-filters-values"},{"title":"List a dashboard's embedded-data filter fields","description":"The embedded-data fields a filter on this dashboard can use: the keys of the Feedback Datasets its\ncharts read, and of no other dataset, each once as the `FeedbackRecords.ed_*` member a\n`filter[\u003cid>]` names. The other fields a dashboard filter can use are the same for every dataset\n(see `GET /api/v3/charts/fields`). Each field carries its `type` on this dashboard: a `number`\nkey also compares with `gt`, `gte`, `lt` and `lte`.\n\nA dashboard-bound read: it needs read access to the dashboard's workspace, which a Dashboard viewer\nhas, unlike the field catalog. A Feedback Dataset the caller cannot read through the dashboard is\nleft out rather than failing the list. A dashboard with no charts lists nothing. The workspace is\nresolved from the dashboard, so the operation takes no query parameters; a dashboard the caller\ncannot see, or that does not exist, answers 403.\n\nA Dashboard viewer gets only the keys some chart on the dashboard groups by: a key can hold anything,\nso a viewer filters by, and lists the values of, only what the charts already show them. Naming any\nother key in a filter, or listing its values, answers them 403.\n","deprecated":null,"version":null,"openapi":"/api-v3-reference/openapi.yml get /api/v3/dashboards/{dashboardId}/filter-fields","href":"/api-v3-reference/v3-dashboards/list-a-dashboards-embedded-data-filter-fields"}]},{"group":"V3 Creatives","pages":[{"title":"List creatives","description":"Returns a workspace's creatives, most recently updated first. Session cookie, `x-api-key`, or a Bearer token, with read access to the workspace.\n\n**Archived creatives are left out** unless `filter[displayStatus][in]` asks for `archived`. `filter[displayStatus][in]` filters on the derived `displayStatus`, so it matches what each row shows: a creative whose survey is paused matches `paused`, one whose schedule has ended matches `closed`. `surveyId` keeps the creatives that open that survey.\n\n**Pagination is keyset** on the sort field and `id`. The `cursor` is opaque and bound to the sort order and the filters it was issued for; changing either answers **400**. `meta.nextCursor` being `null` is the only end-of-collection signal.\n","deprecated":null,"version":null,"openapi":"/api-v3-reference/openapi.yml get /api/v3/creatives","href":"/api-v3-reference/v3-creatives/list-creatives"},{"title":"Create a creative","description":"Creates a feedback button or a banner. Requires read/write access to `workspaceId`. The creative is a **draft** unless `status` says otherwise.\n\n**Destination.** A survey Destination must be in the same workspace, visible to the whole workspace (never Restricted, nor with a visibility change pending), and neither single-use nor PIN-protected; an `http(s)` link is the alternative. Anything else answers **422** naming `destination`.\n\n**Publish rules**, checked whenever the resulting `status` isn't `draft`: a feedback button, and a banner with a button, need a `destination`; a banner without a button can't have one; the default language's label or message can't be empty; `showOn: action` needs at least one trigger. A breach answers **422** with one `invalid_params` entry per problem.\n\n**Languages.** Every text map must hold `defaultLanguage`, and any other locale key must be declared in `languages` (**422** `unsupported_locale` otherwise). A missing translation is fine: visitors see the default language.\n\n**Custom CSS** (`styling.theme.customCss`). Adding it needs the Scale plan on Formbricks Cloud (**403** `custom_css_plan_required`), and CSS that cannot be processed answers **422** naming `styling.theme.customCss`. Processing counts against the custom CSS budget shared with surveys; beyond it the request is a **429** and nothing is written.\n","deprecated":null,"version":null,"openapi":"/api-v3-reference/openapi.yml post /api/v3/creatives","href":"/api-v3-reference/v3-creatives/create-a-creative"},{"title":"Pause every creative that opens a survey","description":"Pauses, in one request, every creative whose Destination is `surveyId` and whose `status` is `inProgress`, however many there are. Each one's `status` becomes `paused`, set by its author, so it stays paused whatever the survey does until it is resumed; nothing else about it changes. Drafts, creatives already paused or closed, archived creatives and the creatives of other surveys are left as they are, and so is a creative whose schedule has ended (it shows as closed, and nothing brings it back). The survey screens call it before resuming a survey whose creatives the author keeps paused.\n\nRead/write access to `workspaceId`, the same access pausing one creative needs; an unknown `surveyId`, or one in another workspace, answers **403**. Allowed in wind-down, like pausing one creative. A survey with nothing to pause answers **200** with `paused: 0`. Each paused creative is audited as an update of its `status`.\n","deprecated":null,"version":null,"openapi":"/api-v3-reference/openapi.yml post /api/v3/creatives/pause","href":"/api-v3-reference/v3-creatives/pause-every-creative-that-opens-a-survey"},{"title":"Get a creative","description":"Returns one creative, with its derived `displayStatus`, `displayStatusReason`, `warnings` and `destination.opensAs`. Read access to the creative's workspace, which is resolved from the creative, so no `workspaceId` is accepted. An unknown or inaccessible `creativeId` answers **403**, not **404**, so creative ids cannot be probed for existence.","deprecated":null,"version":null,"openapi":"/api-v3-reference/openapi.yml get /api/v3/creatives/{creativeId}","href":"/api-v3-reference/v3-creatives/get-a-creative"},{"title":"Delete a creative","description":"Deletes a creative and its Impression and Click counts for good. Survey displays and responses it opened keep the creative they recorded. Read/write access to its workspace; an unknown or inaccessible `creativeId` answers **403**. To set a creative aside and keep its counts, archive it instead. Deleting the last creative that opens a live app survey with no actions of its own succeeds; that survey then shows nowhere until a creative or an action opens it again.","deprecated":null,"version":null,"openapi":"/api-v3-reference/openapi.yml delete /api/v3/creatives/{creativeId}","href":"/api-v3-reference/v3-creatives/delete-a-creative"},{"title":"Update a creative","description":"Changes a creative. Read/write access to its workspace; an unknown or inaccessible `creativeId` answers **403**. Each group sent replaces the stored one as a whole (see `PatchCreativeRequest`); an empty body changes nothing.\n\n**Status.** Publish with `status: inProgress`, pause with `paused`, close with `completed`, and reopen or resume with `inProgress`. A creative that was ever published can't go back to `draft`. Any status but `draft` must meet the publish rules of `POST /api/v3/creatives`, checked against the creative as it would be after the change, except for pausing or closing a published creative with a body that changes nothing else: taking it down works even when it no longer meets them (its last action was deleted, or its survey unlinked). In wind-down (the license does not include Creatives), only a body that sets nothing but `status` to `paused` or `completed` (with `expectedUpdatedAt` or without) is accepted; any other body, an empty one included, answers **403** `creatives_not_entitled`.\n\n**Custom CSS.** Adding or editing `styling.theme.customCss` follows the rules of `POST /api/v3/creatives`; removing it, or sending it back unchanged, needs no plan and is not processed again.\n\nAn archived creative is read-only: restore it first, or the request answers **422**.\n\n**Concurrent changes.** The change applies to the creative as it is stored when the request runs, so a pause, close or archive made meanwhile is never undone by a request that doesn't mention it. Send `expectedUpdatedAt` (the `updatedAt` you last read) to have the change refused with **409** instead when the creative changed since your read.\n\n**Its survey.** Changing or removing `destination` succeeds even when this creative is the last one that opens a live (`inProgress`) app survey with no actions of its own; that survey then shows nowhere until a creative or an action opens it again. Check before relinking.\n","deprecated":null,"version":null,"openapi":"/api-v3-reference/openapi.yml patch /api/v3/creatives/{creativeId}","href":"/api-v3-reference/v3-creatives/update-a-creative"},{"title":"Archive a creative","description":"Sets a creative aside: it never shows, it no longer blocks changes to its survey, it leaves the default list, and it becomes read-only until restored. Its status and counts are kept while it is archived; restoring it brings it back as a draft. Archiving an archived creative changes nothing. Read/write access to its workspace; an unknown or inaccessible `creativeId` answers **403**. Archiving the last creative that opens a live app survey with no actions of its own succeeds; that survey then shows nowhere until a creative or an action opens it again.","deprecated":null,"version":null,"openapi":"/api-v3-reference/openapi.yml post /api/v3/creatives/{creativeId}/archive","href":"/api-v3-reference/v3-creatives/archive-a-creative"},{"title":"Restore a creative","description":"Brings an archived creative back, always as a **draft**, whatever status it had: it never reappears on a site by surprise, and showing it again means publishing it again. Its content, styling and counts come back as they were, and so does its Destination, unless its survey can no longer be one (it became Restricted, single-use or PIN-protected), in which case it is unlinked now. `publishedAt` keeps when it was first published. Restoring a creative that isn't archived changes nothing. Read/write access to its workspace; an unknown or inaccessible `creativeId` answers **403**.","deprecated":null,"version":null,"openapi":"/api-v3-reference/openapi.yml post /api/v3/creatives/{creativeId}/restore","href":"/api-v3-reference/v3-creatives/restore-a-creative"},{"title":"Duplicate a creative","description":"Copies a creative into a new **draft** named \"\u003cname> (copy)\": same type, content, styling, languages, Destination, distribution and schedule, with no counts. A survey Destination that can no longer be one is left out of the copy, which then carries a `destinationMissing` warning. Works on archived creatives too; the copy isn't archived. Read/write access to the creative's workspace; an unknown or inaccessible `creativeId` answers **403**.","deprecated":null,"version":null,"openapi":"/api-v3-reference/openapi.yml post /api/v3/creatives/{creativeId}/duplicate","href":"/api-v3-reference/v3-creatives/duplicate-a-creative"},{"title":"Get a creative's counts","description":"Returns a creative's Impressions and Clicks per UTC day from `from` to `to` (both inclusive), their totals and Click rate, and, with `groupBy`, the same counts by page or by device type. Read access to the creative's workspace; an unknown or inaccessible `creativeId` answers **403**.\n\nCounts are kept per day, not per event. The web SDK reports what visitors see, and a background job adds it here about once a minute, so a count can lag by up to a minute. An instance running without its BullMQ worker never adds counts. Archived creatives keep their counts, deleting a creative deletes them, and a duplicate starts with none.\n\n**400** when `from` is after `to`, or the range spans more than 366 days.\n","deprecated":null,"version":null,"openapi":"/api-v3-reference/openapi.yml get /api/v3/creatives/{creativeId}/stats","href":"/api-v3-reference/v3-creatives/get-a-creatives-counts"}]},{"group":"V3 Action Classes","pages":[{"title":"List action classes","description":"Returns the action classes (user actions that can trigger an app survey) for a workspace. Use\nthe returned ids as `distribution.triggers[].actionClassId` when creating or updating app\nsurveys. Read-only: this v3 endpoint lists action classes but does not create them — action\nclasses are managed in the Formbricks app (Actions settings) or via the v1/v2 management API.\n\nAn empty `data` array means the workspace has no action classes yet. Triggers are optional, so\nyou can still create an app survey with `distribution.triggers: []` (or omit `distribution`\nentirely) and attach triggers later via `PATCH` once an action class exists. Session cookie, `x-api-key`, or a Bearer token.\n","deprecated":null,"version":null,"openapi":"/api-v3-reference/openapi.yml get /api/v3/action-classes","href":"/api-v3-reference/v3-action-classes/list-action-classes"}]},{"group":"V3 Contact Attribute Keys","pages":[{"title":"List contact attribute keys","description":"Returns the contact attribute keys for a workspace. Use the returned `key` values as\n`targeting.filters[].root.contactAttributeKey` when targeting app surveys; `dataType` hints which\noperators apply. Requires the Contacts entitlement (**403** without it). Session cookie,\n`x-api-key`, or a Bearer token.\n\nOptional `search`, `filter[dataType][in]`, `filter[type][in]`, `sortBy` and `includeTotalCount`\nnarrow, order and count the list on the server. Without them the endpoint behaves as before:\nordered by `id`, `meta.totalCount` is `null`. The cursor is bound to `sortBy` and the\nsearch/filter set; changing any of them while paging → **400** naming `cursor`. Unknown query\nparameters → **400**.\n","deprecated":null,"version":null,"openapi":"/api-v3-reference/openapi.yml get /api/v3/contact-attribute-keys","href":"/api-v3-reference/v3-contact-attribute-keys/list-contact-attribute-keys"}]},{"group":"V3 Contacts","pages":[{"title":"List contacts","description":"Returns a workspace's contacts, filtered, searched, sorted and counted on the server. Requires the\nContacts entitlement (**403** without it). Session cookie, `x-api-key`, or a Bearer token.\n\n**Attribute filters** use `filter[attribute.\u003ckey>][\u003coperator>]=\u003cvalue>`, where `\u003ckey>` is a\n`ContactAttributeKeyResource.key` of the workspace (an unknown key → **400**). The operators depend\non the key's `dataType`; an operator the type does not support → **400**:\n\n| dataType | operators |\n| -------- | --------- |\n| `string` | `in`, `eq`, `ne`, `contains`, `notContains`, `startsWith`, `endsWith`, `isSet`, `isNotSet` |\n| `number` | `in`, `eq`, `ne`, `gt`, `gte`, `lt`, `lte`, `isSet`, `isNotSet` |\n| `date` | `gte`, `lte` (ISO 8601 date-time with offset, inclusive), `isSet`, `isNotSet` |\n\nText comparisons are case-insensitive. `in` matches any of its values: repeat the key once per\nvalue (`filter[attribute.plan][in]=Pro\u0026filter[attribute.plan][in]=Team`). String values are taken\nverbatim — never split on commas, since a value can contain one; a `number` `in` also accepts\ncomma-separated values. `ne`, `contains`, `notContains`, `startsWith` and `endsWith` may\nalso be repeated, and then every value must hold (AND). Every other operator takes exactly one\nvalue (repeating it → **400**).\n`isSet` / `isNotSet` ignore their value (send `true`). A value is *set* when the attribute row\nexists and carries a value (non-empty text, or a non-null number/date). `ne` and\n`notContains` match only contacts whose value is set and differs — use `isNotSet` for contacts\nwithout one. All filters combine with AND. At most 50 distinct filter parameters per request and\nat most 100 values per `in`.\n\nThe cursor is bound to `sortBy` and to the search and filter set; changing any of them while\npaging → **400** naming `cursor`. Unknown query parameters → **400**.\n","deprecated":null,"version":null,"openapi":"/api-v3-reference/openapi.yml get /api/v3/contacts","href":"/api-v3-reference/v3-contacts/list-contacts"},{"title":"List distinct values of a contact attribute","description":"Returns the distinct, non-empty values one contact attribute takes in a workspace, in ascending\norder and bounded by `limit` — for quick-filter value pickers. Not paginated: `meta.truncated` says\nwhether more values match than were returned, so a picker can ask the user to narrow the search. Number and date attributes return\ntheir stored text `value`. Requires the Contacts entitlement (**403** without it). An unknown\n`key` → **400**. Session cookie, `x-api-key`, or a Bearer token.\n","deprecated":null,"version":null,"openapi":"/api-v3-reference/openapi.yml get /api/v3/contacts/attribute-values","href":"/api-v3-reference/v3-contacts/list-distinct-values-of-a-contact-attribute"}]},{"group":"V3 Segments","pages":[{"title":"List segments","description":"Returns a workspace's segments, searched, sorted and counted on the server. Private segments\n(survey-local targeting drafts) are never listed. A segment's survey references — including the\n`surveyIds` of its survey-interaction filters — only name surveys the caller may see. Requires the Contacts entitlement (**403** without it). The cursor is bound to\n`sortBy` and `filter[title][contains]`; changing either while paging → **400** naming `cursor`. Unknown query\nparameters → **400**. Session cookie, `x-api-key`, or a Bearer token.\n","deprecated":null,"version":null,"openapi":"/api-v3-reference/openapi.yml get /api/v3/segments","href":"/api-v3-reference/v3-segments/list-segments"}]},{"group":"V3 Workspaces","pages":[{"title":"Read workspace custom CSS","description":"Returns the workspace's shared survey CSS as editable **source** (light and dark), the one recoverable previous revision, whether the stored CSS is being delivered to respondents (`status`), and whether this caller may change it (`canEdit`, `planAllowed`). Compiled output is never returned here. Requires read access to the workspace. Session cookie, `x-api-key`, or a Bearer token.\n","deprecated":null,"version":null,"openapi":"/api-v3-reference/openapi.yml get /api/v3/workspaces/{workspaceId}/custom-css","href":"/api-v3-reference/v3-workspaces/read-workspace-custom-css"},{"title":"Save or clear workspace custom CSS","description":"Saves or clears the workspace's shared survey CSS. `customCss` replaces both fields; `null` clears all of it. The source is processed by the same processor every save path uses: constructs it removes come back as top-level `warnings`, and CSS it rejects is a **422** that leaves the saved CSS in effect. The replaced value becomes `previous`, the one recoverable revision — restore it by sending its source back. Unchanged source writes nothing.\n\nWorkspace CSS reaches every survey in the workspace, so writing it is narrower than writing a survey: **organization owners and managers** for signed-in users (session or OAuth), and a **`manage`** grant on this workspace for API keys — a Read \u0026 write grant is refused with **403**. On Formbricks Cloud, adding or editing needs the Scale plan (**403** `custom_css_plan_required`); clearing never does. Successful changes refresh the cached configuration the SDKs receive (they pick it up on their next configuration fetch). Saves that add or edit CSS count against a custom CSS budget of 60 per minute per user or API key, shared with custom CSS validation and with survey writes that add or edit custom CSS; beyond it they return **429**. Re-saving the same CSS and clearing it are never counted.\n","deprecated":null,"version":null,"openapi":"/api-v3-reference/openapi.yml patch /api/v3/workspaces/{workspaceId}/custom-css","href":"/api-v3-reference/v3-workspaces/save-or-clear-workspace-custom-css"}]},{"group":"V3 Feedback Records","pages":[{"title":"List feedback records","description":"Lists the feedback records of one dataset, newest first, with optional filters and keyset\npagination. Served by the API gateway, which authorizes the call against `tenant_id` and\nforwards it to the feedback store — see the introduction for how the two layers answer.\n\nRequires an API key with **read** permission (or higher) on a workspace the dataset is assigned\nto. The organization must hold the Unify Feedback entitlement.\n\nMulti-value filters are OR-ed within a parameter and AND-ed across parameters. Repeat the\nparameter to pass several values (`?field_type=text\u0026field_type=rating`); comma-separated values\nare **not** split. Filters on enrichment members (`sentiment`, `emotions`, `sentiment_score_*`)\nnever match records that have not been enriched — use `has_sentiment=false` / `has_emotions=false`\nto find those.\n\n**Incremental extraction.** To keep a copy of a dataset in sync, filter on `updated_since` and\npage with `sort=updated_at\u0026order=asc`, bounded by `updated_until`: every page is then one index\nrange, and a record that changes while you page normally comes back later in the run. Start each\nrun with a `limit=1` request and read its `Date` header: that value is this run's `updated_until`\nand, minus a few minutes, the next run's `updated_since` — both bounds from the same value, or\nrecords between them are never read. Do not use the newest `updated_at` received instead: it\nskips a write that was still committing when you read past its timestamp.\nUpsert by `id` and let the most recent fetch win. Deleted records leave nothing for\n`updated_since` to match, so reconcile deletions separately: periodically list every record id\nwith no `updated_since`, and remove the local records that were not returned and were created\nbefore that listing's start (its first response's `Date` header) minus the overlap. Run one\nsync at a time.\n","deprecated":null,"version":null,"openapi":"/api-v3-reference/openapi.yml get /api/v3/feedbackRecords","href":"/api-v3-reference/v3-feedback-records/list-feedback-records"},{"title":"Create a feedback record","description":"Stores one feedback record in the dataset named by `tenant_id` in the body. The gateway reads\n`tenant_id` from the JSON body to authorize the call — a body that is not JSON, or has no\n`tenant_id`, answers **400** before anything is stored.\n\nRequires an API key with **write** permission (or higher) on a workspace the dataset is\nassigned to. Creating is allowed on shared datasets (it is ordinary workspace work, like a CSV\nimport); only changing and deleting existing records is restricted to unshared ones.\n\nIngestion is idempotent per (`tenant_id`, `submission_id`, `field_id`): a second record with the\nsame triple answers **409** rather than creating a duplicate. Send exactly one `value_*` member,\nmatching `field_type`. A `text` record is enriched asynchronously — `sentiment`, `emotions` and\nthe translation members appear on the record once enrichment completes, and it becomes\nsearchable once embedded.\n","deprecated":null,"version":null,"openapi":"/api-v3-reference/openapi.yml post /api/v3/feedbackRecords","href":"/api-v3-reference/v3-feedback-records/create-a-feedback-record"},{"title":"Delete a user's feedback records","description":"Permanently deletes every record in the dataset whose `user_id` matches — the erasure operation\nfor GDPR Article 17 requests. Derived embeddings are removed with the records. Idempotent:\nrepeating the call answers `deleted_count: 0`.\n\n`tenant_id` is **required**: the gateway scopes erasure to one dataset. (The underlying store\ncan erase a user across every dataset when `tenant_id` is omitted; that form is not reachable\nthrough this API.) Records written without a `user_id` cannot be reached this way — delete them\nindividually.\n\nDeletion is unrecoverable, so it requires an API key with **manage** permission on a workspace\nthe dataset is assigned to, and the dataset must be assigned to **exactly one** workspace: on a\nshared dataset no workspace permission can say whose records these are, so API-key mutations\nare refused with **403**.\n","deprecated":null,"version":null,"openapi":"/api-v3-reference/openapi.yml delete /api/v3/feedbackRecords","href":"/api-v3-reference/v3-feedback-records/delete-a-users-feedback-records"},{"title":"Search feedback records semantically","description":"Embeds `query` and returns the ids of the records in the dataset whose text is closest to it,\nwith cosine similarity scores. Only records with a non-empty `value_text` are embedded, so only\nthose can match. The gateway reads `tenant_id` from the JSON body to authorize the call.\nRequires an API key with **read** permission (or higher) on a workspace the dataset is\nassigned to.\n\nResults carry ids and the embedded text only — fetch a match with\n`GET /api/v3/feedbackRecords/{id}` for the full record. Answers **503** on instances without\nan embedding model configured.\n","deprecated":null,"version":null,"openapi":"/api-v3-reference/openapi.yml post /api/v3/feedbackRecords/search/semantic","href":"/api-v3-reference/v3-feedback-records/search-feedback-records-semantically"},{"title":"Get a feedback record","description":"Returns one feedback record by id, with its read-only assignment in the active directory\ntaxonomy. The assignment reflects the current visible path in the active run; editing a record\ndoes not reclassify it until another run. `taxonomy` is null if its lookup is unavailable.\nThe gateway looks the record up to learn its dataset and\nauthorizes against that, so no `tenant_id` is sent. Requires an API key with **read**\npermission (or higher) on a workspace the record's dataset is assigned to.\n\nAn unknown id, or one in a dataset you cannot read, answers **403** rather than 404, so ids\ncannot be probed. The exception is the minute after a delete: the gateway still has the\nrecord's dataset cached, authorizes the call, and the store answers **404**.\n","deprecated":null,"version":null,"openapi":"/api-v3-reference/openapi.yml get /api/v3/feedbackRecords/{id}","href":"/api-v3-reference/v3-feedback-records/get-a-feedback-record"},{"title":"Delete a feedback record","description":"Permanently deletes one record and its derived embedding. Unrecoverable, so it requires an API\nkey with **manage** permission on a workspace the record's dataset is assigned to, and the\ndataset must be assigned to **exactly one** workspace: on a shared dataset no workspace\npermission can say whose record this is, so API-key mutations are refused with **403**.\n","deprecated":null,"version":null,"openapi":"/api-v3-reference/openapi.yml delete /api/v3/feedbackRecords/{id}","href":"/api-v3-reference/v3-feedback-records/delete-a-feedback-record"},{"title":"Update a feedback record","description":"Changes the answer, `language`, `user_id` or `metadata` of one record. Only the members sent\nare changed; provenance (`tenant_id`, `source_*`, `field_*`, `submission_id`, `collected_at`)\nis immutable. Requires an API key with **write** permission (or higher) on a workspace the\nrecord's dataset is assigned to, and the dataset must be assigned to **exactly one** workspace\n— see the delete operation for why.\n\nTwo behaviours are silent and worth knowing: `metadata` is **replaced**, not merged; and\nchanging `value_text` clears the enrichment members (`sentiment`, `sentiment_score`,\n`emotions`, `value_text_translated`, `translation_lang_key`) and queues re-enrichment and\nre-embedding — the response shows them absent until that completes. Changing `language` clears\nand re-queues the translation pair only.\n","deprecated":null,"version":null,"openapi":"/api-v3-reference/openapi.yml patch /api/v3/feedbackRecords/{id}","href":"/api-v3-reference/v3-feedback-records/update-a-feedback-record"},{"title":"Find similar feedback records","description":"Returns the records in the same dataset whose embedded text is closest to the given record's,\nwith cosine similarity scores. The anchor record itself is excluded. The gateway looks the\nrecord up to learn its dataset and authorizes against that. Requires an API key with **read**\npermission (or higher) on a workspace the record's dataset is assigned to.\n\nAnswers **403** for an unknown or inaccessible id. Answers **404** when the record exists but has\nno embedding — it has no text, or was created moments ago and is not embedded yet. Answers\n**503** on instances without an embedding model configured.\n","deprecated":null,"version":null,"openapi":"/api-v3-reference/openapi.yml get /api/v3/feedbackRecords/{id}/similar","href":"/api-v3-reference/v3-feedback-records/find-similar-feedback-records"}]}]}]},"basePath":"","title":"Edit survey blocks - Documentation - Formbricks","buildId":"dpl_Aw98ji4XvBsgtZwL1VrkUF9ehFqz","deploymentId":"dpl_Aw98ji4XvBsgtZwL1VrkUF9ehFqz","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CQGbdtm4.js","utils-D88A1f-Z.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-ChqWdz1A.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-yBrxdh_6.js","snippetPresets-BgqDrFJC.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-Duxc2rZw.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C7jidOil.js","shallow-xkjpHm-U.js","getApiPlaygroundDisplay-fE3rVpvL.js","CodeSnippet-LgxljKed.js","CodeSnippets-D-pXWDHq.js","Page-C2-BijcO.js","getPastedJson-CLRcu-uo.js","icon-Cxirpjgo.js","MethodPill-D49eqY5e.js","DuplicateIcon-CivCz5Rp.js","createIcon-D71qL3f5.js","DynamicMarkdown-BcGRTrw6.js","SectionHeading-DzaqmmSD.js","axios-vUo_bRtp.js","Markdown-CZqUYmMp.js","clsx-B6IZIRsp.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-B0ZV6X5T.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-MqLyPtsW.js"]}