Restore soft-deleted content (find it via GET /content?deleted=true). It returns as an unpublished draft with versions and history intact — publish again explicitly to go live. Idempotent on content that is not deleted.
URL of the app page where this content is authored and previewed (the visual editor opens it there). Metadata only — it plays NO part in runtime targeting; where content shows is controlled by its start rules.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Usertour documention","colors":{"primary":"#0D9373","light":"#07C983","dark":"#0D9373"},"logo":{"light":"https://mintcdn.com/usertour/fGy2waOqk2YYQ2QK/logo-dark.svg?fit=max\u0026auto=format\u0026n=fGy2waOqk2YYQ2QK\u0026q=85\u0026s=841070ff620cff55401ec69cfc514e27","dark":"https://mintcdn.com/usertour/fGy2waOqk2YYQ2QK/logo-light.svg?fit=max\u0026auto=format\u0026n=fGy2waOqk2YYQ2QK\u0026q=85\u0026s=28f06f1ac3d117bd77837574e801ed7b","href":"https://www.usertour.io/"},"favicon":"https://mintcdn.com/usertour/nYBy6MD0LzNhBLol/images/favicon.png?fit=max\u0026auto=format\u0026n=nYBy6MD0LzNhBLol\u0026q=85\u0026s=2d933e312d87107d569af0615a00225b","api":{"playground":{"display":"simple"}},"navbar":{"links":[{"href":"mailto:support@usertour.io","label":"Support"}]},"footer":{"socials":{"x":"https://x.com/usertourio","github":"https://github.com/usertour/usertour","discord":"https://discord.gg/WPVJPX8fJh"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"usertour","hasAudioNarration":false,"actualSubdomain":"usertour","customDomains":["docs.usertour.io"],"gitSource":{"type":"github","owner":"usertour","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6af2be424ef979744de2e2db","clientVersion":"0.0.4102","searchFilterCounts":[{"language":"default","tag":"API Reference","count":92},{"language":"default","tag":"Endpoints","count":79},{"language":"default","tag":"Documentation","count":49},{"language":"default","tag":"API Reference (v1)","count":37},{"language":"default","tag":"How-to Guides","count":31},{"language":"default","tag":"Usertour.js Reference","count":31},{"language":"default","tag":"Self-Hosting","count":20},{"language":"default","tag":"Content","count":15},{"language":"default","tag":"Users","count":14},{"language":"default","tag":"Companies","count":13}]},"assistantConfig":{},"basePath":"","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":"llms-txt-v2","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}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/content/restore-deleted-content","slug":"/api-reference/content/restore-deleted-content","pageMetadata":{"title":"Restore deleted content","description":"Restore soft-deleted content (find it via GET /content?deleted=true). It returns as an unpublished draft with versions and history intact — publish again explicitly to go live. Idempotent on content that is not deleted.","deprecated":null,"version":null,"openapi":"/api-reference-v2/openapi.json post /v2/projects/{projectId}/content/{id}/restore","href":"/api-reference/content/restore-deleted-content","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Restore soft-deleted content (find it via GET /content?deleted=true). It returns as an unpublished draft with versions and history intact — publish again explicitly to go live. Idempotent on content that is not deleted.\"\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":"Restore deleted content","description":"Restore soft-deleted content (find it via GET /content?deleted=true). It returns as an unpublished draft with versions and history intact — publish again explicitly to go live. Idempotent on content that is not deleted.","deprecated":null,"version":null,"openapi":"/api-reference-v2/openapi.json post /v2/projects/{projectId}/content/{id}/restore","href":"/api-reference/content/restore-deleted-content","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"ApiContentController_restore","summary":"Restore deleted content","description":"Restore soft-deleted content (find it via GET /content?deleted=true). It returns as an unpublished draft with versions and history intact — publish again explicitly to go live. Idempotent on content that is not deleted.","parameters":["96efc060-7c8f-44f8-8508-c1b701565983","0d6658fe-2e8a-45e1-8f58-c16af02ea01b"],"responses":{"200":"b8533d58-9b46-4c54-b9f8-e064ffdb823f","400":"19b7d541-9260-4b38-ba99-baea9c44af57","401":"09765a14-def3-4353-9e7b-db4eefa777f5","403":"d0e2cbb1-91e1-40df-b5fc-3e7e433319bf","404":"c16294d6-c91c-47dc-a0ff-59fa06f0c00b","429":"534da967-4485-4ce5-96f1-f85acec11585"},"tags":["Content"],"security":["09262c4e-2420-46b9-a942-1275dc14da0b"],"method":"post","type":"path","servers":["23c31da0-5340-453a-ad80-9d71f43aa3ab"],"path":"/v2/projects/{projectId}/content/{id}/restore","baseUrlOptions":["https://api.usertour.io"],"title":"Restore deleted content","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"96efc060-7c8f-44f8-8508-c1b701565983":{"name":"id","required":true,"in":"path","description":"Content ID","schema":{"type":"string","isRequired":true,"description":"Content ID","uniqueKey":"","typeLabel":"string"}},"0d6658fe-2e8a-45e1-8f58-c16af02ea01b":{"name":"projectId","required":true,"in":"path","description":"Project ID","schema":{"type":"string","isRequired":true,"description":"Project ID","uniqueKey":"","typeLabel":"string"}}},"responses":{"b8533d58-9b46-4c54-b9f8-e064ffdb823f":{"description":"Restored content","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"id","typeLabel":"string"},"object":{"type":"string","enum":["content"],"isRequired":true,"uniqueKey":"object","typeLabel":"enum\u003cstring>"},"name":{"type":"string","isRequired":true,"uniqueKey":"name","typeLabel":"string"},"type":{"type":"string","enum":["checklist","flow","launcher","banner","tracker","resource-center","announcement"],"isRequired":true,"uniqueKey":"type","typeLabel":"enum\u003cstring>"},"buildUrl":{"oneOf":[{"type":"string","description":"URL of the app page where this content is authored and previewed (the visual editor opens it there). Metadata only — it plays NO part in runtime targeting; where content shows is controlled by its start rules.","isRequired":true,"uniqueKey":"buildUrl.oneOf.0","typeLabel":"string"},{"type":"null","description":"URL of the app page where this content is authored and previewed (the visual editor opens it there). Metadata only — it plays NO part in runtime targeting; where content shows is controlled by its start rules.","isRequired":true,"uniqueKey":"buildUrl.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"buildUrl","typeLabel":"string | null"},"editedVersionId":{"type":"string","isRequired":true,"uniqueKey":"editedVersionId","typeLabel":"string"},"environments":{"type":"array","items":{"type":"object","properties":{"environmentId":{"type":"string","isRequired":true,"uniqueKey":"environments.items.[INDEX].environmentId","typeLabel":"string"},"published":{"type":"boolean","description":"Always true on a returned row: `environments[]` lists ONLY the environments this content is currently published to. Unpublishing removes the row — a missing environment means \"not published there\", it never appears as false.","isRequired":true,"uniqueKey":"environments.items.[INDEX].published","typeLabel":"boolean"},"publishedVersionId":{"type":"string","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersionId","typeLabel":"string"},"publishedAt":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedAt","typeLabel":"string\u003cdate-time>"},"publishedVersion":{"type":"object","properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.id","typeLabel":"string"},"object":{"type":"string","enum":["contentVersion"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.object","typeLabel":"enum\u003cstring>"},"number":{"type":"number","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.number","typeLabel":"number"},"firstPublishedAt":{"oneOf":[{"type":"string","description":"When this version FIRST went live (ISO). Non-null means the version is frozen: it can never be edited again — not even after unpublishing — edit by forking (by forking). null means it never went live — OR its first publish predates this stamp (older versions were never backfilled), so on old data null is not proof it never shipped. This is history, not live state: for \"is it live NOW, where\" read the content's `environments[]`; for who published what when, the publish history (available through the MCP).","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.firstPublishedAt.oneOf.0","typeLabel":"string"},{"type":"null","description":"When this version FIRST went live (ISO). Non-null means the version is frozen: it can never be edited again — not even after unpublishing — edit by forking (by forking). null means it never went live — OR its first publish predates this stamp (older versions were never backfilled), so on old data null is not proof it never shipped. This is history, not live state: for \"is it live NOW, where\" read the content's `environments[]`; for who published what when, the publish history (available through the MCP).","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.firstPublishedAt.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.firstPublishedAt","typeLabel":"string | null"},"themeId":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.themeId.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.themeId.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.themeId","typeLabel":"string | null"},"questions":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["question"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.questions.oneOf.0.items.[INDEX].object","typeLabel":"enum\u003cstring>"},"cvid":{"type":"string","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.questions.oneOf.0.items.[INDEX].cvid","typeLabel":"string"},"name":{"type":"string","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.questions.oneOf.0.items.[INDEX].name","typeLabel":"string"},"type":{"type":"string","enum":["nps","star-rating","scale","single-line-text","multi-line-text","multiple-choice"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.questions.oneOf.0.items.[INDEX].type","typeLabel":"enum\u003cstring>"}},"required":["object","cvid","name","type"],"uniqueKey":"environments.items.[INDEX].publishedVersion.questions.oneOf.0.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.questions.oneOf.0","typeLabel":"object[]"},{"type":"null","items":{"type":"object","properties":{"object":{"type":"string","enum":["question"]},"cvid":{"type":"string"},"name":{"type":"string"},"type":{"type":"string","enum":["nps","star-rating","scale","single-line-text","multi-line-text","multiple-choice"]}},"required":["object","cvid","name","type"]},"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.questions.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.questions","typeLabel":"object[] | null"},"updatedAt":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.updatedAt","typeLabel":"string\u003cdate-time>"},"createdAt":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.createdAt","typeLabel":"string\u003cdate-time>"},"steps":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["step"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].object","typeLabel":"enum\u003cstring>"},"id":{"type":"string","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].id","typeLabel":"string"},"cvid":{"oneOf":[{"type":"string","description":"Stable step handle that SURVIVES forking (unlike `id`, which is regenerated) — echo it on a write to update this step in place. Prefer it over `id` for edits that must outlive a new version.","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].cvid.oneOf.0","typeLabel":"string"},{"type":"null","description":"Stable step handle that SURVIVES forking (unlike `id`, which is regenerated) — echo it on a write to update this step in place. Prefer it over `id` for edits that must outlive a new version.","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].cvid.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].cvid","typeLabel":"string | null"},"name":{"type":"string","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].name","typeLabel":"string"},"type":{"type":"string","enum":["tooltip","modal","hidden","bubble"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"sequence":{"type":"number","description":"0-based display order. On write an explicit `sequence` wins; steps without one fall back to their array index.","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].sequence","typeLabel":"number"},"themeId":{"oneOf":[{"type":"string","description":"Per-step theme override; null = this step inherits the flow version's theme.","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].themeId.oneOf.0","typeLabel":"string"},{"type":"null","description":"Per-step theme override; null = this step inherits the flow version's theme.","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].themeId.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].themeId","typeLabel":"string | null"},"content":{"type":"array","items":{"oneOf":[{"type":"object","required":["type","markdown"],"properties":{"type":{"type":"string","enum":["text"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.0.type","typeLabel":"enum\u003cstring>"},"markdown":{"type":"string","description":"A small markdown subset: paragraphs, `# `/`## ` headings (h1/h2 only — no h3+), `-`/`*` and `1.` lists, ``` code fences; inline `**bold**`, `*italic*`, `[text](url)`, and `{{ attribute_code | default: \"x\" }}` for user attributes. Anything outside this subset is SILENTLY normalized, not rejected: h3+ → h2; blockquotes flatten to paragraphs; tables, horizontal rules, strikethrough, inline images/code, and liquid filters other than `default` are dropped. Unsupported syntax won't round-trip — don't rely on it.","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.0.markdown","typeLabel":"string"},"object":{"default":"block","type":"string","enum":["block"],"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.0.object","typeLabel":"enum\u003cstring>"},"id":{"type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.0.id","typeLabel":"string"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","required":["type","url"],"properties":{"type":{"type":"string","enum":["image"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.1.type","typeLabel":"enum\u003cstring>"},"url":{"type":"string","minLength":1,"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.1.url","typeLabel":"string"},"object":{"default":"block","type":"string","enum":["block"],"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.1.object","typeLabel":"enum\u003cstring>"},"id":{"type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.1.id","typeLabel":"string"},"alt":{"type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.1.alt","typeLabel":"string"},"link":{"type":"object","properties":{"url":{"type":"string","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.1.link.url","typeLabel":"string"},"newTab":{"type":"boolean","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.1.link.newTab","typeLabel":"boolean"}},"required":["url"],"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.1.link","typeLabel":"object"},"width":{"type":"object","properties":{"unit":{"type":"string","enum":["percent","pixels"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.1.width.unit","typeLabel":"enum\u003cstring>"},"value":{"type":"number","minimum":0,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.1.width.value","typeLabel":"number"}},"required":["unit"],"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.1.width","typeLabel":"object"},"margin":{"type":"object","properties":{"enabled":{"type":"boolean","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.1.margin.enabled","typeLabel":"boolean"},"top":{"type":"number","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.1.margin.top","typeLabel":"number"},"bottom":{"type":"number","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.1.margin.bottom","typeLabel":"number"},"left":{"type":"number","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.1.margin.left","typeLabel":"number"},"right":{"type":"number","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.1.margin.right","typeLabel":"number"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.1.margin","typeLabel":"object"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.1","typeLabel":"object"},{"type":"object","required":["type","text"],"properties":{"type":{"type":"string","enum":["button"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.type","typeLabel":"enum\u003cstring>"},"text":{"type":"string","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.text","typeLabel":"string"},"object":{"default":"block","type":"string","enum":["block"],"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.object","typeLabel":"enum\u003cstring>"},"id":{"type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.id","typeLabel":"string"},"actions":{"type":"array","items":{"oneOf":[{"type":"object","required":["type","step"],"properties":{"type":{"type":"string","enum":["goto_step"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.actions.items.[INDEX].oneOf.0.type","typeLabel":"enum\u003cstring>"},"step":{"type":"string","description":"Target step: a step `key` declared elsewhere in the same write, or an existing step cvid. Resolved server-side to the cvid.","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.actions.items.[INDEX].oneOf.0.step","typeLabel":"string"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.actions.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","required":["type","content"],"properties":{"type":{"type":"string","enum":["start_content"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.actions.items.[INDEX].oneOf.1.type","typeLabel":"enum\u003cstring>"},"content":{"type":"string","description":"contentId of the flow or checklist to launch (an id from the content list) — a raw content id, NOT a step key (unlike goto_step). Must reference a flow or checklist (a banner / launcher / resource-center / tracker is rejected at write). The target must be PUBLISHED to actually start at runtime; an unknown/dangling id is rejected at validate.","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.actions.items.[INDEX].oneOf.1.content","typeLabel":"string"},"step":{"description":"Optional cvid of a step within the launched flow to start at.","type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.actions.items.[INDEX].oneOf.1.step","typeLabel":"string"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.actions.items.[INDEX].oneOf.1","typeLabel":"object"},{"type":"object","required":["type","url"],"properties":{"type":{"type":"string","enum":["navigate"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.actions.items.[INDEX].oneOf.2.type","typeLabel":"enum\u003cstring>"},"url":{"type":"string","description":"Absolute URL, or an app-relative path (\"/docs/x\") resolved against the origin the user is on — relative paths are the normal choice for in-app navigation.","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.actions.items.[INDEX].oneOf.2.url","typeLabel":"string"},"newTab":{"description":"Open the URL in a new browser tab instead of navigating the current one.","type":"boolean","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.actions.items.[INDEX].oneOf.2.newTab","typeLabel":"boolean"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.actions.items.[INDEX].oneOf.2","typeLabel":"object"},{"type":"object","description":"Dismiss the piece the action lives on. NOT accepted everywhere this union appears: a resource center has no dismiss (closing the panel is a UI affordance, not an action) and an announcement is marked seen, never dismissed — writes there are rejected (E1017), not ignored. Flows / checklists / launchers / banners all accept it.","required":["type"],"properties":{"type":{"type":"string","enum":["dismiss"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.actions.items.[INDEX].oneOf.3.type","typeLabel":"enum\u003cstring>"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.actions.items.[INDEX].oneOf.3","typeLabel":"object"},{"type":"object","description":"Read-back of an existing script action — scripts are not authorable through this API. Echo it back UNCHANGED (same script) when rewriting the surrounding list and the stored action is preserved; omitting it deletes it (action lists are full replacements). Authoring a new or edited script is rejected.","required":["type","script"],"properties":{"type":{"type":"string","enum":["run_javascript"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.actions.items.[INDEX].oneOf.4.type","typeLabel":"enum\u003cstring>"},"script":{"type":"string","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.actions.items.[INDEX].oneOf.4.script","typeLabel":"string"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.actions.items.[INDEX].oneOf.4","typeLabel":"object"},{"type":"object","description":"Echo-only placeholder for a stored action this schema cannot express (`note` = internal type). Echo it back to preserve the stored action; writing one fresh is rejected.","required":["type"],"properties":{"type":{"type":"string","enum":["unsupported"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.actions.items.[INDEX].oneOf.5.type","typeLabel":"enum\u003cstring>"},"note":{"type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.actions.items.[INDEX].oneOf.5.note","typeLabel":"string"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.actions.items.[INDEX].oneOf.5","typeLabel":"object"}],"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.actions.items.[INDEX]","typeLabel":"object"},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.actions","typeLabel":"object[]"},"disabledWhen":{"description":"REACTIVE slot — polled live in the browser (the button disables the moment the conditions match). Client-evaluable condition types only: attribute / current_url / element / text_input / text_filled / time_window; event / segment / content_state are rejected (E1017).","type":"array","items":{"oneOf":[{"type":"object","required":["type","match","conditions"],"properties":{"type":{"type":"string","enum":["group"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.0.type","typeLabel":"enum\u003cstring>"},"match":{"type":"string","enum":["all","any"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.0.match","typeLabel":"enum\u003cstring>"},"conditions":{"minItems":1,"type":"array","items":{"$circularRef":"8bf0052c-740f-4e24-a54d-effeac73767f"},"description":"The grouped conditions — at least one. An EMPTY group is not \"no filter\": it never matches, so next to an AND it makes the whole rule unmatchable, and writing one is rejected. A version saved with an empty group in the BUILDER still reads back with it (validate warns); writing that list back is refused until the group is filled or dropped.","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.0.conditions","typeLabel":"array"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","required":["type","scope","attribute","op"],"properties":{"type":{"type":"string","enum":["attribute"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.1.type","typeLabel":"enum\u003cstring>"},"scope":{"type":"string","enum":["user","company","companyMembership"],"description":"Which entity owns the attribute — `user` (the end user), `company`, or `companyMembership`. Same value as the attribute definition's `scope` (see the attribute definitions list); required to disambiguate a codeName that exists in more than one scope.","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.1.scope","typeLabel":"enum\u003cstring>"},"attribute":{"type":"string","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.1.attribute","typeLabel":"string"},"op":{"type":"string","enum":["is","not","contains","not_contains","starts_with","ends_with","any","empty","lt","lte","gt","gte","between","true","false","includes_any","includes_all","not_includes_any","not_includes_all","less_than","exactly","more_than","before","on","after"],"description":"Operator — the allowed set depends on the attribute dataType. String: is | not | contains | not_contains | starts_with | ends_with | any | empty. Number: is | not | lt | lte | gt | gte | between | any | empty. Boolean: true | false | any | empty. List: includes_any | includes_all | not_includes_any | not_includes_all | any | empty. DateTime: less_than | exactly | more_than (relative — `value` is a number of days) | before | on | after (`value` is an absolute date) | any | empty. The relative ops are ONE-SIDED bounds around (now − N days): `less_than N` = the date is AFTER now−N — so it also matches every FUTURE date, and on a future-dated attribute (a trial end, a renewal date) it is NOT \"within the last N days\"; `more_than N` = the date is BEFORE now−N. **\"Signed up in the last N days\" therefore needs BOTH bounds** — `less_than N` AND `more_than 0` in one `all` group; `less_than N` alone silently includes anyone whose date is in the future (a mis-mapped trial-end column, a clock/timezone slip), and those are exactly the users a new-user audience must not contain (observed in testing). Negative N shifts the bound into the future: the rolling \"within the NEXT 7 days\" window is `less_than` value \"0\" AND `more_than` value \"-7\" (two conditions, both required). The relative ops are DAY-granularity only — no unit field; for hour/minute windows use an `event` condition with a `within` (which has a `unit`).","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.1.op","typeLabel":"enum\u003cstring>"},"value":{"description":"The comparison value (string / number-as-string / date). Omit for any/empty/true/false.","type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.1.value","typeLabel":"string"},"value2":{"description":"Upper bound for the `between` operator (`value` is the lower bound).","type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.1.value2","typeLabel":"string"},"values":{"description":"Values for the List operators (includes_any / includes_all / …).","type":"array","items":{"type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.1.values.items.[INDEX]","typeLabel":"string"},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.1.values","typeLabel":"string[]"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.1","typeLabel":"object"},{"type":"object","required":["type","segment","in"],"properties":{"type":{"type":"string","enum":["segment"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.2.type","typeLabel":"enum\u003cstring>"},"segment":{"type":"string","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.2.segment","typeLabel":"string"},"in":{"type":"boolean","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.2.in","typeLabel":"boolean"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.2","typeLabel":"object"},{"type":"object","required":["type","includes"],"properties":{"type":{"type":"string","enum":["current_url"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.3.type","typeLabel":"enum\u003cstring>"},"includes":{"type":"array","items":{"type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.3.includes.items.[INDEX]","typeLabel":"string"},"description":"URL patterns (anchored whole-url match, NOT substring/regex). `*` = wildcard within one url part; `:name` = one path segment. A bare `*` (i.e. `[\"*\"]`) matches EVERY page on every host incl. deep paths — the canonical always-on / whole-site pattern (use it when content should be available everywhere). Scope it down instead with: `*/` (homepage only — path exactly `/`), `*/pricing` (one page), `*/app/*` (a section + below), `host.com/*` (any page on a specific host). Multiple patterns are OR-matched: the URL matches this list if it matches ANY one pattern (so \"/tasks OR /dashboard\" is one condition with both patterns here — no group needed).","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.3.includes","typeLabel":"string[]"},"excludes":{"description":"URL patterns to exclude (same syntax as includes); excludes win over includes.","type":"array","items":{"type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.3.excludes.items.[INDEX]","typeLabel":"string"},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.3.excludes","typeLabel":"string[]"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.3","typeLabel":"object"},{"type":"object","required":["type","state"],"properties":{"type":{"type":"string","enum":["element"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.4.type","typeLabel":"enum\u003cstring>"},"state":{"type":"string","enum":["present","hidden","disabled","enabled","clicked","unclicked"],"description":"`present` means NOT CLIPPED AWAY: the element is in the DOM and its box lies inside the viewport / its scroll ancestors — scrolled off-screen or `display:none` never satisfies it (and `hidden` is its negation). It is NOT \"the user can see something there\": an EMPTY, zero-height placeholder node satisfies `present` (observed in testing: a checklist task keyed on an initially-empty `\u003cp>` status line ticked itself the moment the checklist appeared, before the shopper did anything). So do not use element presence as a proxy for \"the app has said something\": most apps keep the container mounted and only fill in its text. Match the TEXT instead (`target.text` + `present`, or the negation trick: the old text `hidden`). Appearances shorter than about a second can be missed entirely. `disabled`/`enabled` read the element disabled state at evaluation time. **`clicked` means \"clicked since page load AND the element is STILL in the DOM right now\"** — both halves, re-checked every evaluation. The click memory latches (the listener attaches the FIRST time the condition is evaluated, so earlier clicks are invisible, and the memory survives a re-render), but the element lookup is redone each poll. Two consequences, one of them silent: (1) **an element that UNMOUNTS on click can NEVER satisfy it** — the click lands, the element vanishes, the lookup fails from then on and the condition stays false forever with no error (observed in testing: a tracker on a button that clears its own toolbar counted ZERO real clicks); (2) an element that unmounts and REMOUNTS satisfies it again, so a tracker gated on it fires once per remount — not once per page load. Unlike `present`, this lookup does NOT require viewport visibility: scrolling the target off-screen keeps `clicked` true. `unclicked` negates the same pair, so it is also false while the element is absent. To count a COMPLETED action, condition on what the app shows afterwards (a success toast, a state change) rather than `clicked` on the button that starts it.","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.4.state","typeLabel":"enum\u003cstring>"},"target":{"type":"object","properties":{"selector":{"type":"string","minLength":1,"description":"A stable CSS selector for the element, on the page or inside a same-origin iframe (written relative to the frame's own document). The runtime targets the FIRST match — so either make the selector unique, or pair a stable non-unique selector with `nth` to pick the intended match. A non-unique selector with no `nth` targets the first (often wrong) element and the tooltip silently won't render.","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.4.target.selector","typeLabel":"string"},"text":{"description":"Optional refinement of `selector`. Requires the targeted element's visible text to equal this (exact match, after trim) — use it to pin a specific content/state (e.g. a stable id whose displayed text you want to match: id + text). It refines the element chosen by `selector`/`nth`; on its own it does NOT search among multiple matches, so disambiguate a non-unique selector with `nth`, not `text` alone.","type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.4.target.text","typeLabel":"string"},"nth":{"description":"Optional refinement of `selector`. 0-based index to pick which match when the selector isn't unique — e.g. a stable selector matching 3 elements + `nth: 1` targets the 2nd, giving a unique result. Matches are taken in document order (as they appear in the page HTML). Range 0–4 — only the first 5 matches are addressable; a larger value is rejected.","type":"integer","minimum":0,"maximum":4,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.4.target.nth","typeLabel":"integer"}},"required":["selector"],"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.4.target","typeLabel":"object"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.4","typeLabel":"object"},{"type":"object","required":["type","content","state"],"properties":{"type":{"type":"string","enum":["content_state"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.5.type","typeLabel":"enum\u003cstring>"},"content":{"type":"string","description":"contentId of the FLOW or CHECKLIST whose per-user state to check (an id from the content list). Only flows and checklists record this state — referencing a banner / launcher / resource-center / tracker is rejected at write.","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.5.content","typeLabel":"string"},"state":{"type":"string","enum":["seen","unseen","completed","uncompleted","active","inactive"],"description":"The referenced flow/checklist's state for THIS user. seen = started at least once (for a flow, TRUE from the moment it opens; for a checklist, TRUE only once the user EXPANDS the panel — a `initialDisplay: \"button\"` checklist whose launcher is never clicked stays unseen forever); unseen = never started; active = currently open/running; inactive = NOT currently running (covers both never-started and ran-then-closed); completed = reached a goal/completion step; uncompleted = not completed. To gate piece B until flow A has run AND closed (the usual \"show next thing after the welcome flow\" sequencing), use `seen` AND `inactive` together — `seen` alone fires while A is still open (B piles on top), and `completed` alone strands users who skip/dismiss A.","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.5.state","typeLabel":"enum\u003cstring>"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.5","typeLabel":"object"},{"type":"object","required":["type","event"],"properties":{"type":{"type":"string","enum":["event"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.6.type","typeLabel":"enum\u003cstring>"},"event":{"type":"string","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.6.event","typeLabel":"string"},"count":{"description":"How many times the event must have occurred. Omit it for the common case \"the event has happened\" (treated as at_least 1). Set `op`/`n` for a threshold (`between` needs `n` and `n2`). `at_least`/`between` require n ≥ 1; use `at_most`/`exactly` with 0 for \"never happened\".","type":"object","properties":{"op":{"type":"string","enum":["at_least","at_most","exactly","between"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.6.count.op","typeLabel":"enum\u003cstring>"},"n":{"type":"integer","minimum":0,"maximum":9007199254740991,"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.6.count.n","typeLabel":"integer"},"n2":{"type":"integer","minimum":0,"maximum":9007199254740991,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.6.count.n2","typeLabel":"integer"}},"required":["op","n"],"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.6.count","typeLabel":"object"},"within":{"description":"Optional time window for the event count. Omit it (or use `any_time`) to count over all time — \"the event has ever happened\". Any other `op` (`in_the_last` / `more_than` / `between`) requires BOTH `value` and `unit`, and `between` also `value2` — rejected at write otherwise.","type":"object","properties":{"op":{"type":"string","enum":["in_the_last","more_than","between","any_time"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.6.within.op","typeLabel":"enum\u003cstring>"},"value":{"type":"number","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.6.within.value","typeLabel":"number"},"value2":{"type":"number","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.6.within.value2","typeLabel":"number"},"unit":{"type":"string","enum":["seconds","minutes","hours","days"],"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.6.within.unit","typeLabel":"enum\u003cstring>"}},"required":["op"],"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.6.within","typeLabel":"object"},"scope":{"description":"Whose event activity to count (default `current_user`). `current_user` = only this user's own events. `current_user_in_company` = this user's events, but counted within their currently-associated company context (needs the user associated to a company via `group()` / the company-membership API). `any_user_in_company` = events by ANY user in this user's company — account-level activity (e.g. \"anyone on the account has done X\"). The two company scopes require the user to be in a company or they never match.","type":"string","enum":["current_user","current_user_in_company","any_user_in_company"],"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.6.scope","typeLabel":"enum\u003cstring>"},"where":{"type":"array","items":{"oneOf":[{"type":"object","required":["type","attribute","op"],"properties":{"type":{"type":"string","enum":["event_attribute"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.0.type","typeLabel":"enum\u003cstring>"},"attribute":{"type":"string","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.0.attribute","typeLabel":"string"},"op":{"type":"string","enum":["is","not","contains","not_contains","starts_with","ends_with","any","empty","lt","lte","gt","gte","between","true","false","includes_any","includes_all","not_includes_any","not_includes_all","less_than","exactly","more_than","before","on","after"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.0.op","typeLabel":"enum\u003cstring>"},"value":{"type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.0.value","typeLabel":"string"},"value2":{"type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.0.value2","typeLabel":"string"},"values":{"type":"array","items":{"type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.0.values.items.[INDEX]","typeLabel":"string"},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.0.values","typeLabel":"string[]"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","required":["type","match","conditions"],"properties":{"type":{"type":"string","enum":["group"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.1.type","typeLabel":"enum\u003cstring>"},"match":{"type":"string","enum":["all","any"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.1.match","typeLabel":"enum\u003cstring>"},"conditions":{"minItems":1,"type":"array","items":{"$circularRef":"7599b088-c1e6-49bf-842c-0ee9fa13f591"},"description":"The grouped conditions — at least one. An EMPTY group is not \"no filter\": it never matches, so next to an AND it makes the whole rule unmatchable, and writing one is rejected. A version saved with an empty group in the BUILDER still reads back with it (validate warns); writing that list back is refused until the group is filled or dropped.","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.1.conditions","typeLabel":"array"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.1","typeLabel":"object"}],"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.6.where.items.[INDEX]","typeLabel":"object"},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.6.where","typeLabel":"object[]"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.6","typeLabel":"object"},{"type":"object","required":["type","op"],"properties":{"type":{"type":"string","enum":["text_input"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.7.type","typeLabel":"enum\u003cstring>"},"op":{"type":"string","enum":["is","not","contains","not_contains","starts_with","ends_with","match","unmatch","any","empty"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.7.op","typeLabel":"enum\u003cstring>"},"target":{"type":"object","properties":{"selector":{"type":"string","minLength":1,"description":"A stable CSS selector for the element, on the page or inside a same-origin iframe (written relative to the frame's own document). The runtime targets the FIRST match — so either make the selector unique, or pair a stable non-unique selector with `nth` to pick the intended match. A non-unique selector with no `nth` targets the first (often wrong) element and the tooltip silently won't render.","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.7.target.selector","typeLabel":"string"},"text":{"description":"Optional refinement of `selector`. Requires the targeted element's visible text to equal this (exact match, after trim) — use it to pin a specific content/state (e.g. a stable id whose displayed text you want to match: id + text). It refines the element chosen by `selector`/`nth`; on its own it does NOT search among multiple matches, so disambiguate a non-unique selector with `nth`, not `text` alone.","type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.7.target.text","typeLabel":"string"},"nth":{"description":"Optional refinement of `selector`. 0-based index to pick which match when the selector isn't unique — e.g. a stable selector matching 3 elements + `nth: 1` targets the 2nd, giving a unique result. Matches are taken in document order (as they appear in the page HTML). Range 0–4 — only the first 5 matches are addressable; a larger value is rejected.","type":"integer","minimum":0,"maximum":4,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.7.target.nth","typeLabel":"integer"}},"required":["selector"],"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.7.target","typeLabel":"object"},"value":{"type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.7.value","typeLabel":"string"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.7","typeLabel":"object"},{"type":"object","required":["type"],"properties":{"type":{"type":"string","enum":["text_filled"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.8.type","typeLabel":"enum\u003cstring>"},"target":{"type":"object","properties":{"selector":{"type":"string","minLength":1,"description":"A stable CSS selector for the element, on the page or inside a same-origin iframe (written relative to the frame's own document). The runtime targets the FIRST match — so either make the selector unique, or pair a stable non-unique selector with `nth` to pick the intended match. A non-unique selector with no `nth` targets the first (often wrong) element and the tooltip silently won't render.","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.8.target.selector","typeLabel":"string"},"text":{"description":"Optional refinement of `selector`. Requires the targeted element's visible text to equal this (exact match, after trim) — use it to pin a specific content/state (e.g. a stable id whose displayed text you want to match: id + text). It refines the element chosen by `selector`/`nth`; on its own it does NOT search among multiple matches, so disambiguate a non-unique selector with `nth`, not `text` alone.","type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.8.target.text","typeLabel":"string"},"nth":{"description":"Optional refinement of `selector`. 0-based index to pick which match when the selector isn't unique — e.g. a stable selector matching 3 elements + `nth: 1` targets the 2nd, giving a unique result. Matches are taken in document order (as they appear in the page HTML). Range 0–4 — only the first 5 matches are addressable; a larger value is rejected.","type":"integer","minimum":0,"maximum":4,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.8.target.nth","typeLabel":"integer"}},"required":["selector"],"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.8.target","typeLabel":"object"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.8","typeLabel":"object"},{"type":"object","required":["type","start"],"properties":{"type":{"type":"string","enum":["time_window"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.9.type","typeLabel":"enum\u003cstring>"},"start":{"type":"string","description":"Window start (ISO datetime). REQUIRED — the runtime never matches a window without a start, so an end-only window is rejected at write. For \"until X\" semantics, set start to any past instant and end to X.","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.9.start","typeLabel":"string"},"end":{"description":"Window end (ISO datetime). Omit for an open-ended \"from start onwards\" window.","type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.9.end","typeLabel":"string"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.9","typeLabel":"object"},{"type":"object","description":"Read-side placeholder for a stored condition this API cannot express (`note` says what it stands for — usually a DEAD condition the runtime never matches: a deleted attribute/event, an end-only time window). It cannot be written back (the placeholder carries no data to preserve): echoing it is rejected. Either remove it from the list you write — an explicit choice that DELETES the stored condition; mind that a never-matching node inside an AND list pins the whole rule to \"never fires\", so deleting it can bring the remaining conditions to life — or repair the original condition in the Usertour builder first.","required":["type"],"properties":{"type":{"type":"string","enum":["unsupported"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.10.type","typeLabel":"enum\u003cstring>"},"note":{"type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.10.note","typeLabel":"string"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.10","typeLabel":"object"}],"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX]","typeLabel":"object"},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen","typeLabel":"object[]"},"hiddenWhen":{"description":"REACTIVE slot — polled live in the browser (the button shows/hides as conditions change). Same client-evaluable-only rule as `disabledWhen`.","type":"array","items":{"oneOf":[{"type":"object","required":["type","match","conditions"],"properties":{"type":{"type":"string","enum":["group"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.0.type","typeLabel":"enum\u003cstring>"},"match":{"type":"string","enum":["all","any"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.0.match","typeLabel":"enum\u003cstring>"},"conditions":{"minItems":1,"type":"array","items":{"$circularRef":"8bf0052c-740f-4e24-a54d-effeac73767f"},"description":"The grouped conditions — at least one. An EMPTY group is not \"no filter\": it never matches, so next to an AND it makes the whole rule unmatchable, and writing one is rejected. A version saved with an empty group in the BUILDER still reads back with it (validate warns); writing that list back is refused until the group is filled or dropped.","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.0.conditions","typeLabel":"array"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","required":["type","scope","attribute","op"],"properties":{"type":{"type":"string","enum":["attribute"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.1.type","typeLabel":"enum\u003cstring>"},"scope":{"type":"string","enum":["user","company","companyMembership"],"description":"Which entity owns the attribute — `user` (the end user), `company`, or `companyMembership`. Same value as the attribute definition's `scope` (see the attribute definitions list); required to disambiguate a codeName that exists in more than one scope.","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.1.scope","typeLabel":"enum\u003cstring>"},"attribute":{"type":"string","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.1.attribute","typeLabel":"string"},"op":{"type":"string","enum":["is","not","contains","not_contains","starts_with","ends_with","any","empty","lt","lte","gt","gte","between","true","false","includes_any","includes_all","not_includes_any","not_includes_all","less_than","exactly","more_than","before","on","after"],"description":"Operator — the allowed set depends on the attribute dataType. String: is | not | contains | not_contains | starts_with | ends_with | any | empty. Number: is | not | lt | lte | gt | gte | between | any | empty. Boolean: true | false | any | empty. List: includes_any | includes_all | not_includes_any | not_includes_all | any | empty. DateTime: less_than | exactly | more_than (relative — `value` is a number of days) | before | on | after (`value` is an absolute date) | any | empty. The relative ops are ONE-SIDED bounds around (now − N days): `less_than N` = the date is AFTER now−N — so it also matches every FUTURE date, and on a future-dated attribute (a trial end, a renewal date) it is NOT \"within the last N days\"; `more_than N` = the date is BEFORE now−N. **\"Signed up in the last N days\" therefore needs BOTH bounds** — `less_than N` AND `more_than 0` in one `all` group; `less_than N` alone silently includes anyone whose date is in the future (a mis-mapped trial-end column, a clock/timezone slip), and those are exactly the users a new-user audience must not contain (observed in testing). Negative N shifts the bound into the future: the rolling \"within the NEXT 7 days\" window is `less_than` value \"0\" AND `more_than` value \"-7\" (two conditions, both required). The relative ops are DAY-granularity only — no unit field; for hour/minute windows use an `event` condition with a `within` (which has a `unit`).","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.1.op","typeLabel":"enum\u003cstring>"},"value":{"description":"The comparison value (string / number-as-string / date). Omit for any/empty/true/false.","type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.1.value","typeLabel":"string"},"value2":{"description":"Upper bound for the `between` operator (`value` is the lower bound).","type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.1.value2","typeLabel":"string"},"values":{"description":"Values for the List operators (includes_any / includes_all / …).","type":"array","items":{"type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.1.values.items.[INDEX]","typeLabel":"string"},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.1.values","typeLabel":"string[]"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.1","typeLabel":"object"},{"type":"object","required":["type","segment","in"],"properties":{"type":{"type":"string","enum":["segment"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.2.type","typeLabel":"enum\u003cstring>"},"segment":{"type":"string","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.2.segment","typeLabel":"string"},"in":{"type":"boolean","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.2.in","typeLabel":"boolean"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.2","typeLabel":"object"},{"type":"object","required":["type","includes"],"properties":{"type":{"type":"string","enum":["current_url"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.3.type","typeLabel":"enum\u003cstring>"},"includes":{"type":"array","items":{"type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.3.includes.items.[INDEX]","typeLabel":"string"},"description":"URL patterns (anchored whole-url match, NOT substring/regex). `*` = wildcard within one url part; `:name` = one path segment. A bare `*` (i.e. `[\"*\"]`) matches EVERY page on every host incl. deep paths — the canonical always-on / whole-site pattern (use it when content should be available everywhere). Scope it down instead with: `*/` (homepage only — path exactly `/`), `*/pricing` (one page), `*/app/*` (a section + below), `host.com/*` (any page on a specific host). Multiple patterns are OR-matched: the URL matches this list if it matches ANY one pattern (so \"/tasks OR /dashboard\" is one condition with both patterns here — no group needed).","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.3.includes","typeLabel":"string[]"},"excludes":{"description":"URL patterns to exclude (same syntax as includes); excludes win over includes.","type":"array","items":{"type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.3.excludes.items.[INDEX]","typeLabel":"string"},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.3.excludes","typeLabel":"string[]"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.3","typeLabel":"object"},{"type":"object","required":["type","state"],"properties":{"type":{"type":"string","enum":["element"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.4.type","typeLabel":"enum\u003cstring>"},"state":{"type":"string","enum":["present","hidden","disabled","enabled","clicked","unclicked"],"description":"`present` means NOT CLIPPED AWAY: the element is in the DOM and its box lies inside the viewport / its scroll ancestors — scrolled off-screen or `display:none` never satisfies it (and `hidden` is its negation). It is NOT \"the user can see something there\": an EMPTY, zero-height placeholder node satisfies `present` (observed in testing: a checklist task keyed on an initially-empty `\u003cp>` status line ticked itself the moment the checklist appeared, before the shopper did anything). So do not use element presence as a proxy for \"the app has said something\": most apps keep the container mounted and only fill in its text. Match the TEXT instead (`target.text` + `present`, or the negation trick: the old text `hidden`). Appearances shorter than about a second can be missed entirely. `disabled`/`enabled` read the element disabled state at evaluation time. **`clicked` means \"clicked since page load AND the element is STILL in the DOM right now\"** — both halves, re-checked every evaluation. The click memory latches (the listener attaches the FIRST time the condition is evaluated, so earlier clicks are invisible, and the memory survives a re-render), but the element lookup is redone each poll. Two consequences, one of them silent: (1) **an element that UNMOUNTS on click can NEVER satisfy it** — the click lands, the element vanishes, the lookup fails from then on and the condition stays false forever with no error (observed in testing: a tracker on a button that clears its own toolbar counted ZERO real clicks); (2) an element that unmounts and REMOUNTS satisfies it again, so a tracker gated on it fires once per remount — not once per page load. Unlike `present`, this lookup does NOT require viewport visibility: scrolling the target off-screen keeps `clicked` true. `unclicked` negates the same pair, so it is also false while the element is absent. To count a COMPLETED action, condition on what the app shows afterwards (a success toast, a state change) rather than `clicked` on the button that starts it.","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.4.state","typeLabel":"enum\u003cstring>"},"target":{"type":"object","properties":{"selector":{"type":"string","minLength":1,"description":"A stable CSS selector for the element, on the page or inside a same-origin iframe (written relative to the frame's own document). The runtime targets the FIRST match — so either make the selector unique, or pair a stable non-unique selector with `nth` to pick the intended match. A non-unique selector with no `nth` targets the first (often wrong) element and the tooltip silently won't render.","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.4.target.selector","typeLabel":"string"},"text":{"description":"Optional refinement of `selector`. Requires the targeted element's visible text to equal this (exact match, after trim) — use it to pin a specific content/state (e.g. a stable id whose displayed text you want to match: id + text). It refines the element chosen by `selector`/`nth`; on its own it does NOT search among multiple matches, so disambiguate a non-unique selector with `nth`, not `text` alone.","type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.4.target.text","typeLabel":"string"},"nth":{"description":"Optional refinement of `selector`. 0-based index to pick which match when the selector isn't unique — e.g. a stable selector matching 3 elements + `nth: 1` targets the 2nd, giving a unique result. Matches are taken in document order (as they appear in the page HTML). Range 0–4 — only the first 5 matches are addressable; a larger value is rejected.","type":"integer","minimum":0,"maximum":4,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.4.target.nth","typeLabel":"integer"}},"required":["selector"],"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.4.target","typeLabel":"object"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.4","typeLabel":"object"},{"type":"object","required":["type","content","state"],"properties":{"type":{"type":"string","enum":["content_state"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.5.type","typeLabel":"enum\u003cstring>"},"content":{"type":"string","description":"contentId of the FLOW or CHECKLIST whose per-user state to check (an id from the content list). Only flows and checklists record this state — referencing a banner / launcher / resource-center / tracker is rejected at write.","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.5.content","typeLabel":"string"},"state":{"type":"string","enum":["seen","unseen","completed","uncompleted","active","inactive"],"description":"The referenced flow/checklist's state for THIS user. seen = started at least once (for a flow, TRUE from the moment it opens; for a checklist, TRUE only once the user EXPANDS the panel — a `initialDisplay: \"button\"` checklist whose launcher is never clicked stays unseen forever); unseen = never started; active = currently open/running; inactive = NOT currently running (covers both never-started and ran-then-closed); completed = reached a goal/completion step; uncompleted = not completed. To gate piece B until flow A has run AND closed (the usual \"show next thing after the welcome flow\" sequencing), use `seen` AND `inactive` together — `seen` alone fires while A is still open (B piles on top), and `completed` alone strands users who skip/dismiss A.","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.5.state","typeLabel":"enum\u003cstring>"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.5","typeLabel":"object"},{"type":"object","required":["type","event"],"properties":{"type":{"type":"string","enum":["event"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.6.type","typeLabel":"enum\u003cstring>"},"event":{"type":"string","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.6.event","typeLabel":"string"},"count":{"description":"How many times the event must have occurred. Omit it for the common case \"the event has happened\" (treated as at_least 1). Set `op`/`n` for a threshold (`between` needs `n` and `n2`). `at_least`/`between` require n ≥ 1; use `at_most`/`exactly` with 0 for \"never happened\".","type":"object","properties":{"op":{"type":"string","enum":["at_least","at_most","exactly","between"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.6.count.op","typeLabel":"enum\u003cstring>"},"n":{"type":"integer","minimum":0,"maximum":9007199254740991,"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.6.count.n","typeLabel":"integer"},"n2":{"type":"integer","minimum":0,"maximum":9007199254740991,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.6.count.n2","typeLabel":"integer"}},"required":["op","n"],"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.6.count","typeLabel":"object"},"within":{"description":"Optional time window for the event count. Omit it (or use `any_time`) to count over all time — \"the event has ever happened\". Any other `op` (`in_the_last` / `more_than` / `between`) requires BOTH `value` and `unit`, and `between` also `value2` — rejected at write otherwise.","type":"object","properties":{"op":{"type":"string","enum":["in_the_last","more_than","between","any_time"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.6.within.op","typeLabel":"enum\u003cstring>"},"value":{"type":"number","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.6.within.value","typeLabel":"number"},"value2":{"type":"number","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.6.within.value2","typeLabel":"number"},"unit":{"type":"string","enum":["seconds","minutes","hours","days"],"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.6.within.unit","typeLabel":"enum\u003cstring>"}},"required":["op"],"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.6.within","typeLabel":"object"},"scope":{"description":"Whose event activity to count (default `current_user`). `current_user` = only this user's own events. `current_user_in_company` = this user's events, but counted within their currently-associated company context (needs the user associated to a company via `group()` / the company-membership API). `any_user_in_company` = events by ANY user in this user's company — account-level activity (e.g. \"anyone on the account has done X\"). The two company scopes require the user to be in a company or they never match.","type":"string","enum":["current_user","current_user_in_company","any_user_in_company"],"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.6.scope","typeLabel":"enum\u003cstring>"},"where":{"type":"array","items":{"oneOf":[{"type":"object","required":["type","attribute","op"],"properties":{"type":{"type":"string","enum":["event_attribute"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.0.type","typeLabel":"enum\u003cstring>"},"attribute":{"type":"string","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.0.attribute","typeLabel":"string"},"op":{"type":"string","enum":["is","not","contains","not_contains","starts_with","ends_with","any","empty","lt","lte","gt","gte","between","true","false","includes_any","includes_all","not_includes_any","not_includes_all","less_than","exactly","more_than","before","on","after"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.0.op","typeLabel":"enum\u003cstring>"},"value":{"type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.0.value","typeLabel":"string"},"value2":{"type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.0.value2","typeLabel":"string"},"values":{"type":"array","items":{"type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.0.values.items.[INDEX]","typeLabel":"string"},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.0.values","typeLabel":"string[]"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","required":["type","match","conditions"],"properties":{"type":{"type":"string","enum":["group"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.1.type","typeLabel":"enum\u003cstring>"},"match":{"type":"string","enum":["all","any"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.1.match","typeLabel":"enum\u003cstring>"},"conditions":{"minItems":1,"type":"array","items":{"$circularRef":"7599b088-c1e6-49bf-842c-0ee9fa13f591"},"description":"The grouped conditions — at least one. An EMPTY group is not \"no filter\": it never matches, so next to an AND it makes the whole rule unmatchable, and writing one is rejected. A version saved with an empty group in the BUILDER still reads back with it (validate warns); writing that list back is refused until the group is filled or dropped.","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.1.conditions","typeLabel":"array"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.1","typeLabel":"object"}],"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.6.where.items.[INDEX]","typeLabel":"object"},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.6.where","typeLabel":"object[]"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.6","typeLabel":"object"},{"type":"object","required":["type","op"],"properties":{"type":{"type":"string","enum":["text_input"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.7.type","typeLabel":"enum\u003cstring>"},"op":{"type":"string","enum":["is","not","contains","not_contains","starts_with","ends_with","match","unmatch","any","empty"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.7.op","typeLabel":"enum\u003cstring>"},"target":{"type":"object","properties":{"selector":{"type":"string","minLength":1,"description":"A stable CSS selector for the element, on the page or inside a same-origin iframe (written relative to the frame's own document). The runtime targets the FIRST match — so either make the selector unique, or pair a stable non-unique selector with `nth` to pick the intended match. A non-unique selector with no `nth` targets the first (often wrong) element and the tooltip silently won't render.","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.7.target.selector","typeLabel":"string"},"text":{"description":"Optional refinement of `selector`. Requires the targeted element's visible text to equal this (exact match, after trim) — use it to pin a specific content/state (e.g. a stable id whose displayed text you want to match: id + text). It refines the element chosen by `selector`/`nth`; on its own it does NOT search among multiple matches, so disambiguate a non-unique selector with `nth`, not `text` alone.","type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.7.target.text","typeLabel":"string"},"nth":{"description":"Optional refinement of `selector`. 0-based index to pick which match when the selector isn't unique — e.g. a stable selector matching 3 elements + `nth: 1` targets the 2nd, giving a unique result. Matches are taken in document order (as they appear in the page HTML). Range 0–4 — only the first 5 matches are addressable; a larger value is rejected.","type":"integer","minimum":0,"maximum":4,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.7.target.nth","typeLabel":"integer"}},"required":["selector"],"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.7.target","typeLabel":"object"},"value":{"type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.7.value","typeLabel":"string"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.7","typeLabel":"object"},{"type":"object","required":["type"],"properties":{"type":{"type":"string","enum":["text_filled"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.8.type","typeLabel":"enum\u003cstring>"},"target":{"type":"object","properties":{"selector":{"type":"string","minLength":1,"description":"A stable CSS selector for the element, on the page or inside a same-origin iframe (written relative to the frame's own document). The runtime targets the FIRST match — so either make the selector unique, or pair a stable non-unique selector with `nth` to pick the intended match. A non-unique selector with no `nth` targets the first (often wrong) element and the tooltip silently won't render.","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.8.target.selector","typeLabel":"string"},"text":{"description":"Optional refinement of `selector`. Requires the targeted element's visible text to equal this (exact match, after trim) — use it to pin a specific content/state (e.g. a stable id whose displayed text you want to match: id + text). It refines the element chosen by `selector`/`nth`; on its own it does NOT search among multiple matches, so disambiguate a non-unique selector with `nth`, not `text` alone.","type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.8.target.text","typeLabel":"string"},"nth":{"description":"Optional refinement of `selector`. 0-based index to pick which match when the selector isn't unique — e.g. a stable selector matching 3 elements + `nth: 1` targets the 2nd, giving a unique result. Matches are taken in document order (as they appear in the page HTML). Range 0–4 — only the first 5 matches are addressable; a larger value is rejected.","type":"integer","minimum":0,"maximum":4,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.8.target.nth","typeLabel":"integer"}},"required":["selector"],"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.8.target","typeLabel":"object"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.8","typeLabel":"object"},{"type":"object","required":["type","start"],"properties":{"type":{"type":"string","enum":["time_window"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.9.type","typeLabel":"enum\u003cstring>"},"start":{"type":"string","description":"Window start (ISO datetime). REQUIRED — the runtime never matches a window without a start, so an end-only window is rejected at write. For \"until X\" semantics, set start to any past instant and end to X.","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.9.start","typeLabel":"string"},"end":{"description":"Window end (ISO datetime). Omit for an open-ended \"from start onwards\" window.","type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.9.end","typeLabel":"string"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.9","typeLabel":"object"},{"type":"object","description":"Read-side placeholder for a stored condition this API cannot express (`note` says what it stands for — usually a DEAD condition the runtime never matches: a deleted attribute/event, an end-only time window). It cannot be written back (the placeholder carries no data to preserve): echoing it is rejected. Either remove it from the list you write — an explicit choice that DELETES the stored condition; mind that a never-matching node inside an AND list pins the whole rule to \"never fires\", so deleting it can bring the remaining conditions to life — or repair the original condition in the Usertour builder first.","required":["type"],"properties":{"type":{"type":"string","enum":["unsupported"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.10.type","typeLabel":"enum\u003cstring>"},"note":{"type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.10.note","typeLabel":"string"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.10","typeLabel":"object"}],"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX]","typeLabel":"object"},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen","typeLabel":"object[]"},"variant":{"type":"string","enum":["primary","secondary"],"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.variant","typeLabel":"enum\u003cstring>"},"margin":{"type":"object","properties":{"enabled":{"type":"boolean","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.margin.enabled","typeLabel":"boolean"},"top":{"type":"number","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.margin.top","typeLabel":"number"},"bottom":{"type":"number","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.margin.bottom","typeLabel":"number"},"left":{"type":"number","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.margin.left","typeLabel":"number"},"right":{"type":"number","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.margin.right","typeLabel":"number"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.margin","typeLabel":"object"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2","typeLabel":"object"},{"type":"object","required":["type","url"],"properties":{"type":{"type":"string","enum":["embed"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.3.type","typeLabel":"enum\u003cstring>"},"url":{"type":"string","minLength":1,"description":"Paste the page's normal URL (e.g. a youtube.com/watch link) — on write it is resolved through the standard oEmbed provider registry (YouTube, Vimeo, Loom, Figma, …) and the provider's official embed markup is stored, so you never hand-build /embed/ URLs. A URL no provider claims is iframed as-is — it renders only if that site allows being framed (no X-Frame-Options/CSP block).","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.3.url","typeLabel":"string"},"object":{"default":"block","type":"string","enum":["block"],"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.3.object","typeLabel":"enum\u003cstring>"},"id":{"type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.3.id","typeLabel":"string"},"width":{"type":"object","properties":{"unit":{"type":"string","enum":["percent","pixels"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.3.width.unit","typeLabel":"enum\u003cstring>"},"value":{"type":"number","minimum":0,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.3.width.value","typeLabel":"number"}},"required":["unit"],"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.3.width","typeLabel":"object"},"height":{"description":"Embed height. Optional ONLY for provider embeds (YouTube/Vimeo/… size themselves by aspect ratio); a URL with NO oEmbed provider has no ratio, and omitting a pixel height leaves the iframe at the browser's built-in default — a strip ~150px tall, almost never the intended size (validate warns). For plain-iframe URLs always set `{ \"unit\": \"pixels\", \"value\": … }`.","type":"object","properties":{"unit":{"type":"string","enum":["percent","pixels"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.3.height.unit","typeLabel":"enum\u003cstring>"},"value":{"type":"number","minimum":0,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.3.height.value","typeLabel":"number"}},"required":["unit"],"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.3.height","typeLabel":"object"},"margin":{"type":"object","properties":{"enabled":{"type":"boolean","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.3.margin.enabled","typeLabel":"boolean"},"top":{"type":"number","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.3.margin.top","typeLabel":"number"},"bottom":{"type":"number","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.3.margin.bottom","typeLabel":"number"},"left":{"type":"number","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.3.margin.left","typeLabel":"number"},"right":{"type":"number","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.3.margin.right","typeLabel":"number"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.3.margin","typeLabel":"object"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.3","typeLabel":"object"},{"type":"object","required":["type","question"],"properties":{"type":{"type":"string","enum":["question"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.type","typeLabel":"enum\u003cstring>"},"question":{"oneOf":[{"type":"object","required":["kind","name"],"properties":{"kind":{"type":"string","enum":["nps"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.question.oneOf.0.kind","typeLabel":"enum\u003cstring>"},"name":{"type":"string","description":"The question's internal name / analytics label (it is the `questionName` on captured responses). It is NOT rendered to the user — the widget shows only the input (scale / options / text field), not this string. To show a visible question prompt, add a `text` block in the SAME step before the question block; a question with only a `name` renders as bare options with no question text.","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.question.oneOf.0.name","typeLabel":"string"},"cvid":{"type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.question.oneOf.0.cvid","typeLabel":"string"},"lowLabel":{"type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.question.oneOf.0.lowLabel","typeLabel":"string"},"highLabel":{"type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.question.oneOf.0.highLabel","typeLabel":"string"},"bindAttribute":{"description":"Optional: codeName of an EXISTING attribute (create the attribute definition first) to ALSO save this answer onto the user for targeting/segmentation — use the codeName, NOT the id. The write does not check it, but the version validation WARNS when the attribute is missing or its dataType mismatches the answer — read warnings. A wrong code that slips through silently captures nothing at runtime. Match the attribute dataType to the answer: number (nps / rating), string (single-select choice), list (multi-select choice). Leaving it unset still records the answer as a response event — bind only when you need to target/segment on it.","type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.question.oneOf.0.bindAttribute","typeLabel":"string"}},"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.question.oneOf.0","typeLabel":"object"},{"type":"object","required":["kind","name","style","range"],"properties":{"kind":{"type":"string","enum":["rating"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.question.oneOf.1.kind","typeLabel":"enum\u003cstring>"},"name":{"type":"string","description":"The question's internal name / analytics label (it is the `questionName` on captured responses). It is NOT rendered to the user — the widget shows only the input (scale / options / text field), not this string. To show a visible question prompt, add a `text` block in the SAME step before the question block; a question with only a `name` renders as bare options with no question text.","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.question.oneOf.1.name","typeLabel":"string"},"style":{"type":"string","enum":["star","scale"],"description":"star = star rating; scale = a numeric scale. A \"scale\" question IS a rating with style:\"scale\" — there is no separate \"scale\" kind.","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.question.oneOf.1.style","typeLabel":"enum\u003cstring>"},"range":{"type":"object","properties":{"low":{"type":"number","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.question.oneOf.1.range.low","typeLabel":"number"},"high":{"type":"number","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.question.oneOf.1.range.high","typeLabel":"number"}},"required":["low","high"],"description":"Numeric range, e.g. { low: 1, high: 5 }.","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.question.oneOf.1.range","typeLabel":"object"},"cvid":{"type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.question.oneOf.1.cvid","typeLabel":"string"},"lowLabel":{"type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.question.oneOf.1.lowLabel","typeLabel":"string"},"highLabel":{"type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.question.oneOf.1.highLabel","typeLabel":"string"},"bindAttribute":{"description":"Optional: codeName of an EXISTING attribute (create the attribute definition first) to ALSO save this answer onto the user for targeting/segmentation — use the codeName, NOT the id. The write does not check it, but the version validation WARNS when the attribute is missing or its dataType mismatches the answer — read warnings. A wrong code that slips through silently captures nothing at runtime. Match the attribute dataType to the answer: number (nps / rating), string (single-select choice), list (multi-select choice). Leaving it unset still records the answer as a response event — bind only when you need to target/segment on it.","type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.question.oneOf.1.bindAttribute","typeLabel":"string"}},"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.question.oneOf.1","typeLabel":"object"},{"type":"object","required":["kind","name","multiline"],"properties":{"kind":{"type":"string","enum":["text"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.question.oneOf.2.kind","typeLabel":"enum\u003cstring>"},"name":{"type":"string","description":"The question's internal name / analytics label (it is the `questionName` on captured responses). It is NOT rendered to the user — the widget shows only the input (scale / options / text field), not this string. To show a visible question prompt, add a `text` block in the SAME step before the question block; a question with only a `name` renders as bare options with no question text.","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.question.oneOf.2.name","typeLabel":"string"},"multiline":{"type":"boolean","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.question.oneOf.2.multiline","typeLabel":"boolean"},"cvid":{"type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.question.oneOf.2.cvid","typeLabel":"string"},"placeholder":{"type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.question.oneOf.2.placeholder","typeLabel":"string"},"buttonText":{"type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.question.oneOf.2.buttonText","typeLabel":"string"},"required":{"description":"Require an answer before submit. ONLY `text` supports this — nps / rating / choice cannot be marked required.","type":"boolean","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.question.oneOf.2.required","typeLabel":"boolean"},"bindAttribute":{"description":"Optional: codeName of an EXISTING attribute (create the attribute definition first) to ALSO save this answer onto the user for targeting/segmentation — use the codeName, NOT the id. The write does not check it, but the version validation WARNS when the attribute is missing or its dataType mismatches the answer — read warnings. A wrong code that slips through silently captures nothing at runtime. Match the attribute dataType to the answer: number (nps / rating), string (single-select choice), list (multi-select choice). Leaving it unset still records the answer as a response event — bind only when you need to target/segment on it.","type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.question.oneOf.2.bindAttribute","typeLabel":"string"}},"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.question.oneOf.2","typeLabel":"object"},{"type":"object","required":["kind","name","options","allowMultiple"],"properties":{"kind":{"type":"string","enum":["choice"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.question.oneOf.3.kind","typeLabel":"enum\u003cstring>"},"name":{"type":"string","description":"The question's internal name / analytics label (it is the `questionName` on captured responses). It is NOT rendered to the user — the widget shows only the input (scale / options / text field), not this string. To show a visible question prompt, add a `text` block in the SAME step before the question block; a question with only a `name` renders as bare options with no question text.","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.question.oneOf.3.name","typeLabel":"string"},"options":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.question.oneOf.3.options.items.[INDEX].label","typeLabel":"string"},"value":{"type":"string","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.question.oneOf.3.options.items.[INDEX].value","typeLabel":"string"}},"required":["label","value"],"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.question.oneOf.3.options.items.[INDEX]","typeLabel":"object"},"description":"Each option has a human-facing `label` and a stored `value` — the `value` is what gets recorded/bound as the answer.","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.question.oneOf.3.options","typeLabel":"object[]"},"allowMultiple":{"type":"boolean","description":"false = single-select, true = multi-select. A multi-select answer needs a `list`-typed bound attribute.","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.question.oneOf.3.allowMultiple","typeLabel":"boolean"},"cvid":{"type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.question.oneOf.3.cvid","typeLabel":"string"},"enableOther":{"type":"boolean","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.question.oneOf.3.enableOther","typeLabel":"boolean"},"otherPlaceholder":{"type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.question.oneOf.3.otherPlaceholder","typeLabel":"string"},"shuffle":{"type":"boolean","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.question.oneOf.3.shuffle","typeLabel":"boolean"},"buttonText":{"type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.question.oneOf.3.buttonText","typeLabel":"string"},"bindAttribute":{"description":"Optional: codeName of an EXISTING attribute (create the attribute definition first) to ALSO save this answer onto the user for targeting/segmentation — use the codeName, NOT the id. The write does not check it, but the version validation WARNS when the attribute is missing or its dataType mismatches the answer — read warnings. A wrong code that slips through silently captures nothing at runtime. Match the attribute dataType to the answer: number (nps / rating), string (single-select choice), list (multi-select choice). Leaving it unset still records the answer as a response event — bind only when you need to target/segment on it.","type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.question.oneOf.3.bindAttribute","typeLabel":"string"}},"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.question.oneOf.3","typeLabel":"object"}],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.question","typeLabel":"object"},"object":{"default":"block","type":"string","enum":["block"],"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.object","typeLabel":"enum\u003cstring>"},"id":{"type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.id","typeLabel":"string"},"actions":{"description":"Actions that fire when this question is answered (on pick for nps/rating/single-select; on its Submit button for text/multi-select). Put a `goto_step` HERE to advance to the next step — without it the question records the answer but the flow does NOT advance (validate flags the next step \"not reachable\"). Do NOT add a separate `button` block just to advance: it doubles up with the question's own submit affordance.","type":"array","items":{"oneOf":[{"type":"object","required":["type","step"],"properties":{"type":{"type":"string","enum":["goto_step"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.actions.items.[INDEX].oneOf.0.type","typeLabel":"enum\u003cstring>"},"step":{"type":"string","description":"Target step: a step `key` declared elsewhere in the same write, or an existing step cvid. Resolved server-side to the cvid.","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.actions.items.[INDEX].oneOf.0.step","typeLabel":"string"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.actions.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","required":["type","content"],"properties":{"type":{"type":"string","enum":["start_content"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.actions.items.[INDEX].oneOf.1.type","typeLabel":"enum\u003cstring>"},"content":{"type":"string","description":"contentId of the flow or checklist to launch (an id from the content list) — a raw content id, NOT a step key (unlike goto_step). Must reference a flow or checklist (a banner / launcher / resource-center / tracker is rejected at write). The target must be PUBLISHED to actually start at runtime; an unknown/dangling id is rejected at validate.","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.actions.items.[INDEX].oneOf.1.content","typeLabel":"string"},"step":{"description":"Optional cvid of a step within the launched flow to start at.","type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.actions.items.[INDEX].oneOf.1.step","typeLabel":"string"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.actions.items.[INDEX].oneOf.1","typeLabel":"object"},{"type":"object","required":["type","url"],"properties":{"type":{"type":"string","enum":["navigate"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.actions.items.[INDEX].oneOf.2.type","typeLabel":"enum\u003cstring>"},"url":{"type":"string","description":"Absolute URL, or an app-relative path (\"/docs/x\") resolved against the origin the user is on — relative paths are the normal choice for in-app navigation.","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.actions.items.[INDEX].oneOf.2.url","typeLabel":"string"},"newTab":{"description":"Open the URL in a new browser tab instead of navigating the current one.","type":"boolean","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.actions.items.[INDEX].oneOf.2.newTab","typeLabel":"boolean"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.actions.items.[INDEX].oneOf.2","typeLabel":"object"},{"type":"object","description":"Dismiss the piece the action lives on. NOT accepted everywhere this union appears: a resource center has no dismiss (closing the panel is a UI affordance, not an action) and an announcement is marked seen, never dismissed — writes there are rejected (E1017), not ignored. Flows / checklists / launchers / banners all accept it.","required":["type"],"properties":{"type":{"type":"string","enum":["dismiss"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.actions.items.[INDEX].oneOf.3.type","typeLabel":"enum\u003cstring>"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.actions.items.[INDEX].oneOf.3","typeLabel":"object"},{"type":"object","description":"Read-back of an existing script action — scripts are not authorable through this API. Echo it back UNCHANGED (same script) when rewriting the surrounding list and the stored action is preserved; omitting it deletes it (action lists are full replacements). Authoring a new or edited script is rejected.","required":["type","script"],"properties":{"type":{"type":"string","enum":["run_javascript"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.actions.items.[INDEX].oneOf.4.type","typeLabel":"enum\u003cstring>"},"script":{"type":"string","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.actions.items.[INDEX].oneOf.4.script","typeLabel":"string"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.actions.items.[INDEX].oneOf.4","typeLabel":"object"},{"type":"object","description":"Echo-only placeholder for a stored action this schema cannot express (`note` = internal type). Echo it back to preserve the stored action; writing one fresh is rejected.","required":["type"],"properties":{"type":{"type":"string","enum":["unsupported"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.actions.items.[INDEX].oneOf.5.type","typeLabel":"enum\u003cstring>"},"note":{"type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.actions.items.[INDEX].oneOf.5.note","typeLabel":"string"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.actions.items.[INDEX].oneOf.5","typeLabel":"object"}],"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.actions.items.[INDEX]","typeLabel":"object"},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.actions","typeLabel":"object[]"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4","typeLabel":"object"},{"type":"object","description":"Lays 2+ blocks out side by side in one row. Top-level `content` blocks otherwise stack vertically — each is its own full-width row — so two `button` blocks placed directly in `content` render as two stacked rows, NOT a button pair. For a modal/tooltip footer with a Skip + primary button: one `columns` block with two `{ width: { unit: \"fill\" }, blocks: [...] }` entries, one button per column.","required":["type","columns"],"properties":{"type":{"type":"string","enum":["columns"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.5.type","typeLabel":"enum\u003cstring>"},"columns":{"type":"array","items":{"type":"object","properties":{"blocks":{"type":"array","items":{"$circularRef":"cbc2a478-9fbf-4840-91c6-77587e9b8cf5"},"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.5.columns.items.[INDEX].blocks","typeLabel":"array"},"width":{"type":"object","properties":{"unit":{"type":"string","enum":["percent","pixels","fill"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.5.columns.items.[INDEX].width.unit","typeLabel":"enum\u003cstring>"},"value":{"type":"number","minimum":0,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.5.columns.items.[INDEX].width.value","typeLabel":"number"}},"required":["unit"],"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.5.columns.items.[INDEX].width","typeLabel":"object"},"justify":{"description":"Horizontal alignment of this column's own block(s) within the column's width — use \"end\"/\"center\" to right-align or center a lone button (a single-column `columns` block).","type":"string","enum":["start","center","end","between","around","evenly"],"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.5.columns.items.[INDEX].justify","typeLabel":"enum\u003cstring>"},"align":{"type":"string","enum":["start","center","end","baseline"],"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.5.columns.items.[INDEX].align","typeLabel":"enum\u003cstring>"},"padding":{"type":"object","properties":{"enabled":{"type":"boolean","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.5.columns.items.[INDEX].padding.enabled","typeLabel":"boolean"},"top":{"type":"number","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.5.columns.items.[INDEX].padding.top","typeLabel":"number"},"bottom":{"type":"number","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.5.columns.items.[INDEX].padding.bottom","typeLabel":"number"},"left":{"type":"number","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.5.columns.items.[INDEX].padding.left","typeLabel":"number"},"right":{"type":"number","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.5.columns.items.[INDEX].padding.right","typeLabel":"number"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.5.columns.items.[INDEX].padding","typeLabel":"object"}},"required":["blocks"],"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.5.columns.items.[INDEX]","typeLabel":"object"},"description":"One entry per column, laid out left-to-right. Each column is a mini vertical stack of `blocks` (usually one).","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.5.columns","typeLabel":"object[]"},"object":{"default":"block","type":"string","enum":["block"],"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.5.object","typeLabel":"enum\u003cstring>"},"id":{"type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.5.id","typeLabel":"string"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.5","typeLabel":"object"},{"type":"object","required":["type"],"properties":{"type":{"type":"string","enum":["unsupported"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.6.type","typeLabel":"enum\u003cstring>"},"object":{"default":"block","type":"string","enum":["block"],"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.6.object","typeLabel":"enum\u003cstring>"},"id":{"type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.6.id","typeLabel":"string"},"note":{"type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.6.note","typeLabel":"string"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.6","typeLabel":"object"}],"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].content","typeLabel":"object[]"},"target":{"type":"object","properties":{"selector":{"type":"string","minLength":1,"description":"A stable CSS selector for the element, on the page or inside a same-origin iframe (written relative to the frame's own document). The runtime targets the FIRST match — so either make the selector unique, or pair a stable non-unique selector with `nth` to pick the intended match. A non-unique selector with no `nth` targets the first (often wrong) element and the tooltip silently won't render.","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].target.selector","typeLabel":"string"},"text":{"description":"Optional refinement of `selector`. Requires the targeted element's visible text to equal this (exact match, after trim) — use it to pin a specific content/state (e.g. a stable id whose displayed text you want to match: id + text). It refines the element chosen by `selector`/`nth`; on its own it does NOT search among multiple matches, so disambiguate a non-unique selector with `nth`, not `text` alone.","type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].target.text","typeLabel":"string"},"nth":{"description":"Optional refinement of `selector`. 0-based index to pick which match when the selector isn't unique — e.g. a stable selector matching 3 elements + `nth: 1` targets the 2nd, giving a unique result. Matches are taken in document order (as they appear in the page HTML). Range 0–4 — only the first 5 matches are addressable; a larger value is rejected.","type":"integer","minimum":0,"maximum":4,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].target.nth","typeLabel":"integer"}},"required":["selector"],"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].target","typeLabel":"object"},"placement":{"oneOf":[{"type":"object","description":"Two placement shapes, by step kind: a TOOLTIP (anchored to a `target`) uses `{ side, align, sideOffset?, alignOffset?, alignType? }` positioned relative to the element; a MODAL uses `{ position, offsetX?, offsetY? }` on a 9-cell viewport grid (e.g. `\"center\"`). Both may set `backdrop`; `blockTarget` is TOOLTIP-ONLY (a modal already covers the page) and additionally requires `backdrop: true` — it makes the backdrop swallow clicks on the highlighted element. A BUBBLE step is positioned by its THEME's bubble placement, so the only key it accepts here is `{ backdrop }` (positional keys are rejected — move the bubble by changing the theme); a HIDDEN step renders no UI and rejects `placement` entirely.","properties":{"side":{"description":"Which side of the target the tooltip sits on. OMIT side+align to auto-position (the tooltip picks a spot and flips to avoid the viewport edge — best when you can't see the element). Setting side (or align) pins that direction: the tooltip renders exactly there and no longer auto-flips, so only pin when the element is not near a screen edge. When READING a step back, check `alignType` first: under `auto` the side/align you see are just the auto starting position, not a pin.","type":"string","enum":["top","right","bottom","left"],"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].placement.oneOf.0.side","typeLabel":"enum\u003cstring>"},"align":{"description":"Alignment along the side. See `side`.","type":"string","enum":["start","center","end"],"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].placement.oneOf.0.align","typeLabel":"enum\u003cstring>"},"sideOffset":{"description":"Pixels between the target and the tooltip, along `side`.","type":"number","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].placement.oneOf.0.sideOffset","typeLabel":"number"},"alignOffset":{"description":"Pixel shift along the alignment axis. Only applies when `align` is `start` or `end` — at `center` alignment the runtime ignores it silently.","type":"number","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].placement.oneOf.0.alignOffset","typeLabel":"number"},"alignType":{"description":"Position mode. `auto` auto-positions and flips to avoid the viewport edge (ignoring side/align); `fixed` pins to side/align without flipping. Usually omit it: providing side/align implies `fixed`, and omitting them implies `auto`. Set it only to override that (e.g. `auto` while still passing a side/align you want ignored). Read-backs always carry concrete side/align even in `auto` mode (the auto starting position, bottom/center) — `alignType` is what governs, and `auto` still flips at runtime.","type":"string","enum":["auto","fixed"],"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].placement.oneOf.0.alignType","typeLabel":"enum\u003cstring>"},"backdrop":{"description":"Dim the rest of the page while this tooltip is up.","type":"boolean","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].placement.oneOf.0.backdrop","typeLabel":"boolean"},"blockTarget":{"description":"Make the backdrop swallow clicks on the highlighted element, so the user must use the tooltip. REQUIRES `backdrop: true` — on its own it does nothing (the renderer only consults it inside the backdrop branch).","type":"boolean","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].placement.oneOf.0.blockTarget","typeLabel":"boolean"}},"additionalProperties":false,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].placement.oneOf.0","typeLabel":"object"},{"type":"object","description":"Two placement shapes, by step kind: a TOOLTIP (anchored to a `target`) uses `{ side, align, sideOffset?, alignOffset?, alignType? }` positioned relative to the element; a MODAL uses `{ position, offsetX?, offsetY? }` on a 9-cell viewport grid (e.g. `\"center\"`). Both may set `backdrop`; `blockTarget` is TOOLTIP-ONLY (a modal already covers the page) and additionally requires `backdrop: true` — it makes the backdrop swallow clicks on the highlighted element. A BUBBLE step is positioned by its THEME's bubble placement, so the only key it accepts here is `{ backdrop }` (positional keys are rejected — move the bubble by changing the theme); a HIDDEN step renders no UI and rejects `placement` entirely.","required":["position"],"properties":{"position":{"type":"string","enum":["leftTop","centerTop","rightTop","leftCenter","center","rightCenter","leftBottom","centerBottom","rightBottom"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].placement.oneOf.1.position","typeLabel":"enum\u003cstring>"},"offsetX":{"description":"Pixel shift from the grid cell. Applies in every cell EXCEPT `position: \"center\"`, where both offsets are ignored silently.","type":"number","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].placement.oneOf.1.offsetX","typeLabel":"number"},"offsetY":{"description":"See `offsetX`.","type":"number","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].placement.oneOf.1.offsetY","typeLabel":"number"},"backdrop":{"type":"boolean","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].placement.oneOf.1.backdrop","typeLabel":"boolean"}},"additionalProperties":false,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].placement.oneOf.1","typeLabel":"object"}],"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].placement","typeLabel":"object"},"width":{"description":"Per-step width override in pixels (border-box outer width) — absent = the theme's surface width.","type":"number","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].width","typeLabel":"number"},"skippable":{"type":"boolean","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].skippable","typeLabel":"boolean"},"explicitCompletionStep":{"description":"Marks this step as the flow's completion point: reaching it counts the flow as COMPLETED (progress hits 100 and the completion event fires there), and later steps no longer report progress. With no step marked, only reaching the LAST step completes the flow — which is what a checklist task waiting on \"this flow completed\" depends on.","type":"boolean","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].explicitCompletionStep","typeLabel":"boolean"},"triggers":{"type":"array","items":{"type":"object","properties":{"do":{"type":"array","items":{"oneOf":[{"type":"object","required":["type","step"],"properties":{"type":{"type":"string","enum":["goto_step"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].do.items.[INDEX].oneOf.0.type","typeLabel":"enum\u003cstring>"},"step":{"type":"string","description":"Target step: a step `key` declared elsewhere in the same write, or an existing step cvid. Resolved server-side to the cvid.","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].do.items.[INDEX].oneOf.0.step","typeLabel":"string"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].do.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","required":["type","content"],"properties":{"type":{"type":"string","enum":["start_content"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].do.items.[INDEX].oneOf.1.type","typeLabel":"enum\u003cstring>"},"content":{"type":"string","description":"contentId of the flow or checklist to launch (an id from the content list) — a raw content id, NOT a step key (unlike goto_step). Must reference a flow or checklist (a banner / launcher / resource-center / tracker is rejected at write). The target must be PUBLISHED to actually start at runtime; an unknown/dangling id is rejected at validate.","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].do.items.[INDEX].oneOf.1.content","typeLabel":"string"},"step":{"description":"Optional cvid of a step within the launched flow to start at.","type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].do.items.[INDEX].oneOf.1.step","typeLabel":"string"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].do.items.[INDEX].oneOf.1","typeLabel":"object"},{"type":"object","required":["type","url"],"properties":{"type":{"type":"string","enum":["navigate"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].do.items.[INDEX].oneOf.2.type","typeLabel":"enum\u003cstring>"},"url":{"type":"string","description":"Absolute URL, or an app-relative path (\"/docs/x\") resolved against the origin the user is on — relative paths are the normal choice for in-app navigation.","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].do.items.[INDEX].oneOf.2.url","typeLabel":"string"},"newTab":{"description":"Open the URL in a new browser tab instead of navigating the current one.","type":"boolean","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].do.items.[INDEX].oneOf.2.newTab","typeLabel":"boolean"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].do.items.[INDEX].oneOf.2","typeLabel":"object"},{"type":"object","description":"Dismiss the piece the action lives on. NOT accepted everywhere this union appears: a resource center has no dismiss (closing the panel is a UI affordance, not an action) and an announcement is marked seen, never dismissed — writes there are rejected (E1017), not ignored. Flows / checklists / launchers / banners all accept it.","required":["type"],"properties":{"type":{"type":"string","enum":["dismiss"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].do.items.[INDEX].oneOf.3.type","typeLabel":"enum\u003cstring>"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].do.items.[INDEX].oneOf.3","typeLabel":"object"},{"type":"object","description":"Read-back of an existing script action — scripts are not authorable through this API. Echo it back UNCHANGED (same script) when rewriting the surrounding list and the stored action is preserved; omitting it deletes it (action lists are full replacements). Authoring a new or edited script is rejected.","required":["type","script"],"properties":{"type":{"type":"string","enum":["run_javascript"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].do.items.[INDEX].oneOf.4.type","typeLabel":"enum\u003cstring>"},"script":{"type":"string","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].do.items.[INDEX].oneOf.4.script","typeLabel":"string"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].do.items.[INDEX].oneOf.4","typeLabel":"object"},{"type":"object","description":"Echo-only placeholder for a stored action this schema cannot express (`note` = internal type). Echo it back to preserve the stored action; writing one fresh is rejected.","required":["type"],"properties":{"type":{"type":"string","enum":["unsupported"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].do.items.[INDEX].oneOf.5.type","typeLabel":"enum\u003cstring>"},"note":{"type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].do.items.[INDEX].oneOf.5.note","typeLabel":"string"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].do.items.[INDEX].oneOf.5","typeLabel":"object"}],"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].do.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].do","typeLabel":"object[]"},"when":{"description":"REACTIVE slot — polled live in the browser while the step is on screen, so it accepts only client-evaluable condition types: attribute / current_url / element / text_input / text_filled / time_window. Event / segment / content_state conditions are server-evaluated and rejected here (E1017). A trigger with NO `when` never fires (an empty set is \"not matched\", not \"always\").","type":"array","items":{"oneOf":[{"type":"object","required":["type","match","conditions"],"properties":{"type":{"type":"string","enum":["group"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.0.type","typeLabel":"enum\u003cstring>"},"match":{"type":"string","enum":["all","any"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.0.match","typeLabel":"enum\u003cstring>"},"conditions":{"minItems":1,"type":"array","items":{"$circularRef":"8bf0052c-740f-4e24-a54d-effeac73767f"},"description":"The grouped conditions — at least one. An EMPTY group is not \"no filter\": it never matches, so next to an AND it makes the whole rule unmatchable, and writing one is rejected. A version saved with an empty group in the BUILDER still reads back with it (validate warns); writing that list back is refused until the group is filled or dropped.","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.0.conditions","typeLabel":"array"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","required":["type","scope","attribute","op"],"properties":{"type":{"type":"string","enum":["attribute"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.1.type","typeLabel":"enum\u003cstring>"},"scope":{"type":"string","enum":["user","company","companyMembership"],"description":"Which entity owns the attribute — `user` (the end user), `company`, or `companyMembership`. Same value as the attribute definition's `scope` (see the attribute definitions list); required to disambiguate a codeName that exists in more than one scope.","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.1.scope","typeLabel":"enum\u003cstring>"},"attribute":{"type":"string","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.1.attribute","typeLabel":"string"},"op":{"type":"string","enum":["is","not","contains","not_contains","starts_with","ends_with","any","empty","lt","lte","gt","gte","between","true","false","includes_any","includes_all","not_includes_any","not_includes_all","less_than","exactly","more_than","before","on","after"],"description":"Operator — the allowed set depends on the attribute dataType. String: is | not | contains | not_contains | starts_with | ends_with | any | empty. Number: is | not | lt | lte | gt | gte | between | any | empty. Boolean: true | false | any | empty. List: includes_any | includes_all | not_includes_any | not_includes_all | any | empty. DateTime: less_than | exactly | more_than (relative — `value` is a number of days) | before | on | after (`value` is an absolute date) | any | empty. The relative ops are ONE-SIDED bounds around (now − N days): `less_than N` = the date is AFTER now−N — so it also matches every FUTURE date, and on a future-dated attribute (a trial end, a renewal date) it is NOT \"within the last N days\"; `more_than N` = the date is BEFORE now−N. **\"Signed up in the last N days\" therefore needs BOTH bounds** — `less_than N` AND `more_than 0` in one `all` group; `less_than N` alone silently includes anyone whose date is in the future (a mis-mapped trial-end column, a clock/timezone slip), and those are exactly the users a new-user audience must not contain (observed in testing). Negative N shifts the bound into the future: the rolling \"within the NEXT 7 days\" window is `less_than` value \"0\" AND `more_than` value \"-7\" (two conditions, both required). The relative ops are DAY-granularity only — no unit field; for hour/minute windows use an `event` condition with a `within` (which has a `unit`).","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.1.op","typeLabel":"enum\u003cstring>"},"value":{"description":"The comparison value (string / number-as-string / date). Omit for any/empty/true/false.","type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.1.value","typeLabel":"string"},"value2":{"description":"Upper bound for the `between` operator (`value` is the lower bound).","type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.1.value2","typeLabel":"string"},"values":{"description":"Values for the List operators (includes_any / includes_all / …).","type":"array","items":{"type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.1.values.items.[INDEX]","typeLabel":"string"},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.1.values","typeLabel":"string[]"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.1","typeLabel":"object"},{"type":"object","required":["type","segment","in"],"properties":{"type":{"type":"string","enum":["segment"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.2.type","typeLabel":"enum\u003cstring>"},"segment":{"type":"string","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.2.segment","typeLabel":"string"},"in":{"type":"boolean","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.2.in","typeLabel":"boolean"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.2","typeLabel":"object"},{"type":"object","required":["type","includes"],"properties":{"type":{"type":"string","enum":["current_url"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.3.type","typeLabel":"enum\u003cstring>"},"includes":{"type":"array","items":{"type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.3.includes.items.[INDEX]","typeLabel":"string"},"description":"URL patterns (anchored whole-url match, NOT substring/regex). `*` = wildcard within one url part; `:name` = one path segment. A bare `*` (i.e. `[\"*\"]`) matches EVERY page on every host incl. deep paths — the canonical always-on / whole-site pattern (use it when content should be available everywhere). Scope it down instead with: `*/` (homepage only — path exactly `/`), `*/pricing` (one page), `*/app/*` (a section + below), `host.com/*` (any page on a specific host). Multiple patterns are OR-matched: the URL matches this list if it matches ANY one pattern (so \"/tasks OR /dashboard\" is one condition with both patterns here — no group needed).","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.3.includes","typeLabel":"string[]"},"excludes":{"description":"URL patterns to exclude (same syntax as includes); excludes win over includes.","type":"array","items":{"type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.3.excludes.items.[INDEX]","typeLabel":"string"},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.3.excludes","typeLabel":"string[]"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.3","typeLabel":"object"},{"type":"object","required":["type","state"],"properties":{"type":{"type":"string","enum":["element"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.4.type","typeLabel":"enum\u003cstring>"},"state":{"type":"string","enum":["present","hidden","disabled","enabled","clicked","unclicked"],"description":"`present` means NOT CLIPPED AWAY: the element is in the DOM and its box lies inside the viewport / its scroll ancestors — scrolled off-screen or `display:none` never satisfies it (and `hidden` is its negation). It is NOT \"the user can see something there\": an EMPTY, zero-height placeholder node satisfies `present` (observed in testing: a checklist task keyed on an initially-empty `\u003cp>` status line ticked itself the moment the checklist appeared, before the shopper did anything). So do not use element presence as a proxy for \"the app has said something\": most apps keep the container mounted and only fill in its text. Match the TEXT instead (`target.text` + `present`, or the negation trick: the old text `hidden`). Appearances shorter than about a second can be missed entirely. `disabled`/`enabled` read the element disabled state at evaluation time. **`clicked` means \"clicked since page load AND the element is STILL in the DOM right now\"** — both halves, re-checked every evaluation. The click memory latches (the listener attaches the FIRST time the condition is evaluated, so earlier clicks are invisible, and the memory survives a re-render), but the element lookup is redone each poll. Two consequences, one of them silent: (1) **an element that UNMOUNTS on click can NEVER satisfy it** — the click lands, the element vanishes, the lookup fails from then on and the condition stays false forever with no error (observed in testing: a tracker on a button that clears its own toolbar counted ZERO real clicks); (2) an element that unmounts and REMOUNTS satisfies it again, so a tracker gated on it fires once per remount — not once per page load. Unlike `present`, this lookup does NOT require viewport visibility: scrolling the target off-screen keeps `clicked` true. `unclicked` negates the same pair, so it is also false while the element is absent. To count a COMPLETED action, condition on what the app shows afterwards (a success toast, a state change) rather than `clicked` on the button that starts it.","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.4.state","typeLabel":"enum\u003cstring>"},"target":{"type":"object","properties":{"selector":{"type":"string","minLength":1,"description":"A stable CSS selector for the element, on the page or inside a same-origin iframe (written relative to the frame's own document). The runtime targets the FIRST match — so either make the selector unique, or pair a stable non-unique selector with `nth` to pick the intended match. A non-unique selector with no `nth` targets the first (often wrong) element and the tooltip silently won't render.","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.4.target.selector","typeLabel":"string"},"text":{"description":"Optional refinement of `selector`. Requires the targeted element's visible text to equal this (exact match, after trim) — use it to pin a specific content/state (e.g. a stable id whose displayed text you want to match: id + text). It refines the element chosen by `selector`/`nth`; on its own it does NOT search among multiple matches, so disambiguate a non-unique selector with `nth`, not `text` alone.","type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.4.target.text","typeLabel":"string"},"nth":{"description":"Optional refinement of `selector`. 0-based index to pick which match when the selector isn't unique — e.g. a stable selector matching 3 elements + `nth: 1` targets the 2nd, giving a unique result. Matches are taken in document order (as they appear in the page HTML). Range 0–4 — only the first 5 matches are addressable; a larger value is rejected.","type":"integer","minimum":0,"maximum":4,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.4.target.nth","typeLabel":"integer"}},"required":["selector"],"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.4.target","typeLabel":"object"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.4","typeLabel":"object"},{"type":"object","required":["type","content","state"],"properties":{"type":{"type":"string","enum":["content_state"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.5.type","typeLabel":"enum\u003cstring>"},"content":{"type":"string","description":"contentId of the FLOW or CHECKLIST whose per-user state to check (an id from the content list). Only flows and checklists record this state — referencing a banner / launcher / resource-center / tracker is rejected at write.","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.5.content","typeLabel":"string"},"state":{"type":"string","enum":["seen","unseen","completed","uncompleted","active","inactive"],"description":"The referenced flow/checklist's state for THIS user. seen = started at least once (for a flow, TRUE from the moment it opens; for a checklist, TRUE only once the user EXPANDS the panel — a `initialDisplay: \"button\"` checklist whose launcher is never clicked stays unseen forever); unseen = never started; active = currently open/running; inactive = NOT currently running (covers both never-started and ran-then-closed); completed = reached a goal/completion step; uncompleted = not completed. To gate piece B until flow A has run AND closed (the usual \"show next thing after the welcome flow\" sequencing), use `seen` AND `inactive` together — `seen` alone fires while A is still open (B piles on top), and `completed` alone strands users who skip/dismiss A.","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.5.state","typeLabel":"enum\u003cstring>"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.5","typeLabel":"object"},{"type":"object","required":["type","event"],"properties":{"type":{"type":"string","enum":["event"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.6.type","typeLabel":"enum\u003cstring>"},"event":{"type":"string","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.6.event","typeLabel":"string"},"count":{"description":"How many times the event must have occurred. Omit it for the common case \"the event has happened\" (treated as at_least 1). Set `op`/`n` for a threshold (`between` needs `n` and `n2`). `at_least`/`between` require n ≥ 1; use `at_most`/`exactly` with 0 for \"never happened\".","type":"object","properties":{"op":{"type":"string","enum":["at_least","at_most","exactly","between"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.6.count.op","typeLabel":"enum\u003cstring>"},"n":{"type":"integer","minimum":0,"maximum":9007199254740991,"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.6.count.n","typeLabel":"integer"},"n2":{"type":"integer","minimum":0,"maximum":9007199254740991,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.6.count.n2","typeLabel":"integer"}},"required":["op","n"],"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.6.count","typeLabel":"object"},"within":{"description":"Optional time window for the event count. Omit it (or use `any_time`) to count over all time — \"the event has ever happened\". Any other `op` (`in_the_last` / `more_than` / `between`) requires BOTH `value` and `unit`, and `between` also `value2` — rejected at write otherwise.","type":"object","properties":{"op":{"type":"string","enum":["in_the_last","more_than","between","any_time"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.6.within.op","typeLabel":"enum\u003cstring>"},"value":{"type":"number","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.6.within.value","typeLabel":"number"},"value2":{"type":"number","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.6.within.value2","typeLabel":"number"},"unit":{"type":"string","enum":["seconds","minutes","hours","days"],"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.6.within.unit","typeLabel":"enum\u003cstring>"}},"required":["op"],"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.6.within","typeLabel":"object"},"scope":{"description":"Whose event activity to count (default `current_user`). `current_user` = only this user's own events. `current_user_in_company` = this user's events, but counted within their currently-associated company context (needs the user associated to a company via `group()` / the company-membership API). `any_user_in_company` = events by ANY user in this user's company — account-level activity (e.g. \"anyone on the account has done X\"). The two company scopes require the user to be in a company or they never match.","type":"string","enum":["current_user","current_user_in_company","any_user_in_company"],"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.6.scope","typeLabel":"enum\u003cstring>"},"where":{"type":"array","items":{"oneOf":[{"type":"object","required":["type","attribute","op"],"properties":{"type":{"type":"string","enum":["event_attribute"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.0.type","typeLabel":"enum\u003cstring>"},"attribute":{"type":"string","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.0.attribute","typeLabel":"string"},"op":{"type":"string","enum":["is","not","contains","not_contains","starts_with","ends_with","any","empty","lt","lte","gt","gte","between","true","false","includes_any","includes_all","not_includes_any","not_includes_all","less_than","exactly","more_than","before","on","after"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.0.op","typeLabel":"enum\u003cstring>"},"value":{"type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.0.value","typeLabel":"string"},"value2":{"type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.0.value2","typeLabel":"string"},"values":{"type":"array","items":{"type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.0.values.items.[INDEX]","typeLabel":"string"},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.0.values","typeLabel":"string[]"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","required":["type","match","conditions"],"properties":{"type":{"type":"string","enum":["group"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.1.type","typeLabel":"enum\u003cstring>"},"match":{"type":"string","enum":["all","any"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.1.match","typeLabel":"enum\u003cstring>"},"conditions":{"minItems":1,"type":"array","items":{"$circularRef":"7599b088-c1e6-49bf-842c-0ee9fa13f591"},"description":"The grouped conditions — at least one. An EMPTY group is not \"no filter\": it never matches, so next to an AND it makes the whole rule unmatchable, and writing one is rejected. A version saved with an empty group in the BUILDER still reads back with it (validate warns); writing that list back is refused until the group is filled or dropped.","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.1.conditions","typeLabel":"array"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.1","typeLabel":"object"}],"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.6.where.items.[INDEX]","typeLabel":"object"},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.6.where","typeLabel":"object[]"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.6","typeLabel":"object"},{"type":"object","required":["type","op"],"properties":{"type":{"type":"string","enum":["text_input"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.7.type","typeLabel":"enum\u003cstring>"},"op":{"type":"string","enum":["is","not","contains","not_contains","starts_with","ends_with","match","unmatch","any","empty"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.7.op","typeLabel":"enum\u003cstring>"},"target":{"type":"object","properties":{"selector":{"type":"string","minLength":1,"description":"A stable CSS selector for the element, on the page or inside a same-origin iframe (written relative to the frame's own document). The runtime targets the FIRST match — so either make the selector unique, or pair a stable non-unique selector with `nth` to pick the intended match. A non-unique selector with no `nth` targets the first (often wrong) element and the tooltip silently won't render.","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.7.target.selector","typeLabel":"string"},"text":{"description":"Optional refinement of `selector`. Requires the targeted element's visible text to equal this (exact match, after trim) — use it to pin a specific content/state (e.g. a stable id whose displayed text you want to match: id + text). It refines the element chosen by `selector`/`nth`; on its own it does NOT search among multiple matches, so disambiguate a non-unique selector with `nth`, not `text` alone.","type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.7.target.text","typeLabel":"string"},"nth":{"description":"Optional refinement of `selector`. 0-based index to pick which match when the selector isn't unique — e.g. a stable selector matching 3 elements + `nth: 1` targets the 2nd, giving a unique result. Matches are taken in document order (as they appear in the page HTML). Range 0–4 — only the first 5 matches are addressable; a larger value is rejected.","type":"integer","minimum":0,"maximum":4,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.7.target.nth","typeLabel":"integer"}},"required":["selector"],"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.7.target","typeLabel":"object"},"value":{"type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.7.value","typeLabel":"string"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.7","typeLabel":"object"},{"type":"object","required":["type"],"properties":{"type":{"type":"string","enum":["text_filled"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.8.type","typeLabel":"enum\u003cstring>"},"target":{"type":"object","properties":{"selector":{"type":"string","minLength":1,"description":"A stable CSS selector for the element, on the page or inside a same-origin iframe (written relative to the frame's own document). The runtime targets the FIRST match — so either make the selector unique, or pair a stable non-unique selector with `nth` to pick the intended match. A non-unique selector with no `nth` targets the first (often wrong) element and the tooltip silently won't render.","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.8.target.selector","typeLabel":"string"},"text":{"description":"Optional refinement of `selector`. Requires the targeted element's visible text to equal this (exact match, after trim) — use it to pin a specific content/state (e.g. a stable id whose displayed text you want to match: id + text). It refines the element chosen by `selector`/`nth`; on its own it does NOT search among multiple matches, so disambiguate a non-unique selector with `nth`, not `text` alone.","type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.8.target.text","typeLabel":"string"},"nth":{"description":"Optional refinement of `selector`. 0-based index to pick which match when the selector isn't unique — e.g. a stable selector matching 3 elements + `nth: 1` targets the 2nd, giving a unique result. Matches are taken in document order (as they appear in the page HTML). Range 0–4 — only the first 5 matches are addressable; a larger value is rejected.","type":"integer","minimum":0,"maximum":4,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.8.target.nth","typeLabel":"integer"}},"required":["selector"],"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.8.target","typeLabel":"object"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.8","typeLabel":"object"},{"type":"object","required":["type","start"],"properties":{"type":{"type":"string","enum":["time_window"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.9.type","typeLabel":"enum\u003cstring>"},"start":{"type":"string","description":"Window start (ISO datetime). REQUIRED — the runtime never matches a window without a start, so an end-only window is rejected at write. For \"until X\" semantics, set start to any past instant and end to X.","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.9.start","typeLabel":"string"},"end":{"description":"Window end (ISO datetime). Omit for an open-ended \"from start onwards\" window.","type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.9.end","typeLabel":"string"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.9","typeLabel":"object"},{"type":"object","description":"Read-side placeholder for a stored condition this API cannot express (`note` says what it stands for — usually a DEAD condition the runtime never matches: a deleted attribute/event, an end-only time window). It cannot be written back (the placeholder carries no data to preserve): echoing it is rejected. Either remove it from the list you write — an explicit choice that DELETES the stored condition; mind that a never-matching node inside an AND list pins the whole rule to \"never fires\", so deleting it can bring the remaining conditions to life — or repair the original condition in the Usertour builder first.","required":["type"],"properties":{"type":{"type":"string","enum":["unsupported"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.10.type","typeLabel":"enum\u003cstring>"},"note":{"type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.10.note","typeLabel":"string"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.10","typeLabel":"object"}],"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX]","typeLabel":"object"},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].when","typeLabel":"object[]"},"waitSeconds":{"description":"Delay in SECONDS between the `when` conditions matching and the `do` actions firing. The timer arms the first time `when` matches and the actions fire after the wait EVEN IF the conditions have since stopped matching (the match is latched, not re-checked). Capped at 300 seconds by the runtime (a larger value is clamped).","type":"number","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX].waitSeconds","typeLabel":"number"}},"required":["do"],"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers.items.[INDEX]","typeLabel":"object"},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].triggers","typeLabel":"object[]"},"onClick":{"description":"Actions that run when the user clicks the step's TARGET ELEMENT on the page (click-to-advance) — distinct from a `button` block, whose actions fire on a button rendered inside the step. `tooltip` steps only: the other kinds have no target element to click, and the write rejects `onClick` on them.","type":"array","items":{"oneOf":[{"type":"object","required":["type","step"],"properties":{"type":{"type":"string","enum":["goto_step"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].onClick.items.[INDEX].oneOf.0.type","typeLabel":"enum\u003cstring>"},"step":{"type":"string","description":"Target step: a step `key` declared elsewhere in the same write, or an existing step cvid. Resolved server-side to the cvid.","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].onClick.items.[INDEX].oneOf.0.step","typeLabel":"string"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].onClick.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","required":["type","content"],"properties":{"type":{"type":"string","enum":["start_content"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].onClick.items.[INDEX].oneOf.1.type","typeLabel":"enum\u003cstring>"},"content":{"type":"string","description":"contentId of the flow or checklist to launch (an id from the content list) — a raw content id, NOT a step key (unlike goto_step). Must reference a flow or checklist (a banner / launcher / resource-center / tracker is rejected at write). The target must be PUBLISHED to actually start at runtime; an unknown/dangling id is rejected at validate.","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].onClick.items.[INDEX].oneOf.1.content","typeLabel":"string"},"step":{"description":"Optional cvid of a step within the launched flow to start at.","type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].onClick.items.[INDEX].oneOf.1.step","typeLabel":"string"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].onClick.items.[INDEX].oneOf.1","typeLabel":"object"},{"type":"object","required":["type","url"],"properties":{"type":{"type":"string","enum":["navigate"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].onClick.items.[INDEX].oneOf.2.type","typeLabel":"enum\u003cstring>"},"url":{"type":"string","description":"Absolute URL, or an app-relative path (\"/docs/x\") resolved against the origin the user is on — relative paths are the normal choice for in-app navigation.","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].onClick.items.[INDEX].oneOf.2.url","typeLabel":"string"},"newTab":{"description":"Open the URL in a new browser tab instead of navigating the current one.","type":"boolean","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].onClick.items.[INDEX].oneOf.2.newTab","typeLabel":"boolean"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].onClick.items.[INDEX].oneOf.2","typeLabel":"object"},{"type":"object","description":"Dismiss the piece the action lives on. NOT accepted everywhere this union appears: a resource center has no dismiss (closing the panel is a UI affordance, not an action) and an announcement is marked seen, never dismissed — writes there are rejected (E1017), not ignored. Flows / checklists / launchers / banners all accept it.","required":["type"],"properties":{"type":{"type":"string","enum":["dismiss"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].onClick.items.[INDEX].oneOf.3.type","typeLabel":"enum\u003cstring>"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].onClick.items.[INDEX].oneOf.3","typeLabel":"object"},{"type":"object","description":"Read-back of an existing script action — scripts are not authorable through this API. Echo it back UNCHANGED (same script) when rewriting the surrounding list and the stored action is preserved; omitting it deletes it (action lists are full replacements). Authoring a new or edited script is rejected.","required":["type","script"],"properties":{"type":{"type":"string","enum":["run_javascript"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].onClick.items.[INDEX].oneOf.4.type","typeLabel":"enum\u003cstring>"},"script":{"type":"string","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].onClick.items.[INDEX].oneOf.4.script","typeLabel":"string"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].onClick.items.[INDEX].oneOf.4","typeLabel":"object"},{"type":"object","description":"Echo-only placeholder for a stored action this schema cannot express (`note` = internal type). Echo it back to preserve the stored action; writing one fresh is rejected.","required":["type"],"properties":{"type":{"type":"string","enum":["unsupported"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].onClick.items.[INDEX].oneOf.5.type","typeLabel":"enum\u003cstring>"},"note":{"type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].onClick.items.[INDEX].oneOf.5.note","typeLabel":"string"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].onClick.items.[INDEX].oneOf.5","typeLabel":"object"}],"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].onClick.items.[INDEX]","typeLabel":"object"},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].onClick","typeLabel":"object[]"},"advanced":{"type":"object","properties":{"hasUnsupported":{"type":"boolean","description":"true = this step carries stored configuration this API cannot express (e.g. an auto-recorded element fingerprint). Read-only signal: echoing the step back preserves that configuration untouched; it is not editable here.","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].advanced.hasUnsupported","typeLabel":"boolean"}},"required":["hasUnsupported"],"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX].advanced","typeLabel":"object"}},"required":["object","id","cvid","name","type","sequence","themeId","content"],"uniqueKey":"environments.items.[INDEX].publishedVersion.steps.items.[INDEX]","typeLabel":"object"},"uniqueKey":"environments.items.[INDEX].publishedVersion.steps","typeLabel":"object[]"},"startRules":{"type":"object","properties":{"when":{"description":"Start conditions (full replacement when present). Omit to keep the existing conditions and change only the settings.","type":"array","items":{"oneOf":[{"type":"object","required":["type","match","conditions"],"properties":{"type":{"type":"string","enum":["group"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.when.items.[INDEX].oneOf.0.type","typeLabel":"enum\u003cstring>"},"match":{"type":"string","enum":["all","any"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.when.items.[INDEX].oneOf.0.match","typeLabel":"enum\u003cstring>"},"conditions":{"minItems":1,"type":"array","items":{"$circularRef":"8bf0052c-740f-4e24-a54d-effeac73767f"},"description":"The grouped conditions — at least one. An EMPTY group is not \"no filter\": it never matches, so next to an AND it makes the whole rule unmatchable, and writing one is rejected. A version saved with an empty group in the BUILDER still reads back with it (validate warns); writing that list back is refused until the group is filled or dropped.","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.when.items.[INDEX].oneOf.0.conditions","typeLabel":"array"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.when.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","required":["type","scope","attribute","op"],"properties":{"type":{"type":"string","enum":["attribute"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.when.items.[INDEX].oneOf.1.type","typeLabel":"enum\u003cstring>"},"scope":{"type":"string","enum":["user","company","companyMembership"],"description":"Which entity owns the attribute — `user` (the end user), `company`, or `companyMembership`. Same value as the attribute definition's `scope` (see the attribute definitions list); required to disambiguate a codeName that exists in more than one scope.","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.when.items.[INDEX].oneOf.1.scope","typeLabel":"enum\u003cstring>"},"attribute":{"type":"string","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.when.items.[INDEX].oneOf.1.attribute","typeLabel":"string"},"op":{"type":"string","enum":["is","not","contains","not_contains","starts_with","ends_with","any","empty","lt","lte","gt","gte","between","true","false","includes_any","includes_all","not_includes_any","not_includes_all","less_than","exactly","more_than","before","on","after"],"description":"Operator — the allowed set depends on the attribute dataType. String: is | not | contains | not_contains | starts_with | ends_with | any | empty. Number: is | not | lt | lte | gt | gte | between | any | empty. Boolean: true | false | any | empty. List: includes_any | includes_all | not_includes_any | not_includes_all | any | empty. DateTime: less_than | exactly | more_than (relative — `value` is a number of days) | before | on | after (`value` is an absolute date) | any | empty. The relative ops are ONE-SIDED bounds around (now − N days): `less_than N` = the date is AFTER now−N — so it also matches every FUTURE date, and on a future-dated attribute (a trial end, a renewal date) it is NOT \"within the last N days\"; `more_than N` = the date is BEFORE now−N. **\"Signed up in the last N days\" therefore needs BOTH bounds** — `less_than N` AND `more_than 0` in one `all` group; `less_than N` alone silently includes anyone whose date is in the future (a mis-mapped trial-end column, a clock/timezone slip), and those are exactly the users a new-user audience must not contain (observed in testing). Negative N shifts the bound into the future: the rolling \"within the NEXT 7 days\" window is `less_than` value \"0\" AND `more_than` value \"-7\" (two conditions, both required). The relative ops are DAY-granularity only — no unit field; for hour/minute windows use an `event` condition with a `within` (which has a `unit`).","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.when.items.[INDEX].oneOf.1.op","typeLabel":"enum\u003cstring>"},"value":{"description":"The comparison value (string / number-as-string / date). Omit for any/empty/true/false.","type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.when.items.[INDEX].oneOf.1.value","typeLabel":"string"},"value2":{"description":"Upper bound for the `between` operator (`value` is the lower bound).","type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.when.items.[INDEX].oneOf.1.value2","typeLabel":"string"},"values":{"description":"Values for the List operators (includes_any / includes_all / …).","type":"array","items":{"type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.when.items.[INDEX].oneOf.1.values.items.[INDEX]","typeLabel":"string"},"uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.when.items.[INDEX].oneOf.1.values","typeLabel":"string[]"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.when.items.[INDEX].oneOf.1","typeLabel":"object"},{"type":"object","required":["type","segment","in"],"properties":{"type":{"type":"string","enum":["segment"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.when.items.[INDEX].oneOf.2.type","typeLabel":"enum\u003cstring>"},"segment":{"type":"string","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.when.items.[INDEX].oneOf.2.segment","typeLabel":"string"},"in":{"type":"boolean","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.when.items.[INDEX].oneOf.2.in","typeLabel":"boolean"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.when.items.[INDEX].oneOf.2","typeLabel":"object"},{"type":"object","required":["type","includes"],"properties":{"type":{"type":"string","enum":["current_url"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.when.items.[INDEX].oneOf.3.type","typeLabel":"enum\u003cstring>"},"includes":{"type":"array","items":{"type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.when.items.[INDEX].oneOf.3.includes.items.[INDEX]","typeLabel":"string"},"description":"URL patterns (anchored whole-url match, NOT substring/regex). `*` = wildcard within one url part; `:name` = one path segment. A bare `*` (i.e. `[\"*\"]`) matches EVERY page on every host incl. deep paths — the canonical always-on / whole-site pattern (use it when content should be available everywhere). Scope it down instead with: `*/` (homepage only — path exactly `/`), `*/pricing` (one page), `*/app/*` (a section + below), `host.com/*` (any page on a specific host). Multiple patterns are OR-matched: the URL matches this list if it matches ANY one pattern (so \"/tasks OR /dashboard\" is one condition with both patterns here — no group needed).","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.when.items.[INDEX].oneOf.3.includes","typeLabel":"string[]"},"excludes":{"description":"URL patterns to exclude (same syntax as includes); excludes win over includes.","type":"array","items":{"type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.when.items.[INDEX].oneOf.3.excludes.items.[INDEX]","typeLabel":"string"},"uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.when.items.[INDEX].oneOf.3.excludes","typeLabel":"string[]"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.when.items.[INDEX].oneOf.3","typeLabel":"object"},{"type":"object","required":["type","state"],"properties":{"type":{"type":"string","enum":["element"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.when.items.[INDEX].oneOf.4.type","typeLabel":"enum\u003cstring>"},"state":{"type":"string","enum":["present","hidden","disabled","enabled","clicked","unclicked"],"description":"`present` means NOT CLIPPED AWAY: the element is in the DOM and its box lies inside the viewport / its scroll ancestors — scrolled off-screen or `display:none` never satisfies it (and `hidden` is its negation). It is NOT \"the user can see something there\": an EMPTY, zero-height placeholder node satisfies `present` (observed in testing: a checklist task keyed on an initially-empty `\u003cp>` status line ticked itself the moment the checklist appeared, before the shopper did anything). So do not use element presence as a proxy for \"the app has said something\": most apps keep the container mounted and only fill in its text. Match the TEXT instead (`target.text` + `present`, or the negation trick: the old text `hidden`). Appearances shorter than about a second can be missed entirely. `disabled`/`enabled` read the element disabled state at evaluation time. **`clicked` means \"clicked since page load AND the element is STILL in the DOM right now\"** — both halves, re-checked every evaluation. The click memory latches (the listener attaches the FIRST time the condition is evaluated, so earlier clicks are invisible, and the memory survives a re-render), but the element lookup is redone each poll. Two consequences, one of them silent: (1) **an element that UNMOUNTS on click can NEVER satisfy it** — the click lands, the element vanishes, the lookup fails from then on and the condition stays false forever with no error (observed in testing: a tracker on a button that clears its own toolbar counted ZERO real clicks); (2) an element that unmounts and REMOUNTS satisfies it again, so a tracker gated on it fires once per remount — not once per page load. Unlike `present`, this lookup does NOT require viewport visibility: scrolling the target off-screen keeps `clicked` true. `unclicked` negates the same pair, so it is also false while the element is absent. To count a COMPLETED action, condition on what the app shows afterwards (a success toast, a state change) rather than `clicked` on the button that starts it.","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.when.items.[INDEX].oneOf.4.state","typeLabel":"enum\u003cstring>"},"target":{"type":"object","properties":{"selector":{"type":"string","minLength":1,"description":"A stable CSS selector for the element, on the page or inside a same-origin iframe (written relative to the frame's own document). The runtime targets the FIRST match — so either make the selector unique, or pair a stable non-unique selector with `nth` to pick the intended match. A non-unique selector with no `nth` targets the first (often wrong) element and the tooltip silently won't render.","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.when.items.[INDEX].oneOf.4.target.selector","typeLabel":"string"},"text":{"description":"Optional refinement of `selector`. Requires the targeted element's visible text to equal this (exact match, after trim) — use it to pin a specific content/state (e.g. a stable id whose displayed text you want to match: id + text). It refines the element chosen by `selector`/`nth`; on its own it does NOT search among multiple matches, so disambiguate a non-unique selector with `nth`, not `text` alone.","type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.when.items.[INDEX].oneOf.4.target.text","typeLabel":"string"},"nth":{"description":"Optional refinement of `selector`. 0-based index to pick which match when the selector isn't unique — e.g. a stable selector matching 3 elements + `nth: 1` targets the 2nd, giving a unique result. Matches are taken in document order (as they appear in the page HTML). Range 0–4 — only the first 5 matches are addressable; a larger value is rejected.","type":"integer","minimum":0,"maximum":4,"uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.when.items.[INDEX].oneOf.4.target.nth","typeLabel":"integer"}},"required":["selector"],"uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.when.items.[INDEX].oneOf.4.target","typeLabel":"object"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.when.items.[INDEX].oneOf.4","typeLabel":"object"},{"type":"object","required":["type","content","state"],"properties":{"type":{"type":"string","enum":["content_state"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.when.items.[INDEX].oneOf.5.type","typeLabel":"enum\u003cstring>"},"content":{"type":"string","description":"contentId of the FLOW or CHECKLIST whose per-user state to check (an id from the content list). Only flows and checklists record this state — referencing a banner / launcher / resource-center / tracker is rejected at write.","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.when.items.[INDEX].oneOf.5.content","typeLabel":"string"},"state":{"type":"string","enum":["seen","unseen","completed","uncompleted","active","inactive"],"description":"The referenced flow/checklist's state for THIS user. seen = started at least once (for a flow, TRUE from the moment it opens; for a checklist, TRUE only once the user EXPANDS the panel — a `initialDisplay: \"button\"` checklist whose launcher is never clicked stays unseen forever); unseen = never started; active = currently open/running; inactive = NOT currently running (covers both never-started and ran-then-closed); completed = reached a goal/completion step; uncompleted = not completed. To gate piece B until flow A has run AND closed (the usual \"show next thing after the welcome flow\" sequencing), use `seen` AND `inactive` together — `seen` alone fires while A is still open (B piles on top), and `completed` alone strands users who skip/dismiss A.","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.when.items.[INDEX].oneOf.5.state","typeLabel":"enum\u003cstring>"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.when.items.[INDEX].oneOf.5","typeLabel":"object"},{"type":"object","required":["type","event"],"properties":{"type":{"type":"string","enum":["event"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.when.items.[INDEX].oneOf.6.type","typeLabel":"enum\u003cstring>"},"event":{"type":"string","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.when.items.[INDEX].oneOf.6.event","typeLabel":"string"},"count":{"description":"How many times the event must have occurred. Omit it for the common case \"the event has happened\" (treated as at_least 1). Set `op`/`n` for a threshold (`between` needs `n` and `n2`). `at_least`/`between` require n ≥ 1; use `at_most`/`exactly` with 0 for \"never happened\".","type":"object","properties":{"op":{"type":"string","enum":["at_least","at_most","exactly","between"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.when.items.[INDEX].oneOf.6.count.op","typeLabel":"enum\u003cstring>"},"n":{"type":"integer","minimum":0,"maximum":9007199254740991,"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.when.items.[INDEX].oneOf.6.count.n","typeLabel":"integer"},"n2":{"type":"integer","minimum":0,"maximum":9007199254740991,"uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.when.items.[INDEX].oneOf.6.count.n2","typeLabel":"integer"}},"required":["op","n"],"uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.when.items.[INDEX].oneOf.6.count","typeLabel":"object"},"within":{"description":"Optional time window for the event count. Omit it (or use `any_time`) to count over all time — \"the event has ever happened\". Any other `op` (`in_the_last` / `more_than` / `between`) requires BOTH `value` and `unit`, and `between` also `value2` — rejected at write otherwise.","type":"object","properties":{"op":{"type":"string","enum":["in_the_last","more_than","between","any_time"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.when.items.[INDEX].oneOf.6.within.op","typeLabel":"enum\u003cstring>"},"value":{"type":"number","uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.when.items.[INDEX].oneOf.6.within.value","typeLabel":"number"},"value2":{"type":"number","uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.when.items.[INDEX].oneOf.6.within.value2","typeLabel":"number"},"unit":{"type":"string","enum":["seconds","minutes","hours","days"],"uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.when.items.[INDEX].oneOf.6.within.unit","typeLabel":"enum\u003cstring>"}},"required":["op"],"uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.when.items.[INDEX].oneOf.6.within","typeLabel":"object"},"scope":{"description":"Whose event activity to count (default `current_user`). `current_user` = only this user's own events. `current_user_in_company` = this user's events, but counted within their currently-associated company context (needs the user associated to a company via `group()` / the company-membership API). `any_user_in_company` = events by ANY user in this user's company — account-level activity (e.g. \"anyone on the account has done X\"). The two company scopes require the user to be in a company or they never match.","type":"string","enum":["current_user","current_user_in_company","any_user_in_company"],"uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.when.items.[INDEX].oneOf.6.scope","typeLabel":"enum\u003cstring>"},"where":{"type":"array","items":{"oneOf":[{"type":"object","required":["type","attribute","op"],"properties":{"type":{"type":"string","enum":["event_attribute"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.when.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.0.type","typeLabel":"enum\u003cstring>"},"attribute":{"type":"string","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.when.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.0.attribute","typeLabel":"string"},"op":{"type":"string","enum":["is","not","contains","not_contains","starts_with","ends_with","any","empty","lt","lte","gt","gte","between","true","false","includes_any","includes_all","not_includes_any","not_includes_all","less_than","exactly","more_than","before","on","after"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.when.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.0.op","typeLabel":"enum\u003cstring>"},"value":{"type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.when.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.0.value","typeLabel":"string"},"value2":{"type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.when.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.0.value2","typeLabel":"string"},"values":{"type":"array","items":{"type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.when.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.0.values.items.[INDEX]","typeLabel":"string"},"uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.when.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.0.values","typeLabel":"string[]"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.when.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","required":["type","match","conditions"],"properties":{"type":{"type":"string","enum":["group"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.when.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.1.type","typeLabel":"enum\u003cstring>"},"match":{"type":"string","enum":["all","any"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.when.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.1.match","typeLabel":"enum\u003cstring>"},"conditions":{"minItems":1,"type":"array","items":{"$circularRef":"7599b088-c1e6-49bf-842c-0ee9fa13f591"},"description":"The grouped conditions — at least one. An EMPTY group is not \"no filter\": it never matches, so next to an AND it makes the whole rule unmatchable, and writing one is rejected. A version saved with an empty group in the BUILDER still reads back with it (validate warns); writing that list back is refused until the group is filled or dropped.","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.when.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.1.conditions","typeLabel":"array"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.when.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.1","typeLabel":"object"}],"uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.when.items.[INDEX].oneOf.6.where.items.[INDEX]","typeLabel":"object"},"uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.when.items.[INDEX].oneOf.6.where","typeLabel":"object[]"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.when.items.[INDEX].oneOf.6","typeLabel":"object"},{"type":"object","required":["type","op"],"properties":{"type":{"type":"string","enum":["text_input"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.when.items.[INDEX].oneOf.7.type","typeLabel":"enum\u003cstring>"},"op":{"type":"string","enum":["is","not","contains","not_contains","starts_with","ends_with","match","unmatch","any","empty"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.when.items.[INDEX].oneOf.7.op","typeLabel":"enum\u003cstring>"},"target":{"type":"object","properties":{"selector":{"type":"string","minLength":1,"description":"A stable CSS selector for the element, on the page or inside a same-origin iframe (written relative to the frame's own document). The runtime targets the FIRST match — so either make the selector unique, or pair a stable non-unique selector with `nth` to pick the intended match. A non-unique selector with no `nth` targets the first (often wrong) element and the tooltip silently won't render.","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.when.items.[INDEX].oneOf.7.target.selector","typeLabel":"string"},"text":{"description":"Optional refinement of `selector`. Requires the targeted element's visible text to equal this (exact match, after trim) — use it to pin a specific content/state (e.g. a stable id whose displayed text you want to match: id + text). It refines the element chosen by `selector`/`nth`; on its own it does NOT search among multiple matches, so disambiguate a non-unique selector with `nth`, not `text` alone.","type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.when.items.[INDEX].oneOf.7.target.text","typeLabel":"string"},"nth":{"description":"Optional refinement of `selector`. 0-based index to pick which match when the selector isn't unique — e.g. a stable selector matching 3 elements + `nth: 1` targets the 2nd, giving a unique result. Matches are taken in document order (as they appear in the page HTML). Range 0–4 — only the first 5 matches are addressable; a larger value is rejected.","type":"integer","minimum":0,"maximum":4,"uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.when.items.[INDEX].oneOf.7.target.nth","typeLabel":"integer"}},"required":["selector"],"uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.when.items.[INDEX].oneOf.7.target","typeLabel":"object"},"value":{"type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.when.items.[INDEX].oneOf.7.value","typeLabel":"string"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.when.items.[INDEX].oneOf.7","typeLabel":"object"},{"type":"object","required":["type"],"properties":{"type":{"type":"string","enum":["text_filled"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.when.items.[INDEX].oneOf.8.type","typeLabel":"enum\u003cstring>"},"target":{"type":"object","properties":{"selector":{"type":"string","minLength":1,"description":"A stable CSS selector for the element, on the page or inside a same-origin iframe (written relative to the frame's own document). The runtime targets the FIRST match — so either make the selector unique, or pair a stable non-unique selector with `nth` to pick the intended match. A non-unique selector with no `nth` targets the first (often wrong) element and the tooltip silently won't render.","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.when.items.[INDEX].oneOf.8.target.selector","typeLabel":"string"},"text":{"description":"Optional refinement of `selector`. Requires the targeted element's visible text to equal this (exact match, after trim) — use it to pin a specific content/state (e.g. a stable id whose displayed text you want to match: id + text). It refines the element chosen by `selector`/`nth`; on its own it does NOT search among multiple matches, so disambiguate a non-unique selector with `nth`, not `text` alone.","type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.when.items.[INDEX].oneOf.8.target.text","typeLabel":"string"},"nth":{"description":"Optional refinement of `selector`. 0-based index to pick which match when the selector isn't unique — e.g. a stable selector matching 3 elements + `nth: 1` targets the 2nd, giving a unique result. Matches are taken in document order (as they appear in the page HTML). Range 0–4 — only the first 5 matches are addressable; a larger value is rejected.","type":"integer","minimum":0,"maximum":4,"uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.when.items.[INDEX].oneOf.8.target.nth","typeLabel":"integer"}},"required":["selector"],"uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.when.items.[INDEX].oneOf.8.target","typeLabel":"object"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.when.items.[INDEX].oneOf.8","typeLabel":"object"},{"type":"object","required":["type","start"],"properties":{"type":{"type":"string","enum":["time_window"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.when.items.[INDEX].oneOf.9.type","typeLabel":"enum\u003cstring>"},"start":{"type":"string","description":"Window start (ISO datetime). REQUIRED — the runtime never matches a window without a start, so an end-only window is rejected at write. For \"until X\" semantics, set start to any past instant and end to X.","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.when.items.[INDEX].oneOf.9.start","typeLabel":"string"},"end":{"description":"Window end (ISO datetime). Omit for an open-ended \"from start onwards\" window.","type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.when.items.[INDEX].oneOf.9.end","typeLabel":"string"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.when.items.[INDEX].oneOf.9","typeLabel":"object"},{"type":"object","description":"Read-side placeholder for a stored condition this API cannot express (`note` says what it stands for — usually a DEAD condition the runtime never matches: a deleted attribute/event, an end-only time window). It cannot be written back (the placeholder carries no data to preserve): echoing it is rejected. Either remove it from the list you write — an explicit choice that DELETES the stored condition; mind that a never-matching node inside an AND list pins the whole rule to \"never fires\", so deleting it can bring the remaining conditions to life — or repair the original condition in the Usertour builder first.","required":["type"],"properties":{"type":{"type":"string","enum":["unsupported"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.when.items.[INDEX].oneOf.10.type","typeLabel":"enum\u003cstring>"},"note":{"type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.when.items.[INDEX].oneOf.10.note","typeLabel":"string"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.when.items.[INDEX].oneOf.10","typeLabel":"object"}],"uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.when.items.[INDEX]","typeLabel":"object"},"uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.when","typeLabel":"object[]"},"frequency":{"description":"How often the content may auto-start (flow/checklist only). Left unset on a write, the builder default (`once`) is seeded and STORED — read-backs show the effective mode explicitly. A version stored with NO frequency at all (reachable only through legacy/builder-external writes, never through this API) runs with NO limit: it starts again every time its rules match once the prior session ends — validate_content_version warns on that state.","type":"object","properties":{"mode":{"type":"string","enum":["once","multiple","unlimited"],"description":"once = show a single time; multiple = up to N times per window; unlimited = every time the conditions match (subject to `every`).","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.frequency.mode","typeLabel":"enum\u003cstring>"},"every":{"description":"Re-show window. Used by `multiple` (with `times`) and `unlimited`; ignored for `once`. If omitted for those modes a default window is applied. Manual and programmatic starts also count toward the `multiple` limit.","type":"object","properties":{"duration":{"type":"number","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.frequency.every.duration","typeLabel":"number"},"unit":{"type":"string","enum":["seconds","minutes","hours","days"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.frequency.every.unit","typeLabel":"enum\u003cstring>"},"times":{"type":"number","uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.frequency.every.times","typeLabel":"number"}},"required":["duration","unit"],"uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.frequency.every","typeLabel":"object"},"atLeast":{"description":"Only auto-start if no OTHER content of the SAME type has been shown within this window — and since only flows accept this knob, in practice: no other FLOW. A banner / checklist / launcher showing does NOT block it. Avoids stacking several flows on a user at once.","type":"object","properties":{"duration":{"type":"number","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.frequency.atLeast.duration","typeLabel":"number"},"unit":{"type":"string","enum":["seconds","minutes","hours","days"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.frequency.atLeast.unit","typeLabel":"enum\u003cstring>"}},"required":["duration","unit"],"uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.frequency.atLeast","typeLabel":"object"}},"required":["mode"],"uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.frequency","typeLabel":"object"},"priority":{"description":"Tie-breaker when a user matches the start conditions for more than one piece of content at the same time — the higher priority starts first. Content with no priority set ranks as `medium`.","type":"string","enum":["highest","high","medium","low","lowest"],"uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.priority","typeLabel":"enum\u003cstring>"},"waitSeconds":{"description":"Delay in SECONDS between the start conditions matching and the content becoming ELIGIBLE to start. The countdown itself survives the conditions un-matching mid-wait, but unlike a trigger wait (which fires its actions regardless), an elapsed start-rule wait guarantees nothing: the conditions are RE-CHECKED at show time, and the content starts at the next moment they match again. One exception: when a session of the same content type starts or ends mid-wait, in-flight timers are cancelled and re-armed — a still-matching version then restarts its wait from zero. Capped at 300 seconds by the runtime (a larger value is clamped).","type":"number","uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.waitSeconds","typeLabel":"number"},"startIfNotComplete":{"description":"When true, this content won't auto-start for users who have already completed it.","type":"boolean","uniqueKey":"environments.items.[INDEX].publishedVersion.startRules.startIfNotComplete","typeLabel":"boolean"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.startRules","typeLabel":"object"},"hideRules":{"type":"object","properties":{"when":{"type":"array","items":{"oneOf":[{"type":"object","required":["type","match","conditions"],"properties":{"type":{"type":"string","enum":["group"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.hideRules.when.items.[INDEX].oneOf.0.type","typeLabel":"enum\u003cstring>"},"match":{"type":"string","enum":["all","any"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.hideRules.when.items.[INDEX].oneOf.0.match","typeLabel":"enum\u003cstring>"},"conditions":{"minItems":1,"type":"array","items":{"$circularRef":"8bf0052c-740f-4e24-a54d-effeac73767f"},"description":"The grouped conditions — at least one. An EMPTY group is not \"no filter\": it never matches, so next to an AND it makes the whole rule unmatchable, and writing one is rejected. A version saved with an empty group in the BUILDER still reads back with it (validate warns); writing that list back is refused until the group is filled or dropped.","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.hideRules.when.items.[INDEX].oneOf.0.conditions","typeLabel":"array"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.hideRules.when.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","required":["type","scope","attribute","op"],"properties":{"type":{"type":"string","enum":["attribute"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.hideRules.when.items.[INDEX].oneOf.1.type","typeLabel":"enum\u003cstring>"},"scope":{"type":"string","enum":["user","company","companyMembership"],"description":"Which entity owns the attribute — `user` (the end user), `company`, or `companyMembership`. Same value as the attribute definition's `scope` (see the attribute definitions list); required to disambiguate a codeName that exists in more than one scope.","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.hideRules.when.items.[INDEX].oneOf.1.scope","typeLabel":"enum\u003cstring>"},"attribute":{"type":"string","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.hideRules.when.items.[INDEX].oneOf.1.attribute","typeLabel":"string"},"op":{"type":"string","enum":["is","not","contains","not_contains","starts_with","ends_with","any","empty","lt","lte","gt","gte","between","true","false","includes_any","includes_all","not_includes_any","not_includes_all","less_than","exactly","more_than","before","on","after"],"description":"Operator — the allowed set depends on the attribute dataType. String: is | not | contains | not_contains | starts_with | ends_with | any | empty. Number: is | not | lt | lte | gt | gte | between | any | empty. Boolean: true | false | any | empty. List: includes_any | includes_all | not_includes_any | not_includes_all | any | empty. DateTime: less_than | exactly | more_than (relative — `value` is a number of days) | before | on | after (`value` is an absolute date) | any | empty. The relative ops are ONE-SIDED bounds around (now − N days): `less_than N` = the date is AFTER now−N — so it also matches every FUTURE date, and on a future-dated attribute (a trial end, a renewal date) it is NOT \"within the last N days\"; `more_than N` = the date is BEFORE now−N. **\"Signed up in the last N days\" therefore needs BOTH bounds** — `less_than N` AND `more_than 0` in one `all` group; `less_than N` alone silently includes anyone whose date is in the future (a mis-mapped trial-end column, a clock/timezone slip), and those are exactly the users a new-user audience must not contain (observed in testing). Negative N shifts the bound into the future: the rolling \"within the NEXT 7 days\" window is `less_than` value \"0\" AND `more_than` value \"-7\" (two conditions, both required). The relative ops are DAY-granularity only — no unit field; for hour/minute windows use an `event` condition with a `within` (which has a `unit`).","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.hideRules.when.items.[INDEX].oneOf.1.op","typeLabel":"enum\u003cstring>"},"value":{"description":"The comparison value (string / number-as-string / date). Omit for any/empty/true/false.","type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.hideRules.when.items.[INDEX].oneOf.1.value","typeLabel":"string"},"value2":{"description":"Upper bound for the `between` operator (`value` is the lower bound).","type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.hideRules.when.items.[INDEX].oneOf.1.value2","typeLabel":"string"},"values":{"description":"Values for the List operators (includes_any / includes_all / …).","type":"array","items":{"type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.hideRules.when.items.[INDEX].oneOf.1.values.items.[INDEX]","typeLabel":"string"},"uniqueKey":"environments.items.[INDEX].publishedVersion.hideRules.when.items.[INDEX].oneOf.1.values","typeLabel":"string[]"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.hideRules.when.items.[INDEX].oneOf.1","typeLabel":"object"},{"type":"object","required":["type","segment","in"],"properties":{"type":{"type":"string","enum":["segment"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.hideRules.when.items.[INDEX].oneOf.2.type","typeLabel":"enum\u003cstring>"},"segment":{"type":"string","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.hideRules.when.items.[INDEX].oneOf.2.segment","typeLabel":"string"},"in":{"type":"boolean","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.hideRules.when.items.[INDEX].oneOf.2.in","typeLabel":"boolean"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.hideRules.when.items.[INDEX].oneOf.2","typeLabel":"object"},{"type":"object","required":["type","includes"],"properties":{"type":{"type":"string","enum":["current_url"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.hideRules.when.items.[INDEX].oneOf.3.type","typeLabel":"enum\u003cstring>"},"includes":{"type":"array","items":{"type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.hideRules.when.items.[INDEX].oneOf.3.includes.items.[INDEX]","typeLabel":"string"},"description":"URL patterns (anchored whole-url match, NOT substring/regex). `*` = wildcard within one url part; `:name` = one path segment. A bare `*` (i.e. `[\"*\"]`) matches EVERY page on every host incl. deep paths — the canonical always-on / whole-site pattern (use it when content should be available everywhere). Scope it down instead with: `*/` (homepage only — path exactly `/`), `*/pricing` (one page), `*/app/*` (a section + below), `host.com/*` (any page on a specific host). Multiple patterns are OR-matched: the URL matches this list if it matches ANY one pattern (so \"/tasks OR /dashboard\" is one condition with both patterns here — no group needed).","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.hideRules.when.items.[INDEX].oneOf.3.includes","typeLabel":"string[]"},"excludes":{"description":"URL patterns to exclude (same syntax as includes); excludes win over includes.","type":"array","items":{"type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.hideRules.when.items.[INDEX].oneOf.3.excludes.items.[INDEX]","typeLabel":"string"},"uniqueKey":"environments.items.[INDEX].publishedVersion.hideRules.when.items.[INDEX].oneOf.3.excludes","typeLabel":"string[]"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.hideRules.when.items.[INDEX].oneOf.3","typeLabel":"object"},{"type":"object","required":["type","state"],"properties":{"type":{"type":"string","enum":["element"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.hideRules.when.items.[INDEX].oneOf.4.type","typeLabel":"enum\u003cstring>"},"state":{"type":"string","enum":["present","hidden","disabled","enabled","clicked","unclicked"],"description":"`present` means NOT CLIPPED AWAY: the element is in the DOM and its box lies inside the viewport / its scroll ancestors — scrolled off-screen or `display:none` never satisfies it (and `hidden` is its negation). It is NOT \"the user can see something there\": an EMPTY, zero-height placeholder node satisfies `present` (observed in testing: a checklist task keyed on an initially-empty `\u003cp>` status line ticked itself the moment the checklist appeared, before the shopper did anything). So do not use element presence as a proxy for \"the app has said something\": most apps keep the container mounted and only fill in its text. Match the TEXT instead (`target.text` + `present`, or the negation trick: the old text `hidden`). Appearances shorter than about a second can be missed entirely. `disabled`/`enabled` read the element disabled state at evaluation time. **`clicked` means \"clicked since page load AND the element is STILL in the DOM right now\"** — both halves, re-checked every evaluation. The click memory latches (the listener attaches the FIRST time the condition is evaluated, so earlier clicks are invisible, and the memory survives a re-render), but the element lookup is redone each poll. Two consequences, one of them silent: (1) **an element that UNMOUNTS on click can NEVER satisfy it** — the click lands, the element vanishes, the lookup fails from then on and the condition stays false forever with no error (observed in testing: a tracker on a button that clears its own toolbar counted ZERO real clicks); (2) an element that unmounts and REMOUNTS satisfies it again, so a tracker gated on it fires once per remount — not once per page load. Unlike `present`, this lookup does NOT require viewport visibility: scrolling the target off-screen keeps `clicked` true. `unclicked` negates the same pair, so it is also false while the element is absent. To count a COMPLETED action, condition on what the app shows afterwards (a success toast, a state change) rather than `clicked` on the button that starts it.","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.hideRules.when.items.[INDEX].oneOf.4.state","typeLabel":"enum\u003cstring>"},"target":{"type":"object","properties":{"selector":{"type":"string","minLength":1,"description":"A stable CSS selector for the element, on the page or inside a same-origin iframe (written relative to the frame's own document). The runtime targets the FIRST match — so either make the selector unique, or pair a stable non-unique selector with `nth` to pick the intended match. A non-unique selector with no `nth` targets the first (often wrong) element and the tooltip silently won't render.","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.hideRules.when.items.[INDEX].oneOf.4.target.selector","typeLabel":"string"},"text":{"description":"Optional refinement of `selector`. Requires the targeted element's visible text to equal this (exact match, after trim) — use it to pin a specific content/state (e.g. a stable id whose displayed text you want to match: id + text). It refines the element chosen by `selector`/`nth`; on its own it does NOT search among multiple matches, so disambiguate a non-unique selector with `nth`, not `text` alone.","type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.hideRules.when.items.[INDEX].oneOf.4.target.text","typeLabel":"string"},"nth":{"description":"Optional refinement of `selector`. 0-based index to pick which match when the selector isn't unique — e.g. a stable selector matching 3 elements + `nth: 1` targets the 2nd, giving a unique result. Matches are taken in document order (as they appear in the page HTML). Range 0–4 — only the first 5 matches are addressable; a larger value is rejected.","type":"integer","minimum":0,"maximum":4,"uniqueKey":"environments.items.[INDEX].publishedVersion.hideRules.when.items.[INDEX].oneOf.4.target.nth","typeLabel":"integer"}},"required":["selector"],"uniqueKey":"environments.items.[INDEX].publishedVersion.hideRules.when.items.[INDEX].oneOf.4.target","typeLabel":"object"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.hideRules.when.items.[INDEX].oneOf.4","typeLabel":"object"},{"type":"object","required":["type","content","state"],"properties":{"type":{"type":"string","enum":["content_state"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.hideRules.when.items.[INDEX].oneOf.5.type","typeLabel":"enum\u003cstring>"},"content":{"type":"string","description":"contentId of the FLOW or CHECKLIST whose per-user state to check (an id from the content list). Only flows and checklists record this state — referencing a banner / launcher / resource-center / tracker is rejected at write.","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.hideRules.when.items.[INDEX].oneOf.5.content","typeLabel":"string"},"state":{"type":"string","enum":["seen","unseen","completed","uncompleted","active","inactive"],"description":"The referenced flow/checklist's state for THIS user. seen = started at least once (for a flow, TRUE from the moment it opens; for a checklist, TRUE only once the user EXPANDS the panel — a `initialDisplay: \"button\"` checklist whose launcher is never clicked stays unseen forever); unseen = never started; active = currently open/running; inactive = NOT currently running (covers both never-started and ran-then-closed); completed = reached a goal/completion step; uncompleted = not completed. To gate piece B until flow A has run AND closed (the usual \"show next thing after the welcome flow\" sequencing), use `seen` AND `inactive` together — `seen` alone fires while A is still open (B piles on top), and `completed` alone strands users who skip/dismiss A.","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.hideRules.when.items.[INDEX].oneOf.5.state","typeLabel":"enum\u003cstring>"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.hideRules.when.items.[INDEX].oneOf.5","typeLabel":"object"},{"type":"object","required":["type","event"],"properties":{"type":{"type":"string","enum":["event"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.hideRules.when.items.[INDEX].oneOf.6.type","typeLabel":"enum\u003cstring>"},"event":{"type":"string","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.hideRules.when.items.[INDEX].oneOf.6.event","typeLabel":"string"},"count":{"description":"How many times the event must have occurred. Omit it for the common case \"the event has happened\" (treated as at_least 1). Set `op`/`n` for a threshold (`between` needs `n` and `n2`). `at_least`/`between` require n ≥ 1; use `at_most`/`exactly` with 0 for \"never happened\".","type":"object","properties":{"op":{"type":"string","enum":["at_least","at_most","exactly","between"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.hideRules.when.items.[INDEX].oneOf.6.count.op","typeLabel":"enum\u003cstring>"},"n":{"type":"integer","minimum":0,"maximum":9007199254740991,"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.hideRules.when.items.[INDEX].oneOf.6.count.n","typeLabel":"integer"},"n2":{"type":"integer","minimum":0,"maximum":9007199254740991,"uniqueKey":"environments.items.[INDEX].publishedVersion.hideRules.when.items.[INDEX].oneOf.6.count.n2","typeLabel":"integer"}},"required":["op","n"],"uniqueKey":"environments.items.[INDEX].publishedVersion.hideRules.when.items.[INDEX].oneOf.6.count","typeLabel":"object"},"within":{"description":"Optional time window for the event count. Omit it (or use `any_time`) to count over all time — \"the event has ever happened\". Any other `op` (`in_the_last` / `more_than` / `between`) requires BOTH `value` and `unit`, and `between` also `value2` — rejected at write otherwise.","type":"object","properties":{"op":{"type":"string","enum":["in_the_last","more_than","between","any_time"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.hideRules.when.items.[INDEX].oneOf.6.within.op","typeLabel":"enum\u003cstring>"},"value":{"type":"number","uniqueKey":"environments.items.[INDEX].publishedVersion.hideRules.when.items.[INDEX].oneOf.6.within.value","typeLabel":"number"},"value2":{"type":"number","uniqueKey":"environments.items.[INDEX].publishedVersion.hideRules.when.items.[INDEX].oneOf.6.within.value2","typeLabel":"number"},"unit":{"type":"string","enum":["seconds","minutes","hours","days"],"uniqueKey":"environments.items.[INDEX].publishedVersion.hideRules.when.items.[INDEX].oneOf.6.within.unit","typeLabel":"enum\u003cstring>"}},"required":["op"],"uniqueKey":"environments.items.[INDEX].publishedVersion.hideRules.when.items.[INDEX].oneOf.6.within","typeLabel":"object"},"scope":{"description":"Whose event activity to count (default `current_user`). `current_user` = only this user's own events. `current_user_in_company` = this user's events, but counted within their currently-associated company context (needs the user associated to a company via `group()` / the company-membership API). `any_user_in_company` = events by ANY user in this user's company — account-level activity (e.g. \"anyone on the account has done X\"). The two company scopes require the user to be in a company or they never match.","type":"string","enum":["current_user","current_user_in_company","any_user_in_company"],"uniqueKey":"environments.items.[INDEX].publishedVersion.hideRules.when.items.[INDEX].oneOf.6.scope","typeLabel":"enum\u003cstring>"},"where":{"type":"array","items":{"oneOf":[{"type":"object","required":["type","attribute","op"],"properties":{"type":{"type":"string","enum":["event_attribute"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.hideRules.when.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.0.type","typeLabel":"enum\u003cstring>"},"attribute":{"type":"string","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.hideRules.when.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.0.attribute","typeLabel":"string"},"op":{"type":"string","enum":["is","not","contains","not_contains","starts_with","ends_with","any","empty","lt","lte","gt","gte","between","true","false","includes_any","includes_all","not_includes_any","not_includes_all","less_than","exactly","more_than","before","on","after"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.hideRules.when.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.0.op","typeLabel":"enum\u003cstring>"},"value":{"type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.hideRules.when.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.0.value","typeLabel":"string"},"value2":{"type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.hideRules.when.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.0.value2","typeLabel":"string"},"values":{"type":"array","items":{"type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.hideRules.when.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.0.values.items.[INDEX]","typeLabel":"string"},"uniqueKey":"environments.items.[INDEX].publishedVersion.hideRules.when.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.0.values","typeLabel":"string[]"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.hideRules.when.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","required":["type","match","conditions"],"properties":{"type":{"type":"string","enum":["group"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.hideRules.when.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.1.type","typeLabel":"enum\u003cstring>"},"match":{"type":"string","enum":["all","any"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.hideRules.when.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.1.match","typeLabel":"enum\u003cstring>"},"conditions":{"minItems":1,"type":"array","items":{"$circularRef":"7599b088-c1e6-49bf-842c-0ee9fa13f591"},"description":"The grouped conditions — at least one. An EMPTY group is not \"no filter\": it never matches, so next to an AND it makes the whole rule unmatchable, and writing one is rejected. A version saved with an empty group in the BUILDER still reads back with it (validate warns); writing that list back is refused until the group is filled or dropped.","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.hideRules.when.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.1.conditions","typeLabel":"array"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.hideRules.when.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.1","typeLabel":"object"}],"uniqueKey":"environments.items.[INDEX].publishedVersion.hideRules.when.items.[INDEX].oneOf.6.where.items.[INDEX]","typeLabel":"object"},"uniqueKey":"environments.items.[INDEX].publishedVersion.hideRules.when.items.[INDEX].oneOf.6.where","typeLabel":"object[]"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.hideRules.when.items.[INDEX].oneOf.6","typeLabel":"object"},{"type":"object","required":["type","op"],"properties":{"type":{"type":"string","enum":["text_input"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.hideRules.when.items.[INDEX].oneOf.7.type","typeLabel":"enum\u003cstring>"},"op":{"type":"string","enum":["is","not","contains","not_contains","starts_with","ends_with","match","unmatch","any","empty"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.hideRules.when.items.[INDEX].oneOf.7.op","typeLabel":"enum\u003cstring>"},"target":{"type":"object","properties":{"selector":{"type":"string","minLength":1,"description":"A stable CSS selector for the element, on the page or inside a same-origin iframe (written relative to the frame's own document). The runtime targets the FIRST match — so either make the selector unique, or pair a stable non-unique selector with `nth` to pick the intended match. A non-unique selector with no `nth` targets the first (often wrong) element and the tooltip silently won't render.","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.hideRules.when.items.[INDEX].oneOf.7.target.selector","typeLabel":"string"},"text":{"description":"Optional refinement of `selector`. Requires the targeted element's visible text to equal this (exact match, after trim) — use it to pin a specific content/state (e.g. a stable id whose displayed text you want to match: id + text). It refines the element chosen by `selector`/`nth`; on its own it does NOT search among multiple matches, so disambiguate a non-unique selector with `nth`, not `text` alone.","type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.hideRules.when.items.[INDEX].oneOf.7.target.text","typeLabel":"string"},"nth":{"description":"Optional refinement of `selector`. 0-based index to pick which match when the selector isn't unique — e.g. a stable selector matching 3 elements + `nth: 1` targets the 2nd, giving a unique result. Matches are taken in document order (as they appear in the page HTML). Range 0–4 — only the first 5 matches are addressable; a larger value is rejected.","type":"integer","minimum":0,"maximum":4,"uniqueKey":"environments.items.[INDEX].publishedVersion.hideRules.when.items.[INDEX].oneOf.7.target.nth","typeLabel":"integer"}},"required":["selector"],"uniqueKey":"environments.items.[INDEX].publishedVersion.hideRules.when.items.[INDEX].oneOf.7.target","typeLabel":"object"},"value":{"type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.hideRules.when.items.[INDEX].oneOf.7.value","typeLabel":"string"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.hideRules.when.items.[INDEX].oneOf.7","typeLabel":"object"},{"type":"object","required":["type"],"properties":{"type":{"type":"string","enum":["text_filled"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.hideRules.when.items.[INDEX].oneOf.8.type","typeLabel":"enum\u003cstring>"},"target":{"type":"object","properties":{"selector":{"type":"string","minLength":1,"description":"A stable CSS selector for the element, on the page or inside a same-origin iframe (written relative to the frame's own document). The runtime targets the FIRST match — so either make the selector unique, or pair a stable non-unique selector with `nth` to pick the intended match. A non-unique selector with no `nth` targets the first (often wrong) element and the tooltip silently won't render.","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.hideRules.when.items.[INDEX].oneOf.8.target.selector","typeLabel":"string"},"text":{"description":"Optional refinement of `selector`. Requires the targeted element's visible text to equal this (exact match, after trim) — use it to pin a specific content/state (e.g. a stable id whose displayed text you want to match: id + text). It refines the element chosen by `selector`/`nth`; on its own it does NOT search among multiple matches, so disambiguate a non-unique selector with `nth`, not `text` alone.","type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.hideRules.when.items.[INDEX].oneOf.8.target.text","typeLabel":"string"},"nth":{"description":"Optional refinement of `selector`. 0-based index to pick which match when the selector isn't unique — e.g. a stable selector matching 3 elements + `nth: 1` targets the 2nd, giving a unique result. Matches are taken in document order (as they appear in the page HTML). Range 0–4 — only the first 5 matches are addressable; a larger value is rejected.","type":"integer","minimum":0,"maximum":4,"uniqueKey":"environments.items.[INDEX].publishedVersion.hideRules.when.items.[INDEX].oneOf.8.target.nth","typeLabel":"integer"}},"required":["selector"],"uniqueKey":"environments.items.[INDEX].publishedVersion.hideRules.when.items.[INDEX].oneOf.8.target","typeLabel":"object"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.hideRules.when.items.[INDEX].oneOf.8","typeLabel":"object"},{"type":"object","required":["type","start"],"properties":{"type":{"type":"string","enum":["time_window"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.hideRules.when.items.[INDEX].oneOf.9.type","typeLabel":"enum\u003cstring>"},"start":{"type":"string","description":"Window start (ISO datetime). REQUIRED — the runtime never matches a window without a start, so an end-only window is rejected at write. For \"until X\" semantics, set start to any past instant and end to X.","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.hideRules.when.items.[INDEX].oneOf.9.start","typeLabel":"string"},"end":{"description":"Window end (ISO datetime). Omit for an open-ended \"from start onwards\" window.","type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.hideRules.when.items.[INDEX].oneOf.9.end","typeLabel":"string"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.hideRules.when.items.[INDEX].oneOf.9","typeLabel":"object"},{"type":"object","description":"Read-side placeholder for a stored condition this API cannot express (`note` says what it stands for — usually a DEAD condition the runtime never matches: a deleted attribute/event, an end-only time window). It cannot be written back (the placeholder carries no data to preserve): echoing it is rejected. Either remove it from the list you write — an explicit choice that DELETES the stored condition; mind that a never-matching node inside an AND list pins the whole rule to \"never fires\", so deleting it can bring the remaining conditions to life — or repair the original condition in the Usertour builder first.","required":["type"],"properties":{"type":{"type":"string","enum":["unsupported"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.hideRules.when.items.[INDEX].oneOf.10.type","typeLabel":"enum\u003cstring>"},"note":{"type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.hideRules.when.items.[INDEX].oneOf.10.note","typeLabel":"string"}},"uniqueKey":"environments.items.[INDEX].publishedVersion.hideRules.when.items.[INDEX].oneOf.10","typeLabel":"object"}],"uniqueKey":"environments.items.[INDEX].publishedVersion.hideRules.when.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.hideRules.when","typeLabel":"object[]"}},"required":["when"],"description":"While `when` matches, on-screen content of this version is hidden — the session is SUSPENDED, not ended: when the conditions stop matching the same session reappears at the same step. Use start-rule conditions to keep content from starting; use hide rules to blank it in specific places (e.g. a settings page).","uniqueKey":"environments.items.[INDEX].publishedVersion.hideRules","typeLabel":"object"},"data":{"description":"Decompiled type-specific body for non-flow content — the same six per-type shapes as the write `data` (fully typed on the content-versions endpoints). Present only with the `data` expand; a flow has no `data` — its body is `steps`.","uniqueKey":"environments.items.[INDEX].publishedVersion.data","typeLabel":"any"},"localizations":{"description":"Per-locale translation status — present only when the `localizations` expand is requested on the content-versions endpoints. One entry per non-default project locale, including locales this version was never translated into.","type":"array","items":{"type":"object","properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.localizations.items.[INDEX].code","typeLabel":"string"},"name":{"type":"string","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.localizations.items.[INDEX].name","typeLabel":"string"},"enabled":{"type":"boolean","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.localizations.items.[INDEX].enabled","typeLabel":"boolean"},"missing":{"type":"number","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.localizations.items.[INDEX].missing","typeLabel":"number"},"outdated":{"type":"number","isRequired":true,"uniqueKey":"environments.items.[INDEX].publishedVersion.localizations.items.[INDEX].outdated","typeLabel":"number"}},"required":["code","name","enabled","missing","outdated"],"uniqueKey":"environments.items.[INDEX].publishedVersion.localizations.items.[INDEX]","typeLabel":"object"},"uniqueKey":"environments.items.[INDEX].publishedVersion.localizations","typeLabel":"object[]"},"scheduledAt":{"description":"Announcement versions only: the \"announcement time\" gating feed visibility and ordering. Absent on other content types and until set (publish stamps it when the author left it null, so published announcements always carry one).","type":"string","uniqueKey":"environments.items.[INDEX].publishedVersion.scheduledAt","typeLabel":"string"}},"required":["id","object","number","firstPublishedAt","themeId","questions","updatedAt","createdAt"],"uniqueKey":"environments.items.[INDEX].publishedVersion","typeLabel":"object"}},"required":["environmentId","published","publishedVersionId","publishedAt"],"uniqueKey":"environments.items.[INDEX]","typeLabel":"object"},"description":"Where this content is live RIGHT NOW: one row per environment it is currently published to (empty = published nowhere). Rows disappear on unpublish.","isRequired":true,"uniqueKey":"environments","typeLabel":"object[]"},"deleted":{"type":"boolean","isRequired":true,"uniqueKey":"deleted","typeLabel":"boolean"},"updatedAt":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"updatedAt","typeLabel":"string\u003cdate-time>"},"createdAt":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"createdAt","typeLabel":"string\u003cdate-time>"},"editedVersion":{"type":"object","properties":{"id":{"type":"string","uniqueKey":"editedVersion.id","typeLabel":"string"},"object":{"type":"string","enum":["contentVersion"],"uniqueKey":"editedVersion.object","typeLabel":"enum\u003cstring>"},"number":{"type":"number","uniqueKey":"editedVersion.number","typeLabel":"number"},"firstPublishedAt":{"oneOf":[{"type":"string","description":"When this version FIRST went live (ISO). Non-null means the version is frozen: it can never be edited again — not even after unpublishing — edit by forking (by forking). null means it never went live — OR its first publish predates this stamp (older versions were never backfilled), so on old data null is not proof it never shipped. This is history, not live state: for \"is it live NOW, where\" read the content's `environments[]`; for who published what when, the publish history (available through the MCP).","uniqueKey":"editedVersion.firstPublishedAt.oneOf.0","typeLabel":"string"},{"type":"null","description":"When this version FIRST went live (ISO). Non-null means the version is frozen: it can never be edited again — not even after unpublishing — edit by forking (by forking). null means it never went live — OR its first publish predates this stamp (older versions were never backfilled), so on old data null is not proof it never shipped. This is history, not live state: for \"is it live NOW, where\" read the content's `environments[]`; for who published what when, the publish history (available through the MCP).","uniqueKey":"editedVersion.firstPublishedAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"editedVersion.firstPublishedAt","typeLabel":"string | null"},"themeId":{"oneOf":[{"type":"string","uniqueKey":"editedVersion.themeId.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"editedVersion.themeId.oneOf.1","typeLabel":"null"}],"uniqueKey":"editedVersion.themeId","typeLabel":"string | null"},"questions":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["question"],"isRequired":true,"uniqueKey":"editedVersion.questions.oneOf.0.items.[INDEX].object","typeLabel":"enum\u003cstring>"},"cvid":{"type":"string","isRequired":true,"uniqueKey":"editedVersion.questions.oneOf.0.items.[INDEX].cvid","typeLabel":"string"},"name":{"type":"string","isRequired":true,"uniqueKey":"editedVersion.questions.oneOf.0.items.[INDEX].name","typeLabel":"string"},"type":{"type":"string","enum":["nps","star-rating","scale","single-line-text","multi-line-text","multiple-choice"],"isRequired":true,"uniqueKey":"editedVersion.questions.oneOf.0.items.[INDEX].type","typeLabel":"enum\u003cstring>"}},"required":["object","cvid","name","type"],"uniqueKey":"editedVersion.questions.oneOf.0.items.[INDEX]","typeLabel":"object"},"uniqueKey":"editedVersion.questions.oneOf.0","typeLabel":"object[]"},{"type":"null","items":{"type":"object","properties":{"object":{"type":"string","enum":["question"]},"cvid":{"type":"string"},"name":{"type":"string"},"type":{"type":"string","enum":["nps","star-rating","scale","single-line-text","multi-line-text","multiple-choice"]}},"required":["object","cvid","name","type"]},"uniqueKey":"editedVersion.questions.oneOf.1","typeLabel":"null"}],"uniqueKey":"editedVersion.questions","typeLabel":"object[] | null"},"steps":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["step"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].object","typeLabel":"enum\u003cstring>"},"id":{"type":"string","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].id","typeLabel":"string"},"cvid":{"oneOf":[{"type":"string","description":"Stable step handle that SURVIVES forking (unlike `id`, which is regenerated) — echo it on a write to update this step in place. Prefer it over `id` for edits that must outlive a new version.","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].cvid.oneOf.0","typeLabel":"string"},{"type":"null","description":"Stable step handle that SURVIVES forking (unlike `id`, which is regenerated) — echo it on a write to update this step in place. Prefer it over `id` for edits that must outlive a new version.","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].cvid.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].cvid","typeLabel":"string | null"},"name":{"type":"string","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].name","typeLabel":"string"},"type":{"type":"string","enum":["tooltip","modal","hidden","bubble"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"sequence":{"type":"number","description":"0-based display order. On write an explicit `sequence` wins; steps without one fall back to their array index.","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].sequence","typeLabel":"number"},"themeId":{"oneOf":[{"type":"string","description":"Per-step theme override; null = this step inherits the flow version's theme.","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].themeId.oneOf.0","typeLabel":"string"},{"type":"null","description":"Per-step theme override; null = this step inherits the flow version's theme.","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].themeId.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].themeId","typeLabel":"string | null"},"content":{"type":"array","items":{"oneOf":[{"type":"object","required":["type","markdown"],"properties":{"type":{"type":"string","enum":["text"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.0.type","typeLabel":"enum\u003cstring>"},"markdown":{"type":"string","description":"A small markdown subset: paragraphs, `# `/`## ` headings (h1/h2 only — no h3+), `-`/`*` and `1.` lists, ``` code fences; inline `**bold**`, `*italic*`, `[text](url)`, and `{{ attribute_code | default: \"x\" }}` for user attributes. Anything outside this subset is SILENTLY normalized, not rejected: h3+ → h2; blockquotes flatten to paragraphs; tables, horizontal rules, strikethrough, inline images/code, and liquid filters other than `default` are dropped. Unsupported syntax won't round-trip — don't rely on it.","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.0.markdown","typeLabel":"string"},"object":{"default":"block","type":"string","enum":["block"],"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.0.object","typeLabel":"enum\u003cstring>"},"id":{"type":"string","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.0.id","typeLabel":"string"}},"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","required":["type","url"],"properties":{"type":{"type":"string","enum":["image"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.1.type","typeLabel":"enum\u003cstring>"},"url":{"type":"string","minLength":1,"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.1.url","typeLabel":"string"},"object":{"default":"block","type":"string","enum":["block"],"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.1.object","typeLabel":"enum\u003cstring>"},"id":{"type":"string","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.1.id","typeLabel":"string"},"alt":{"type":"string","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.1.alt","typeLabel":"string"},"link":{"type":"object","properties":{"url":{"type":"string","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.1.link.url","typeLabel":"string"},"newTab":{"type":"boolean","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.1.link.newTab","typeLabel":"boolean"}},"required":["url"],"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.1.link","typeLabel":"object"},"width":{"type":"object","properties":{"unit":{"type":"string","enum":["percent","pixels"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.1.width.unit","typeLabel":"enum\u003cstring>"},"value":{"type":"number","minimum":0,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.1.width.value","typeLabel":"number"}},"required":["unit"],"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.1.width","typeLabel":"object"},"margin":{"type":"object","properties":{"enabled":{"type":"boolean","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.1.margin.enabled","typeLabel":"boolean"},"top":{"type":"number","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.1.margin.top","typeLabel":"number"},"bottom":{"type":"number","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.1.margin.bottom","typeLabel":"number"},"left":{"type":"number","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.1.margin.left","typeLabel":"number"},"right":{"type":"number","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.1.margin.right","typeLabel":"number"}},"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.1.margin","typeLabel":"object"}},"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.1","typeLabel":"object"},{"type":"object","required":["type","text"],"properties":{"type":{"type":"string","enum":["button"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.type","typeLabel":"enum\u003cstring>"},"text":{"type":"string","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.text","typeLabel":"string"},"object":{"default":"block","type":"string","enum":["block"],"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.object","typeLabel":"enum\u003cstring>"},"id":{"type":"string","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.id","typeLabel":"string"},"actions":{"type":"array","items":{"oneOf":[{"type":"object","required":["type","step"],"properties":{"type":{"type":"string","enum":["goto_step"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.actions.items.[INDEX].oneOf.0.type","typeLabel":"enum\u003cstring>"},"step":{"type":"string","description":"Target step: a step `key` declared elsewhere in the same write, or an existing step cvid. Resolved server-side to the cvid.","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.actions.items.[INDEX].oneOf.0.step","typeLabel":"string"}},"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.actions.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","required":["type","content"],"properties":{"type":{"type":"string","enum":["start_content"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.actions.items.[INDEX].oneOf.1.type","typeLabel":"enum\u003cstring>"},"content":{"type":"string","description":"contentId of the flow or checklist to launch (an id from the content list) — a raw content id, NOT a step key (unlike goto_step). Must reference a flow or checklist (a banner / launcher / resource-center / tracker is rejected at write). The target must be PUBLISHED to actually start at runtime; an unknown/dangling id is rejected at validate.","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.actions.items.[INDEX].oneOf.1.content","typeLabel":"string"},"step":{"description":"Optional cvid of a step within the launched flow to start at.","type":"string","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.actions.items.[INDEX].oneOf.1.step","typeLabel":"string"}},"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.actions.items.[INDEX].oneOf.1","typeLabel":"object"},{"type":"object","required":["type","url"],"properties":{"type":{"type":"string","enum":["navigate"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.actions.items.[INDEX].oneOf.2.type","typeLabel":"enum\u003cstring>"},"url":{"type":"string","description":"Absolute URL, or an app-relative path (\"/docs/x\") resolved against the origin the user is on — relative paths are the normal choice for in-app navigation.","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.actions.items.[INDEX].oneOf.2.url","typeLabel":"string"},"newTab":{"description":"Open the URL in a new browser tab instead of navigating the current one.","type":"boolean","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.actions.items.[INDEX].oneOf.2.newTab","typeLabel":"boolean"}},"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.actions.items.[INDEX].oneOf.2","typeLabel":"object"},{"type":"object","description":"Dismiss the piece the action lives on. NOT accepted everywhere this union appears: a resource center has no dismiss (closing the panel is a UI affordance, not an action) and an announcement is marked seen, never dismissed — writes there are rejected (E1017), not ignored. Flows / checklists / launchers / banners all accept it.","required":["type"],"properties":{"type":{"type":"string","enum":["dismiss"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.actions.items.[INDEX].oneOf.3.type","typeLabel":"enum\u003cstring>"}},"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.actions.items.[INDEX].oneOf.3","typeLabel":"object"},{"type":"object","description":"Read-back of an existing script action — scripts are not authorable through this API. Echo it back UNCHANGED (same script) when rewriting the surrounding list and the stored action is preserved; omitting it deletes it (action lists are full replacements). Authoring a new or edited script is rejected.","required":["type","script"],"properties":{"type":{"type":"string","enum":["run_javascript"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.actions.items.[INDEX].oneOf.4.type","typeLabel":"enum\u003cstring>"},"script":{"type":"string","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.actions.items.[INDEX].oneOf.4.script","typeLabel":"string"}},"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.actions.items.[INDEX].oneOf.4","typeLabel":"object"},{"type":"object","description":"Echo-only placeholder for a stored action this schema cannot express (`note` = internal type). Echo it back to preserve the stored action; writing one fresh is rejected.","required":["type"],"properties":{"type":{"type":"string","enum":["unsupported"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.actions.items.[INDEX].oneOf.5.type","typeLabel":"enum\u003cstring>"},"note":{"type":"string","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.actions.items.[INDEX].oneOf.5.note","typeLabel":"string"}},"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.actions.items.[INDEX].oneOf.5","typeLabel":"object"}],"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.actions.items.[INDEX]","typeLabel":"object"},"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.actions","typeLabel":"object[]"},"disabledWhen":{"description":"REACTIVE slot — polled live in the browser (the button disables the moment the conditions match). Client-evaluable condition types only: attribute / current_url / element / text_input / text_filled / time_window; event / segment / content_state are rejected (E1017).","type":"array","items":{"oneOf":[{"type":"object","required":["type","match","conditions"],"properties":{"type":{"type":"string","enum":["group"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.0.type","typeLabel":"enum\u003cstring>"},"match":{"type":"string","enum":["all","any"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.0.match","typeLabel":"enum\u003cstring>"},"conditions":{"minItems":1,"type":"array","items":{"$circularRef":"8bf0052c-740f-4e24-a54d-effeac73767f"},"description":"The grouped conditions — at least one. An EMPTY group is not \"no filter\": it never matches, so next to an AND it makes the whole rule unmatchable, and writing one is rejected. A version saved with an empty group in the BUILDER still reads back with it (validate warns); writing that list back is refused until the group is filled or dropped.","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.0.conditions","typeLabel":"array"}},"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","required":["type","scope","attribute","op"],"properties":{"type":{"type":"string","enum":["attribute"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.1.type","typeLabel":"enum\u003cstring>"},"scope":{"type":"string","enum":["user","company","companyMembership"],"description":"Which entity owns the attribute — `user` (the end user), `company`, or `companyMembership`. Same value as the attribute definition's `scope` (see the attribute definitions list); required to disambiguate a codeName that exists in more than one scope.","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.1.scope","typeLabel":"enum\u003cstring>"},"attribute":{"type":"string","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.1.attribute","typeLabel":"string"},"op":{"type":"string","enum":["is","not","contains","not_contains","starts_with","ends_with","any","empty","lt","lte","gt","gte","between","true","false","includes_any","includes_all","not_includes_any","not_includes_all","less_than","exactly","more_than","before","on","after"],"description":"Operator — the allowed set depends on the attribute dataType. String: is | not | contains | not_contains | starts_with | ends_with | any | empty. Number: is | not | lt | lte | gt | gte | between | any | empty. Boolean: true | false | any | empty. List: includes_any | includes_all | not_includes_any | not_includes_all | any | empty. DateTime: less_than | exactly | more_than (relative — `value` is a number of days) | before | on | after (`value` is an absolute date) | any | empty. The relative ops are ONE-SIDED bounds around (now − N days): `less_than N` = the date is AFTER now−N — so it also matches every FUTURE date, and on a future-dated attribute (a trial end, a renewal date) it is NOT \"within the last N days\"; `more_than N` = the date is BEFORE now−N. **\"Signed up in the last N days\" therefore needs BOTH bounds** — `less_than N` AND `more_than 0` in one `all` group; `less_than N` alone silently includes anyone whose date is in the future (a mis-mapped trial-end column, a clock/timezone slip), and those are exactly the users a new-user audience must not contain (observed in testing). Negative N shifts the bound into the future: the rolling \"within the NEXT 7 days\" window is `less_than` value \"0\" AND `more_than` value \"-7\" (two conditions, both required). The relative ops are DAY-granularity only — no unit field; for hour/minute windows use an `event` condition with a `within` (which has a `unit`).","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.1.op","typeLabel":"enum\u003cstring>"},"value":{"description":"The comparison value (string / number-as-string / date). Omit for any/empty/true/false.","type":"string","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.1.value","typeLabel":"string"},"value2":{"description":"Upper bound for the `between` operator (`value` is the lower bound).","type":"string","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.1.value2","typeLabel":"string"},"values":{"description":"Values for the List operators (includes_any / includes_all / …).","type":"array","items":{"type":"string","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.1.values.items.[INDEX]","typeLabel":"string"},"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.1.values","typeLabel":"string[]"}},"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.1","typeLabel":"object"},{"type":"object","required":["type","segment","in"],"properties":{"type":{"type":"string","enum":["segment"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.2.type","typeLabel":"enum\u003cstring>"},"segment":{"type":"string","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.2.segment","typeLabel":"string"},"in":{"type":"boolean","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.2.in","typeLabel":"boolean"}},"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.2","typeLabel":"object"},{"type":"object","required":["type","includes"],"properties":{"type":{"type":"string","enum":["current_url"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.3.type","typeLabel":"enum\u003cstring>"},"includes":{"type":"array","items":{"type":"string","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.3.includes.items.[INDEX]","typeLabel":"string"},"description":"URL patterns (anchored whole-url match, NOT substring/regex). `*` = wildcard within one url part; `:name` = one path segment. A bare `*` (i.e. `[\"*\"]`) matches EVERY page on every host incl. deep paths — the canonical always-on / whole-site pattern (use it when content should be available everywhere). Scope it down instead with: `*/` (homepage only — path exactly `/`), `*/pricing` (one page), `*/app/*` (a section + below), `host.com/*` (any page on a specific host). Multiple patterns are OR-matched: the URL matches this list if it matches ANY one pattern (so \"/tasks OR /dashboard\" is one condition with both patterns here — no group needed).","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.3.includes","typeLabel":"string[]"},"excludes":{"description":"URL patterns to exclude (same syntax as includes); excludes win over includes.","type":"array","items":{"type":"string","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.3.excludes.items.[INDEX]","typeLabel":"string"},"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.3.excludes","typeLabel":"string[]"}},"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.3","typeLabel":"object"},{"type":"object","required":["type","state"],"properties":{"type":{"type":"string","enum":["element"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.4.type","typeLabel":"enum\u003cstring>"},"state":{"type":"string","enum":["present","hidden","disabled","enabled","clicked","unclicked"],"description":"`present` means NOT CLIPPED AWAY: the element is in the DOM and its box lies inside the viewport / its scroll ancestors — scrolled off-screen or `display:none` never satisfies it (and `hidden` is its negation). It is NOT \"the user can see something there\": an EMPTY, zero-height placeholder node satisfies `present` (observed in testing: a checklist task keyed on an initially-empty `\u003cp>` status line ticked itself the moment the checklist appeared, before the shopper did anything). So do not use element presence as a proxy for \"the app has said something\": most apps keep the container mounted and only fill in its text. Match the TEXT instead (`target.text` + `present`, or the negation trick: the old text `hidden`). Appearances shorter than about a second can be missed entirely. `disabled`/`enabled` read the element disabled state at evaluation time. **`clicked` means \"clicked since page load AND the element is STILL in the DOM right now\"** — both halves, re-checked every evaluation. The click memory latches (the listener attaches the FIRST time the condition is evaluated, so earlier clicks are invisible, and the memory survives a re-render), but the element lookup is redone each poll. Two consequences, one of them silent: (1) **an element that UNMOUNTS on click can NEVER satisfy it** — the click lands, the element vanishes, the lookup fails from then on and the condition stays false forever with no error (observed in testing: a tracker on a button that clears its own toolbar counted ZERO real clicks); (2) an element that unmounts and REMOUNTS satisfies it again, so a tracker gated on it fires once per remount — not once per page load. Unlike `present`, this lookup does NOT require viewport visibility: scrolling the target off-screen keeps `clicked` true. `unclicked` negates the same pair, so it is also false while the element is absent. To count a COMPLETED action, condition on what the app shows afterwards (a success toast, a state change) rather than `clicked` on the button that starts it.","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.4.state","typeLabel":"enum\u003cstring>"},"target":{"type":"object","properties":{"selector":{"type":"string","minLength":1,"description":"A stable CSS selector for the element, on the page or inside a same-origin iframe (written relative to the frame's own document). The runtime targets the FIRST match — so either make the selector unique, or pair a stable non-unique selector with `nth` to pick the intended match. A non-unique selector with no `nth` targets the first (often wrong) element and the tooltip silently won't render.","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.4.target.selector","typeLabel":"string"},"text":{"description":"Optional refinement of `selector`. Requires the targeted element's visible text to equal this (exact match, after trim) — use it to pin a specific content/state (e.g. a stable id whose displayed text you want to match: id + text). It refines the element chosen by `selector`/`nth`; on its own it does NOT search among multiple matches, so disambiguate a non-unique selector with `nth`, not `text` alone.","type":"string","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.4.target.text","typeLabel":"string"},"nth":{"description":"Optional refinement of `selector`. 0-based index to pick which match when the selector isn't unique — e.g. a stable selector matching 3 elements + `nth: 1` targets the 2nd, giving a unique result. Matches are taken in document order (as they appear in the page HTML). Range 0–4 — only the first 5 matches are addressable; a larger value is rejected.","type":"integer","minimum":0,"maximum":4,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.4.target.nth","typeLabel":"integer"}},"required":["selector"],"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.4.target","typeLabel":"object"}},"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.4","typeLabel":"object"},{"type":"object","required":["type","content","state"],"properties":{"type":{"type":"string","enum":["content_state"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.5.type","typeLabel":"enum\u003cstring>"},"content":{"type":"string","description":"contentId of the FLOW or CHECKLIST whose per-user state to check (an id from the content list). Only flows and checklists record this state — referencing a banner / launcher / resource-center / tracker is rejected at write.","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.5.content","typeLabel":"string"},"state":{"type":"string","enum":["seen","unseen","completed","uncompleted","active","inactive"],"description":"The referenced flow/checklist's state for THIS user. seen = started at least once (for a flow, TRUE from the moment it opens; for a checklist, TRUE only once the user EXPANDS the panel — a `initialDisplay: \"button\"` checklist whose launcher is never clicked stays unseen forever); unseen = never started; active = currently open/running; inactive = NOT currently running (covers both never-started and ran-then-closed); completed = reached a goal/completion step; uncompleted = not completed. To gate piece B until flow A has run AND closed (the usual \"show next thing after the welcome flow\" sequencing), use `seen` AND `inactive` together — `seen` alone fires while A is still open (B piles on top), and `completed` alone strands users who skip/dismiss A.","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.5.state","typeLabel":"enum\u003cstring>"}},"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.5","typeLabel":"object"},{"type":"object","required":["type","event"],"properties":{"type":{"type":"string","enum":["event"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.6.type","typeLabel":"enum\u003cstring>"},"event":{"type":"string","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.6.event","typeLabel":"string"},"count":{"description":"How many times the event must have occurred. Omit it for the common case \"the event has happened\" (treated as at_least 1). Set `op`/`n` for a threshold (`between` needs `n` and `n2`). `at_least`/`between` require n ≥ 1; use `at_most`/`exactly` with 0 for \"never happened\".","type":"object","properties":{"op":{"type":"string","enum":["at_least","at_most","exactly","between"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.6.count.op","typeLabel":"enum\u003cstring>"},"n":{"type":"integer","minimum":0,"maximum":9007199254740991,"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.6.count.n","typeLabel":"integer"},"n2":{"type":"integer","minimum":0,"maximum":9007199254740991,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.6.count.n2","typeLabel":"integer"}},"required":["op","n"],"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.6.count","typeLabel":"object"},"within":{"description":"Optional time window for the event count. Omit it (or use `any_time`) to count over all time — \"the event has ever happened\". Any other `op` (`in_the_last` / `more_than` / `between`) requires BOTH `value` and `unit`, and `between` also `value2` — rejected at write otherwise.","type":"object","properties":{"op":{"type":"string","enum":["in_the_last","more_than","between","any_time"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.6.within.op","typeLabel":"enum\u003cstring>"},"value":{"type":"number","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.6.within.value","typeLabel":"number"},"value2":{"type":"number","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.6.within.value2","typeLabel":"number"},"unit":{"type":"string","enum":["seconds","minutes","hours","days"],"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.6.within.unit","typeLabel":"enum\u003cstring>"}},"required":["op"],"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.6.within","typeLabel":"object"},"scope":{"description":"Whose event activity to count (default `current_user`). `current_user` = only this user's own events. `current_user_in_company` = this user's events, but counted within their currently-associated company context (needs the user associated to a company via `group()` / the company-membership API). `any_user_in_company` = events by ANY user in this user's company — account-level activity (e.g. \"anyone on the account has done X\"). The two company scopes require the user to be in a company or they never match.","type":"string","enum":["current_user","current_user_in_company","any_user_in_company"],"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.6.scope","typeLabel":"enum\u003cstring>"},"where":{"type":"array","items":{"oneOf":[{"type":"object","required":["type","attribute","op"],"properties":{"type":{"type":"string","enum":["event_attribute"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.0.type","typeLabel":"enum\u003cstring>"},"attribute":{"type":"string","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.0.attribute","typeLabel":"string"},"op":{"type":"string","enum":["is","not","contains","not_contains","starts_with","ends_with","any","empty","lt","lte","gt","gte","between","true","false","includes_any","includes_all","not_includes_any","not_includes_all","less_than","exactly","more_than","before","on","after"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.0.op","typeLabel":"enum\u003cstring>"},"value":{"type":"string","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.0.value","typeLabel":"string"},"value2":{"type":"string","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.0.value2","typeLabel":"string"},"values":{"type":"array","items":{"type":"string","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.0.values.items.[INDEX]","typeLabel":"string"},"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.0.values","typeLabel":"string[]"}},"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","required":["type","match","conditions"],"properties":{"type":{"type":"string","enum":["group"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.1.type","typeLabel":"enum\u003cstring>"},"match":{"type":"string","enum":["all","any"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.1.match","typeLabel":"enum\u003cstring>"},"conditions":{"minItems":1,"type":"array","items":{"$circularRef":"7599b088-c1e6-49bf-842c-0ee9fa13f591"},"description":"The grouped conditions — at least one. An EMPTY group is not \"no filter\": it never matches, so next to an AND it makes the whole rule unmatchable, and writing one is rejected. A version saved with an empty group in the BUILDER still reads back with it (validate warns); writing that list back is refused until the group is filled or dropped.","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.1.conditions","typeLabel":"array"}},"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.1","typeLabel":"object"}],"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.6.where.items.[INDEX]","typeLabel":"object"},"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.6.where","typeLabel":"object[]"}},"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.6","typeLabel":"object"},{"type":"object","required":["type","op"],"properties":{"type":{"type":"string","enum":["text_input"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.7.type","typeLabel":"enum\u003cstring>"},"op":{"type":"string","enum":["is","not","contains","not_contains","starts_with","ends_with","match","unmatch","any","empty"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.7.op","typeLabel":"enum\u003cstring>"},"target":{"type":"object","properties":{"selector":{"type":"string","minLength":1,"description":"A stable CSS selector for the element, on the page or inside a same-origin iframe (written relative to the frame's own document). The runtime targets the FIRST match — so either make the selector unique, or pair a stable non-unique selector with `nth` to pick the intended match. A non-unique selector with no `nth` targets the first (often wrong) element and the tooltip silently won't render.","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.7.target.selector","typeLabel":"string"},"text":{"description":"Optional refinement of `selector`. Requires the targeted element's visible text to equal this (exact match, after trim) — use it to pin a specific content/state (e.g. a stable id whose displayed text you want to match: id + text). It refines the element chosen by `selector`/`nth`; on its own it does NOT search among multiple matches, so disambiguate a non-unique selector with `nth`, not `text` alone.","type":"string","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.7.target.text","typeLabel":"string"},"nth":{"description":"Optional refinement of `selector`. 0-based index to pick which match when the selector isn't unique — e.g. a stable selector matching 3 elements + `nth: 1` targets the 2nd, giving a unique result. Matches are taken in document order (as they appear in the page HTML). Range 0–4 — only the first 5 matches are addressable; a larger value is rejected.","type":"integer","minimum":0,"maximum":4,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.7.target.nth","typeLabel":"integer"}},"required":["selector"],"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.7.target","typeLabel":"object"},"value":{"type":"string","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.7.value","typeLabel":"string"}},"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.7","typeLabel":"object"},{"type":"object","required":["type"],"properties":{"type":{"type":"string","enum":["text_filled"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.8.type","typeLabel":"enum\u003cstring>"},"target":{"type":"object","properties":{"selector":{"type":"string","minLength":1,"description":"A stable CSS selector for the element, on the page or inside a same-origin iframe (written relative to the frame's own document). The runtime targets the FIRST match — so either make the selector unique, or pair a stable non-unique selector with `nth` to pick the intended match. A non-unique selector with no `nth` targets the first (often wrong) element and the tooltip silently won't render.","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.8.target.selector","typeLabel":"string"},"text":{"description":"Optional refinement of `selector`. Requires the targeted element's visible text to equal this (exact match, after trim) — use it to pin a specific content/state (e.g. a stable id whose displayed text you want to match: id + text). It refines the element chosen by `selector`/`nth`; on its own it does NOT search among multiple matches, so disambiguate a non-unique selector with `nth`, not `text` alone.","type":"string","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.8.target.text","typeLabel":"string"},"nth":{"description":"Optional refinement of `selector`. 0-based index to pick which match when the selector isn't unique — e.g. a stable selector matching 3 elements + `nth: 1` targets the 2nd, giving a unique result. Matches are taken in document order (as they appear in the page HTML). Range 0–4 — only the first 5 matches are addressable; a larger value is rejected.","type":"integer","minimum":0,"maximum":4,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.8.target.nth","typeLabel":"integer"}},"required":["selector"],"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.8.target","typeLabel":"object"}},"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.8","typeLabel":"object"},{"type":"object","required":["type","start"],"properties":{"type":{"type":"string","enum":["time_window"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.9.type","typeLabel":"enum\u003cstring>"},"start":{"type":"string","description":"Window start (ISO datetime). REQUIRED — the runtime never matches a window without a start, so an end-only window is rejected at write. For \"until X\" semantics, set start to any past instant and end to X.","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.9.start","typeLabel":"string"},"end":{"description":"Window end (ISO datetime). Omit for an open-ended \"from start onwards\" window.","type":"string","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.9.end","typeLabel":"string"}},"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.9","typeLabel":"object"},{"type":"object","description":"Read-side placeholder for a stored condition this API cannot express (`note` says what it stands for — usually a DEAD condition the runtime never matches: a deleted attribute/event, an end-only time window). It cannot be written back (the placeholder carries no data to preserve): echoing it is rejected. Either remove it from the list you write — an explicit choice that DELETES the stored condition; mind that a never-matching node inside an AND list pins the whole rule to \"never fires\", so deleting it can bring the remaining conditions to life — or repair the original condition in the Usertour builder first.","required":["type"],"properties":{"type":{"type":"string","enum":["unsupported"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.10.type","typeLabel":"enum\u003cstring>"},"note":{"type":"string","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.10.note","typeLabel":"string"}},"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX].oneOf.10","typeLabel":"object"}],"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen.items.[INDEX]","typeLabel":"object"},"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.disabledWhen","typeLabel":"object[]"},"hiddenWhen":{"description":"REACTIVE slot — polled live in the browser (the button shows/hides as conditions change). Same client-evaluable-only rule as `disabledWhen`.","type":"array","items":{"oneOf":[{"type":"object","required":["type","match","conditions"],"properties":{"type":{"type":"string","enum":["group"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.0.type","typeLabel":"enum\u003cstring>"},"match":{"type":"string","enum":["all","any"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.0.match","typeLabel":"enum\u003cstring>"},"conditions":{"minItems":1,"type":"array","items":{"$circularRef":"8bf0052c-740f-4e24-a54d-effeac73767f"},"description":"The grouped conditions — at least one. An EMPTY group is not \"no filter\": it never matches, so next to an AND it makes the whole rule unmatchable, and writing one is rejected. A version saved with an empty group in the BUILDER still reads back with it (validate warns); writing that list back is refused until the group is filled or dropped.","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.0.conditions","typeLabel":"array"}},"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","required":["type","scope","attribute","op"],"properties":{"type":{"type":"string","enum":["attribute"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.1.type","typeLabel":"enum\u003cstring>"},"scope":{"type":"string","enum":["user","company","companyMembership"],"description":"Which entity owns the attribute — `user` (the end user), `company`, or `companyMembership`. Same value as the attribute definition's `scope` (see the attribute definitions list); required to disambiguate a codeName that exists in more than one scope.","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.1.scope","typeLabel":"enum\u003cstring>"},"attribute":{"type":"string","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.1.attribute","typeLabel":"string"},"op":{"type":"string","enum":["is","not","contains","not_contains","starts_with","ends_with","any","empty","lt","lte","gt","gte","between","true","false","includes_any","includes_all","not_includes_any","not_includes_all","less_than","exactly","more_than","before","on","after"],"description":"Operator — the allowed set depends on the attribute dataType. String: is | not | contains | not_contains | starts_with | ends_with | any | empty. Number: is | not | lt | lte | gt | gte | between | any | empty. Boolean: true | false | any | empty. List: includes_any | includes_all | not_includes_any | not_includes_all | any | empty. DateTime: less_than | exactly | more_than (relative — `value` is a number of days) | before | on | after (`value` is an absolute date) | any | empty. The relative ops are ONE-SIDED bounds around (now − N days): `less_than N` = the date is AFTER now−N — so it also matches every FUTURE date, and on a future-dated attribute (a trial end, a renewal date) it is NOT \"within the last N days\"; `more_than N` = the date is BEFORE now−N. **\"Signed up in the last N days\" therefore needs BOTH bounds** — `less_than N` AND `more_than 0` in one `all` group; `less_than N` alone silently includes anyone whose date is in the future (a mis-mapped trial-end column, a clock/timezone slip), and those are exactly the users a new-user audience must not contain (observed in testing). Negative N shifts the bound into the future: the rolling \"within the NEXT 7 days\" window is `less_than` value \"0\" AND `more_than` value \"-7\" (two conditions, both required). The relative ops are DAY-granularity only — no unit field; for hour/minute windows use an `event` condition with a `within` (which has a `unit`).","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.1.op","typeLabel":"enum\u003cstring>"},"value":{"description":"The comparison value (string / number-as-string / date). Omit for any/empty/true/false.","type":"string","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.1.value","typeLabel":"string"},"value2":{"description":"Upper bound for the `between` operator (`value` is the lower bound).","type":"string","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.1.value2","typeLabel":"string"},"values":{"description":"Values for the List operators (includes_any / includes_all / …).","type":"array","items":{"type":"string","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.1.values.items.[INDEX]","typeLabel":"string"},"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.1.values","typeLabel":"string[]"}},"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.1","typeLabel":"object"},{"type":"object","required":["type","segment","in"],"properties":{"type":{"type":"string","enum":["segment"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.2.type","typeLabel":"enum\u003cstring>"},"segment":{"type":"string","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.2.segment","typeLabel":"string"},"in":{"type":"boolean","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.2.in","typeLabel":"boolean"}},"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.2","typeLabel":"object"},{"type":"object","required":["type","includes"],"properties":{"type":{"type":"string","enum":["current_url"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.3.type","typeLabel":"enum\u003cstring>"},"includes":{"type":"array","items":{"type":"string","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.3.includes.items.[INDEX]","typeLabel":"string"},"description":"URL patterns (anchored whole-url match, NOT substring/regex). `*` = wildcard within one url part; `:name` = one path segment. A bare `*` (i.e. `[\"*\"]`) matches EVERY page on every host incl. deep paths — the canonical always-on / whole-site pattern (use it when content should be available everywhere). Scope it down instead with: `*/` (homepage only — path exactly `/`), `*/pricing` (one page), `*/app/*` (a section + below), `host.com/*` (any page on a specific host). Multiple patterns are OR-matched: the URL matches this list if it matches ANY one pattern (so \"/tasks OR /dashboard\" is one condition with both patterns here — no group needed).","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.3.includes","typeLabel":"string[]"},"excludes":{"description":"URL patterns to exclude (same syntax as includes); excludes win over includes.","type":"array","items":{"type":"string","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.3.excludes.items.[INDEX]","typeLabel":"string"},"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.3.excludes","typeLabel":"string[]"}},"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.3","typeLabel":"object"},{"type":"object","required":["type","state"],"properties":{"type":{"type":"string","enum":["element"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.4.type","typeLabel":"enum\u003cstring>"},"state":{"type":"string","enum":["present","hidden","disabled","enabled","clicked","unclicked"],"description":"`present` means NOT CLIPPED AWAY: the element is in the DOM and its box lies inside the viewport / its scroll ancestors — scrolled off-screen or `display:none` never satisfies it (and `hidden` is its negation). It is NOT \"the user can see something there\": an EMPTY, zero-height placeholder node satisfies `present` (observed in testing: a checklist task keyed on an initially-empty `\u003cp>` status line ticked itself the moment the checklist appeared, before the shopper did anything). So do not use element presence as a proxy for \"the app has said something\": most apps keep the container mounted and only fill in its text. Match the TEXT instead (`target.text` + `present`, or the negation trick: the old text `hidden`). Appearances shorter than about a second can be missed entirely. `disabled`/`enabled` read the element disabled state at evaluation time. **`clicked` means \"clicked since page load AND the element is STILL in the DOM right now\"** — both halves, re-checked every evaluation. The click memory latches (the listener attaches the FIRST time the condition is evaluated, so earlier clicks are invisible, and the memory survives a re-render), but the element lookup is redone each poll. Two consequences, one of them silent: (1) **an element that UNMOUNTS on click can NEVER satisfy it** — the click lands, the element vanishes, the lookup fails from then on and the condition stays false forever with no error (observed in testing: a tracker on a button that clears its own toolbar counted ZERO real clicks); (2) an element that unmounts and REMOUNTS satisfies it again, so a tracker gated on it fires once per remount — not once per page load. Unlike `present`, this lookup does NOT require viewport visibility: scrolling the target off-screen keeps `clicked` true. `unclicked` negates the same pair, so it is also false while the element is absent. To count a COMPLETED action, condition on what the app shows afterwards (a success toast, a state change) rather than `clicked` on the button that starts it.","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.4.state","typeLabel":"enum\u003cstring>"},"target":{"type":"object","properties":{"selector":{"type":"string","minLength":1,"description":"A stable CSS selector for the element, on the page or inside a same-origin iframe (written relative to the frame's own document). The runtime targets the FIRST match — so either make the selector unique, or pair a stable non-unique selector with `nth` to pick the intended match. A non-unique selector with no `nth` targets the first (often wrong) element and the tooltip silently won't render.","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.4.target.selector","typeLabel":"string"},"text":{"description":"Optional refinement of `selector`. Requires the targeted element's visible text to equal this (exact match, after trim) — use it to pin a specific content/state (e.g. a stable id whose displayed text you want to match: id + text). It refines the element chosen by `selector`/`nth`; on its own it does NOT search among multiple matches, so disambiguate a non-unique selector with `nth`, not `text` alone.","type":"string","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.4.target.text","typeLabel":"string"},"nth":{"description":"Optional refinement of `selector`. 0-based index to pick which match when the selector isn't unique — e.g. a stable selector matching 3 elements + `nth: 1` targets the 2nd, giving a unique result. Matches are taken in document order (as they appear in the page HTML). Range 0–4 — only the first 5 matches are addressable; a larger value is rejected.","type":"integer","minimum":0,"maximum":4,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.4.target.nth","typeLabel":"integer"}},"required":["selector"],"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.4.target","typeLabel":"object"}},"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.4","typeLabel":"object"},{"type":"object","required":["type","content","state"],"properties":{"type":{"type":"string","enum":["content_state"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.5.type","typeLabel":"enum\u003cstring>"},"content":{"type":"string","description":"contentId of the FLOW or CHECKLIST whose per-user state to check (an id from the content list). Only flows and checklists record this state — referencing a banner / launcher / resource-center / tracker is rejected at write.","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.5.content","typeLabel":"string"},"state":{"type":"string","enum":["seen","unseen","completed","uncompleted","active","inactive"],"description":"The referenced flow/checklist's state for THIS user. seen = started at least once (for a flow, TRUE from the moment it opens; for a checklist, TRUE only once the user EXPANDS the panel — a `initialDisplay: \"button\"` checklist whose launcher is never clicked stays unseen forever); unseen = never started; active = currently open/running; inactive = NOT currently running (covers both never-started and ran-then-closed); completed = reached a goal/completion step; uncompleted = not completed. To gate piece B until flow A has run AND closed (the usual \"show next thing after the welcome flow\" sequencing), use `seen` AND `inactive` together — `seen` alone fires while A is still open (B piles on top), and `completed` alone strands users who skip/dismiss A.","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.5.state","typeLabel":"enum\u003cstring>"}},"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.5","typeLabel":"object"},{"type":"object","required":["type","event"],"properties":{"type":{"type":"string","enum":["event"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.6.type","typeLabel":"enum\u003cstring>"},"event":{"type":"string","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.6.event","typeLabel":"string"},"count":{"description":"How many times the event must have occurred. Omit it for the common case \"the event has happened\" (treated as at_least 1). Set `op`/`n` for a threshold (`between` needs `n` and `n2`). `at_least`/`between` require n ≥ 1; use `at_most`/`exactly` with 0 for \"never happened\".","type":"object","properties":{"op":{"type":"string","enum":["at_least","at_most","exactly","between"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.6.count.op","typeLabel":"enum\u003cstring>"},"n":{"type":"integer","minimum":0,"maximum":9007199254740991,"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.6.count.n","typeLabel":"integer"},"n2":{"type":"integer","minimum":0,"maximum":9007199254740991,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.6.count.n2","typeLabel":"integer"}},"required":["op","n"],"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.6.count","typeLabel":"object"},"within":{"description":"Optional time window for the event count. Omit it (or use `any_time`) to count over all time — \"the event has ever happened\". Any other `op` (`in_the_last` / `more_than` / `between`) requires BOTH `value` and `unit`, and `between` also `value2` — rejected at write otherwise.","type":"object","properties":{"op":{"type":"string","enum":["in_the_last","more_than","between","any_time"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.6.within.op","typeLabel":"enum\u003cstring>"},"value":{"type":"number","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.6.within.value","typeLabel":"number"},"value2":{"type":"number","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.6.within.value2","typeLabel":"number"},"unit":{"type":"string","enum":["seconds","minutes","hours","days"],"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.6.within.unit","typeLabel":"enum\u003cstring>"}},"required":["op"],"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.6.within","typeLabel":"object"},"scope":{"description":"Whose event activity to count (default `current_user`). `current_user` = only this user's own events. `current_user_in_company` = this user's events, but counted within their currently-associated company context (needs the user associated to a company via `group()` / the company-membership API). `any_user_in_company` = events by ANY user in this user's company — account-level activity (e.g. \"anyone on the account has done X\"). The two company scopes require the user to be in a company or they never match.","type":"string","enum":["current_user","current_user_in_company","any_user_in_company"],"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.6.scope","typeLabel":"enum\u003cstring>"},"where":{"type":"array","items":{"oneOf":[{"type":"object","required":["type","attribute","op"],"properties":{"type":{"type":"string","enum":["event_attribute"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.0.type","typeLabel":"enum\u003cstring>"},"attribute":{"type":"string","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.0.attribute","typeLabel":"string"},"op":{"type":"string","enum":["is","not","contains","not_contains","starts_with","ends_with","any","empty","lt","lte","gt","gte","between","true","false","includes_any","includes_all","not_includes_any","not_includes_all","less_than","exactly","more_than","before","on","after"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.0.op","typeLabel":"enum\u003cstring>"},"value":{"type":"string","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.0.value","typeLabel":"string"},"value2":{"type":"string","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.0.value2","typeLabel":"string"},"values":{"type":"array","items":{"type":"string","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.0.values.items.[INDEX]","typeLabel":"string"},"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.0.values","typeLabel":"string[]"}},"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","required":["type","match","conditions"],"properties":{"type":{"type":"string","enum":["group"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.1.type","typeLabel":"enum\u003cstring>"},"match":{"type":"string","enum":["all","any"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.1.match","typeLabel":"enum\u003cstring>"},"conditions":{"minItems":1,"type":"array","items":{"$circularRef":"7599b088-c1e6-49bf-842c-0ee9fa13f591"},"description":"The grouped conditions — at least one. An EMPTY group is not \"no filter\": it never matches, so next to an AND it makes the whole rule unmatchable, and writing one is rejected. A version saved with an empty group in the BUILDER still reads back with it (validate warns); writing that list back is refused until the group is filled or dropped.","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.1.conditions","typeLabel":"array"}},"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.1","typeLabel":"object"}],"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.6.where.items.[INDEX]","typeLabel":"object"},"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.6.where","typeLabel":"object[]"}},"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.6","typeLabel":"object"},{"type":"object","required":["type","op"],"properties":{"type":{"type":"string","enum":["text_input"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.7.type","typeLabel":"enum\u003cstring>"},"op":{"type":"string","enum":["is","not","contains","not_contains","starts_with","ends_with","match","unmatch","any","empty"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.7.op","typeLabel":"enum\u003cstring>"},"target":{"type":"object","properties":{"selector":{"type":"string","minLength":1,"description":"A stable CSS selector for the element, on the page or inside a same-origin iframe (written relative to the frame's own document). The runtime targets the FIRST match — so either make the selector unique, or pair a stable non-unique selector with `nth` to pick the intended match. A non-unique selector with no `nth` targets the first (often wrong) element and the tooltip silently won't render.","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.7.target.selector","typeLabel":"string"},"text":{"description":"Optional refinement of `selector`. Requires the targeted element's visible text to equal this (exact match, after trim) — use it to pin a specific content/state (e.g. a stable id whose displayed text you want to match: id + text). It refines the element chosen by `selector`/`nth`; on its own it does NOT search among multiple matches, so disambiguate a non-unique selector with `nth`, not `text` alone.","type":"string","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.7.target.text","typeLabel":"string"},"nth":{"description":"Optional refinement of `selector`. 0-based index to pick which match when the selector isn't unique — e.g. a stable selector matching 3 elements + `nth: 1` targets the 2nd, giving a unique result. Matches are taken in document order (as they appear in the page HTML). Range 0–4 — only the first 5 matches are addressable; a larger value is rejected.","type":"integer","minimum":0,"maximum":4,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.7.target.nth","typeLabel":"integer"}},"required":["selector"],"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.7.target","typeLabel":"object"},"value":{"type":"string","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.7.value","typeLabel":"string"}},"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.7","typeLabel":"object"},{"type":"object","required":["type"],"properties":{"type":{"type":"string","enum":["text_filled"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.8.type","typeLabel":"enum\u003cstring>"},"target":{"type":"object","properties":{"selector":{"type":"string","minLength":1,"description":"A stable CSS selector for the element, on the page or inside a same-origin iframe (written relative to the frame's own document). The runtime targets the FIRST match — so either make the selector unique, or pair a stable non-unique selector with `nth` to pick the intended match. A non-unique selector with no `nth` targets the first (often wrong) element and the tooltip silently won't render.","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.8.target.selector","typeLabel":"string"},"text":{"description":"Optional refinement of `selector`. Requires the targeted element's visible text to equal this (exact match, after trim) — use it to pin a specific content/state (e.g. a stable id whose displayed text you want to match: id + text). It refines the element chosen by `selector`/`nth`; on its own it does NOT search among multiple matches, so disambiguate a non-unique selector with `nth`, not `text` alone.","type":"string","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.8.target.text","typeLabel":"string"},"nth":{"description":"Optional refinement of `selector`. 0-based index to pick which match when the selector isn't unique — e.g. a stable selector matching 3 elements + `nth: 1` targets the 2nd, giving a unique result. Matches are taken in document order (as they appear in the page HTML). Range 0–4 — only the first 5 matches are addressable; a larger value is rejected.","type":"integer","minimum":0,"maximum":4,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.8.target.nth","typeLabel":"integer"}},"required":["selector"],"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.8.target","typeLabel":"object"}},"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.8","typeLabel":"object"},{"type":"object","required":["type","start"],"properties":{"type":{"type":"string","enum":["time_window"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.9.type","typeLabel":"enum\u003cstring>"},"start":{"type":"string","description":"Window start (ISO datetime). REQUIRED — the runtime never matches a window without a start, so an end-only window is rejected at write. For \"until X\" semantics, set start to any past instant and end to X.","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.9.start","typeLabel":"string"},"end":{"description":"Window end (ISO datetime). Omit for an open-ended \"from start onwards\" window.","type":"string","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.9.end","typeLabel":"string"}},"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.9","typeLabel":"object"},{"type":"object","description":"Read-side placeholder for a stored condition this API cannot express (`note` says what it stands for — usually a DEAD condition the runtime never matches: a deleted attribute/event, an end-only time window). It cannot be written back (the placeholder carries no data to preserve): echoing it is rejected. Either remove it from the list you write — an explicit choice that DELETES the stored condition; mind that a never-matching node inside an AND list pins the whole rule to \"never fires\", so deleting it can bring the remaining conditions to life — or repair the original condition in the Usertour builder first.","required":["type"],"properties":{"type":{"type":"string","enum":["unsupported"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.10.type","typeLabel":"enum\u003cstring>"},"note":{"type":"string","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.10.note","typeLabel":"string"}},"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX].oneOf.10","typeLabel":"object"}],"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen.items.[INDEX]","typeLabel":"object"},"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.hiddenWhen","typeLabel":"object[]"},"variant":{"type":"string","enum":["primary","secondary"],"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.variant","typeLabel":"enum\u003cstring>"},"margin":{"type":"object","properties":{"enabled":{"type":"boolean","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.margin.enabled","typeLabel":"boolean"},"top":{"type":"number","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.margin.top","typeLabel":"number"},"bottom":{"type":"number","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.margin.bottom","typeLabel":"number"},"left":{"type":"number","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.margin.left","typeLabel":"number"},"right":{"type":"number","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.margin.right","typeLabel":"number"}},"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2.margin","typeLabel":"object"}},"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.2","typeLabel":"object"},{"type":"object","required":["type","url"],"properties":{"type":{"type":"string","enum":["embed"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.3.type","typeLabel":"enum\u003cstring>"},"url":{"type":"string","minLength":1,"description":"Paste the page's normal URL (e.g. a youtube.com/watch link) — on write it is resolved through the standard oEmbed provider registry (YouTube, Vimeo, Loom, Figma, …) and the provider's official embed markup is stored, so you never hand-build /embed/ URLs. A URL no provider claims is iframed as-is — it renders only if that site allows being framed (no X-Frame-Options/CSP block).","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.3.url","typeLabel":"string"},"object":{"default":"block","type":"string","enum":["block"],"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.3.object","typeLabel":"enum\u003cstring>"},"id":{"type":"string","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.3.id","typeLabel":"string"},"width":{"type":"object","properties":{"unit":{"type":"string","enum":["percent","pixels"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.3.width.unit","typeLabel":"enum\u003cstring>"},"value":{"type":"number","minimum":0,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.3.width.value","typeLabel":"number"}},"required":["unit"],"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.3.width","typeLabel":"object"},"height":{"description":"Embed height. Optional ONLY for provider embeds (YouTube/Vimeo/… size themselves by aspect ratio); a URL with NO oEmbed provider has no ratio, and omitting a pixel height leaves the iframe at the browser's built-in default — a strip ~150px tall, almost never the intended size (validate warns). For plain-iframe URLs always set `{ \"unit\": \"pixels\", \"value\": … }`.","type":"object","properties":{"unit":{"type":"string","enum":["percent","pixels"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.3.height.unit","typeLabel":"enum\u003cstring>"},"value":{"type":"number","minimum":0,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.3.height.value","typeLabel":"number"}},"required":["unit"],"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.3.height","typeLabel":"object"},"margin":{"type":"object","properties":{"enabled":{"type":"boolean","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.3.margin.enabled","typeLabel":"boolean"},"top":{"type":"number","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.3.margin.top","typeLabel":"number"},"bottom":{"type":"number","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.3.margin.bottom","typeLabel":"number"},"left":{"type":"number","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.3.margin.left","typeLabel":"number"},"right":{"type":"number","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.3.margin.right","typeLabel":"number"}},"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.3.margin","typeLabel":"object"}},"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.3","typeLabel":"object"},{"type":"object","required":["type","question"],"properties":{"type":{"type":"string","enum":["question"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.type","typeLabel":"enum\u003cstring>"},"question":{"oneOf":[{"type":"object","required":["kind","name"],"properties":{"kind":{"type":"string","enum":["nps"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.question.oneOf.0.kind","typeLabel":"enum\u003cstring>"},"name":{"type":"string","description":"The question's internal name / analytics label (it is the `questionName` on captured responses). It is NOT rendered to the user — the widget shows only the input (scale / options / text field), not this string. To show a visible question prompt, add a `text` block in the SAME step before the question block; a question with only a `name` renders as bare options with no question text.","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.question.oneOf.0.name","typeLabel":"string"},"cvid":{"type":"string","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.question.oneOf.0.cvid","typeLabel":"string"},"lowLabel":{"type":"string","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.question.oneOf.0.lowLabel","typeLabel":"string"},"highLabel":{"type":"string","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.question.oneOf.0.highLabel","typeLabel":"string"},"bindAttribute":{"description":"Optional: codeName of an EXISTING attribute (create the attribute definition first) to ALSO save this answer onto the user for targeting/segmentation — use the codeName, NOT the id. The write does not check it, but the version validation WARNS when the attribute is missing or its dataType mismatches the answer — read warnings. A wrong code that slips through silently captures nothing at runtime. Match the attribute dataType to the answer: number (nps / rating), string (single-select choice), list (multi-select choice). Leaving it unset still records the answer as a response event — bind only when you need to target/segment on it.","type":"string","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.question.oneOf.0.bindAttribute","typeLabel":"string"}},"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.question.oneOf.0","typeLabel":"object"},{"type":"object","required":["kind","name","style","range"],"properties":{"kind":{"type":"string","enum":["rating"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.question.oneOf.1.kind","typeLabel":"enum\u003cstring>"},"name":{"type":"string","description":"The question's internal name / analytics label (it is the `questionName` on captured responses). It is NOT rendered to the user — the widget shows only the input (scale / options / text field), not this string. To show a visible question prompt, add a `text` block in the SAME step before the question block; a question with only a `name` renders as bare options with no question text.","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.question.oneOf.1.name","typeLabel":"string"},"style":{"type":"string","enum":["star","scale"],"description":"star = star rating; scale = a numeric scale. A \"scale\" question IS a rating with style:\"scale\" — there is no separate \"scale\" kind.","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.question.oneOf.1.style","typeLabel":"enum\u003cstring>"},"range":{"type":"object","properties":{"low":{"type":"number","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.question.oneOf.1.range.low","typeLabel":"number"},"high":{"type":"number","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.question.oneOf.1.range.high","typeLabel":"number"}},"required":["low","high"],"description":"Numeric range, e.g. { low: 1, high: 5 }.","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.question.oneOf.1.range","typeLabel":"object"},"cvid":{"type":"string","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.question.oneOf.1.cvid","typeLabel":"string"},"lowLabel":{"type":"string","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.question.oneOf.1.lowLabel","typeLabel":"string"},"highLabel":{"type":"string","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.question.oneOf.1.highLabel","typeLabel":"string"},"bindAttribute":{"description":"Optional: codeName of an EXISTING attribute (create the attribute definition first) to ALSO save this answer onto the user for targeting/segmentation — use the codeName, NOT the id. The write does not check it, but the version validation WARNS when the attribute is missing or its dataType mismatches the answer — read warnings. A wrong code that slips through silently captures nothing at runtime. Match the attribute dataType to the answer: number (nps / rating), string (single-select choice), list (multi-select choice). Leaving it unset still records the answer as a response event — bind only when you need to target/segment on it.","type":"string","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.question.oneOf.1.bindAttribute","typeLabel":"string"}},"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.question.oneOf.1","typeLabel":"object"},{"type":"object","required":["kind","name","multiline"],"properties":{"kind":{"type":"string","enum":["text"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.question.oneOf.2.kind","typeLabel":"enum\u003cstring>"},"name":{"type":"string","description":"The question's internal name / analytics label (it is the `questionName` on captured responses). It is NOT rendered to the user — the widget shows only the input (scale / options / text field), not this string. To show a visible question prompt, add a `text` block in the SAME step before the question block; a question with only a `name` renders as bare options with no question text.","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.question.oneOf.2.name","typeLabel":"string"},"multiline":{"type":"boolean","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.question.oneOf.2.multiline","typeLabel":"boolean"},"cvid":{"type":"string","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.question.oneOf.2.cvid","typeLabel":"string"},"placeholder":{"type":"string","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.question.oneOf.2.placeholder","typeLabel":"string"},"buttonText":{"type":"string","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.question.oneOf.2.buttonText","typeLabel":"string"},"required":{"description":"Require an answer before submit. ONLY `text` supports this — nps / rating / choice cannot be marked required.","type":"boolean","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.question.oneOf.2.required","typeLabel":"boolean"},"bindAttribute":{"description":"Optional: codeName of an EXISTING attribute (create the attribute definition first) to ALSO save this answer onto the user for targeting/segmentation — use the codeName, NOT the id. The write does not check it, but the version validation WARNS when the attribute is missing or its dataType mismatches the answer — read warnings. A wrong code that slips through silently captures nothing at runtime. Match the attribute dataType to the answer: number (nps / rating), string (single-select choice), list (multi-select choice). Leaving it unset still records the answer as a response event — bind only when you need to target/segment on it.","type":"string","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.question.oneOf.2.bindAttribute","typeLabel":"string"}},"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.question.oneOf.2","typeLabel":"object"},{"type":"object","required":["kind","name","options","allowMultiple"],"properties":{"kind":{"type":"string","enum":["choice"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.question.oneOf.3.kind","typeLabel":"enum\u003cstring>"},"name":{"type":"string","description":"The question's internal name / analytics label (it is the `questionName` on captured responses). It is NOT rendered to the user — the widget shows only the input (scale / options / text field), not this string. To show a visible question prompt, add a `text` block in the SAME step before the question block; a question with only a `name` renders as bare options with no question text.","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.question.oneOf.3.name","typeLabel":"string"},"options":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.question.oneOf.3.options.items.[INDEX].label","typeLabel":"string"},"value":{"type":"string","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.question.oneOf.3.options.items.[INDEX].value","typeLabel":"string"}},"required":["label","value"],"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.question.oneOf.3.options.items.[INDEX]","typeLabel":"object"},"description":"Each option has a human-facing `label` and a stored `value` — the `value` is what gets recorded/bound as the answer.","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.question.oneOf.3.options","typeLabel":"object[]"},"allowMultiple":{"type":"boolean","description":"false = single-select, true = multi-select. A multi-select answer needs a `list`-typed bound attribute.","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.question.oneOf.3.allowMultiple","typeLabel":"boolean"},"cvid":{"type":"string","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.question.oneOf.3.cvid","typeLabel":"string"},"enableOther":{"type":"boolean","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.question.oneOf.3.enableOther","typeLabel":"boolean"},"otherPlaceholder":{"type":"string","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.question.oneOf.3.otherPlaceholder","typeLabel":"string"},"shuffle":{"type":"boolean","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.question.oneOf.3.shuffle","typeLabel":"boolean"},"buttonText":{"type":"string","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.question.oneOf.3.buttonText","typeLabel":"string"},"bindAttribute":{"description":"Optional: codeName of an EXISTING attribute (create the attribute definition first) to ALSO save this answer onto the user for targeting/segmentation — use the codeName, NOT the id. The write does not check it, but the version validation WARNS when the attribute is missing or its dataType mismatches the answer — read warnings. A wrong code that slips through silently captures nothing at runtime. Match the attribute dataType to the answer: number (nps / rating), string (single-select choice), list (multi-select choice). Leaving it unset still records the answer as a response event — bind only when you need to target/segment on it.","type":"string","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.question.oneOf.3.bindAttribute","typeLabel":"string"}},"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.question.oneOf.3","typeLabel":"object"}],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.question","typeLabel":"object"},"object":{"default":"block","type":"string","enum":["block"],"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.object","typeLabel":"enum\u003cstring>"},"id":{"type":"string","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.id","typeLabel":"string"},"actions":{"description":"Actions that fire when this question is answered (on pick for nps/rating/single-select; on its Submit button for text/multi-select). Put a `goto_step` HERE to advance to the next step — without it the question records the answer but the flow does NOT advance (validate flags the next step \"not reachable\"). Do NOT add a separate `button` block just to advance: it doubles up with the question's own submit affordance.","type":"array","items":{"oneOf":[{"type":"object","required":["type","step"],"properties":{"type":{"type":"string","enum":["goto_step"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.actions.items.[INDEX].oneOf.0.type","typeLabel":"enum\u003cstring>"},"step":{"type":"string","description":"Target step: a step `key` declared elsewhere in the same write, or an existing step cvid. Resolved server-side to the cvid.","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.actions.items.[INDEX].oneOf.0.step","typeLabel":"string"}},"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.actions.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","required":["type","content"],"properties":{"type":{"type":"string","enum":["start_content"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.actions.items.[INDEX].oneOf.1.type","typeLabel":"enum\u003cstring>"},"content":{"type":"string","description":"contentId of the flow or checklist to launch (an id from the content list) — a raw content id, NOT a step key (unlike goto_step). Must reference a flow or checklist (a banner / launcher / resource-center / tracker is rejected at write). The target must be PUBLISHED to actually start at runtime; an unknown/dangling id is rejected at validate.","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.actions.items.[INDEX].oneOf.1.content","typeLabel":"string"},"step":{"description":"Optional cvid of a step within the launched flow to start at.","type":"string","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.actions.items.[INDEX].oneOf.1.step","typeLabel":"string"}},"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.actions.items.[INDEX].oneOf.1","typeLabel":"object"},{"type":"object","required":["type","url"],"properties":{"type":{"type":"string","enum":["navigate"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.actions.items.[INDEX].oneOf.2.type","typeLabel":"enum\u003cstring>"},"url":{"type":"string","description":"Absolute URL, or an app-relative path (\"/docs/x\") resolved against the origin the user is on — relative paths are the normal choice for in-app navigation.","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.actions.items.[INDEX].oneOf.2.url","typeLabel":"string"},"newTab":{"description":"Open the URL in a new browser tab instead of navigating the current one.","type":"boolean","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.actions.items.[INDEX].oneOf.2.newTab","typeLabel":"boolean"}},"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.actions.items.[INDEX].oneOf.2","typeLabel":"object"},{"type":"object","description":"Dismiss the piece the action lives on. NOT accepted everywhere this union appears: a resource center has no dismiss (closing the panel is a UI affordance, not an action) and an announcement is marked seen, never dismissed — writes there are rejected (E1017), not ignored. Flows / checklists / launchers / banners all accept it.","required":["type"],"properties":{"type":{"type":"string","enum":["dismiss"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.actions.items.[INDEX].oneOf.3.type","typeLabel":"enum\u003cstring>"}},"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.actions.items.[INDEX].oneOf.3","typeLabel":"object"},{"type":"object","description":"Read-back of an existing script action — scripts are not authorable through this API. Echo it back UNCHANGED (same script) when rewriting the surrounding list and the stored action is preserved; omitting it deletes it (action lists are full replacements). Authoring a new or edited script is rejected.","required":["type","script"],"properties":{"type":{"type":"string","enum":["run_javascript"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.actions.items.[INDEX].oneOf.4.type","typeLabel":"enum\u003cstring>"},"script":{"type":"string","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.actions.items.[INDEX].oneOf.4.script","typeLabel":"string"}},"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.actions.items.[INDEX].oneOf.4","typeLabel":"object"},{"type":"object","description":"Echo-only placeholder for a stored action this schema cannot express (`note` = internal type). Echo it back to preserve the stored action; writing one fresh is rejected.","required":["type"],"properties":{"type":{"type":"string","enum":["unsupported"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.actions.items.[INDEX].oneOf.5.type","typeLabel":"enum\u003cstring>"},"note":{"type":"string","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.actions.items.[INDEX].oneOf.5.note","typeLabel":"string"}},"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.actions.items.[INDEX].oneOf.5","typeLabel":"object"}],"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.actions.items.[INDEX]","typeLabel":"object"},"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4.actions","typeLabel":"object[]"}},"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.4","typeLabel":"object"},{"type":"object","description":"Lays 2+ blocks out side by side in one row. Top-level `content` blocks otherwise stack vertically — each is its own full-width row — so two `button` blocks placed directly in `content` render as two stacked rows, NOT a button pair. For a modal/tooltip footer with a Skip + primary button: one `columns` block with two `{ width: { unit: \"fill\" }, blocks: [...] }` entries, one button per column.","required":["type","columns"],"properties":{"type":{"type":"string","enum":["columns"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.5.type","typeLabel":"enum\u003cstring>"},"columns":{"type":"array","items":{"type":"object","properties":{"blocks":{"type":"array","items":{"$circularRef":"cbc2a478-9fbf-4840-91c6-77587e9b8cf5"},"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.5.columns.items.[INDEX].blocks","typeLabel":"array"},"width":{"type":"object","properties":{"unit":{"type":"string","enum":["percent","pixels","fill"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.5.columns.items.[INDEX].width.unit","typeLabel":"enum\u003cstring>"},"value":{"type":"number","minimum":0,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.5.columns.items.[INDEX].width.value","typeLabel":"number"}},"required":["unit"],"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.5.columns.items.[INDEX].width","typeLabel":"object"},"justify":{"description":"Horizontal alignment of this column's own block(s) within the column's width — use \"end\"/\"center\" to right-align or center a lone button (a single-column `columns` block).","type":"string","enum":["start","center","end","between","around","evenly"],"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.5.columns.items.[INDEX].justify","typeLabel":"enum\u003cstring>"},"align":{"type":"string","enum":["start","center","end","baseline"],"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.5.columns.items.[INDEX].align","typeLabel":"enum\u003cstring>"},"padding":{"type":"object","properties":{"enabled":{"type":"boolean","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.5.columns.items.[INDEX].padding.enabled","typeLabel":"boolean"},"top":{"type":"number","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.5.columns.items.[INDEX].padding.top","typeLabel":"number"},"bottom":{"type":"number","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.5.columns.items.[INDEX].padding.bottom","typeLabel":"number"},"left":{"type":"number","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.5.columns.items.[INDEX].padding.left","typeLabel":"number"},"right":{"type":"number","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.5.columns.items.[INDEX].padding.right","typeLabel":"number"}},"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.5.columns.items.[INDEX].padding","typeLabel":"object"}},"required":["blocks"],"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.5.columns.items.[INDEX]","typeLabel":"object"},"description":"One entry per column, laid out left-to-right. Each column is a mini vertical stack of `blocks` (usually one).","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.5.columns","typeLabel":"object[]"},"object":{"default":"block","type":"string","enum":["block"],"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.5.object","typeLabel":"enum\u003cstring>"},"id":{"type":"string","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.5.id","typeLabel":"string"}},"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.5","typeLabel":"object"},{"type":"object","required":["type"],"properties":{"type":{"type":"string","enum":["unsupported"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.6.type","typeLabel":"enum\u003cstring>"},"object":{"default":"block","type":"string","enum":["block"],"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.6.object","typeLabel":"enum\u003cstring>"},"id":{"type":"string","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.6.id","typeLabel":"string"},"note":{"type":"string","uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.6.note","typeLabel":"string"}},"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX].oneOf.6","typeLabel":"object"}],"uniqueKey":"editedVersion.steps.items.[INDEX].content.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].content","typeLabel":"object[]"},"target":{"type":"object","properties":{"selector":{"type":"string","minLength":1,"description":"A stable CSS selector for the element, on the page or inside a same-origin iframe (written relative to the frame's own document). The runtime targets the FIRST match — so either make the selector unique, or pair a stable non-unique selector with `nth` to pick the intended match. A non-unique selector with no `nth` targets the first (often wrong) element and the tooltip silently won't render.","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].target.selector","typeLabel":"string"},"text":{"description":"Optional refinement of `selector`. Requires the targeted element's visible text to equal this (exact match, after trim) — use it to pin a specific content/state (e.g. a stable id whose displayed text you want to match: id + text). It refines the element chosen by `selector`/`nth`; on its own it does NOT search among multiple matches, so disambiguate a non-unique selector with `nth`, not `text` alone.","type":"string","uniqueKey":"editedVersion.steps.items.[INDEX].target.text","typeLabel":"string"},"nth":{"description":"Optional refinement of `selector`. 0-based index to pick which match when the selector isn't unique — e.g. a stable selector matching 3 elements + `nth: 1` targets the 2nd, giving a unique result. Matches are taken in document order (as they appear in the page HTML). Range 0–4 — only the first 5 matches are addressable; a larger value is rejected.","type":"integer","minimum":0,"maximum":4,"uniqueKey":"editedVersion.steps.items.[INDEX].target.nth","typeLabel":"integer"}},"required":["selector"],"uniqueKey":"editedVersion.steps.items.[INDEX].target","typeLabel":"object"},"placement":{"oneOf":[{"type":"object","description":"Two placement shapes, by step kind: a TOOLTIP (anchored to a `target`) uses `{ side, align, sideOffset?, alignOffset?, alignType? }` positioned relative to the element; a MODAL uses `{ position, offsetX?, offsetY? }` on a 9-cell viewport grid (e.g. `\"center\"`). Both may set `backdrop`; `blockTarget` is TOOLTIP-ONLY (a modal already covers the page) and additionally requires `backdrop: true` — it makes the backdrop swallow clicks on the highlighted element. A BUBBLE step is positioned by its THEME's bubble placement, so the only key it accepts here is `{ backdrop }` (positional keys are rejected — move the bubble by changing the theme); a HIDDEN step renders no UI and rejects `placement` entirely.","properties":{"side":{"description":"Which side of the target the tooltip sits on. OMIT side+align to auto-position (the tooltip picks a spot and flips to avoid the viewport edge — best when you can't see the element). Setting side (or align) pins that direction: the tooltip renders exactly there and no longer auto-flips, so only pin when the element is not near a screen edge. When READING a step back, check `alignType` first: under `auto` the side/align you see are just the auto starting position, not a pin.","type":"string","enum":["top","right","bottom","left"],"uniqueKey":"editedVersion.steps.items.[INDEX].placement.oneOf.0.side","typeLabel":"enum\u003cstring>"},"align":{"description":"Alignment along the side. See `side`.","type":"string","enum":["start","center","end"],"uniqueKey":"editedVersion.steps.items.[INDEX].placement.oneOf.0.align","typeLabel":"enum\u003cstring>"},"sideOffset":{"description":"Pixels between the target and the tooltip, along `side`.","type":"number","uniqueKey":"editedVersion.steps.items.[INDEX].placement.oneOf.0.sideOffset","typeLabel":"number"},"alignOffset":{"description":"Pixel shift along the alignment axis. Only applies when `align` is `start` or `end` — at `center` alignment the runtime ignores it silently.","type":"number","uniqueKey":"editedVersion.steps.items.[INDEX].placement.oneOf.0.alignOffset","typeLabel":"number"},"alignType":{"description":"Position mode. `auto` auto-positions and flips to avoid the viewport edge (ignoring side/align); `fixed` pins to side/align without flipping. Usually omit it: providing side/align implies `fixed`, and omitting them implies `auto`. Set it only to override that (e.g. `auto` while still passing a side/align you want ignored). Read-backs always carry concrete side/align even in `auto` mode (the auto starting position, bottom/center) — `alignType` is what governs, and `auto` still flips at runtime.","type":"string","enum":["auto","fixed"],"uniqueKey":"editedVersion.steps.items.[INDEX].placement.oneOf.0.alignType","typeLabel":"enum\u003cstring>"},"backdrop":{"description":"Dim the rest of the page while this tooltip is up.","type":"boolean","uniqueKey":"editedVersion.steps.items.[INDEX].placement.oneOf.0.backdrop","typeLabel":"boolean"},"blockTarget":{"description":"Make the backdrop swallow clicks on the highlighted element, so the user must use the tooltip. REQUIRES `backdrop: true` — on its own it does nothing (the renderer only consults it inside the backdrop branch).","type":"boolean","uniqueKey":"editedVersion.steps.items.[INDEX].placement.oneOf.0.blockTarget","typeLabel":"boolean"}},"additionalProperties":false,"uniqueKey":"editedVersion.steps.items.[INDEX].placement.oneOf.0","typeLabel":"object"},{"type":"object","description":"Two placement shapes, by step kind: a TOOLTIP (anchored to a `target`) uses `{ side, align, sideOffset?, alignOffset?, alignType? }` positioned relative to the element; a MODAL uses `{ position, offsetX?, offsetY? }` on a 9-cell viewport grid (e.g. `\"center\"`). Both may set `backdrop`; `blockTarget` is TOOLTIP-ONLY (a modal already covers the page) and additionally requires `backdrop: true` — it makes the backdrop swallow clicks on the highlighted element. A BUBBLE step is positioned by its THEME's bubble placement, so the only key it accepts here is `{ backdrop }` (positional keys are rejected — move the bubble by changing the theme); a HIDDEN step renders no UI and rejects `placement` entirely.","required":["position"],"properties":{"position":{"type":"string","enum":["leftTop","centerTop","rightTop","leftCenter","center","rightCenter","leftBottom","centerBottom","rightBottom"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].placement.oneOf.1.position","typeLabel":"enum\u003cstring>"},"offsetX":{"description":"Pixel shift from the grid cell. Applies in every cell EXCEPT `position: \"center\"`, where both offsets are ignored silently.","type":"number","uniqueKey":"editedVersion.steps.items.[INDEX].placement.oneOf.1.offsetX","typeLabel":"number"},"offsetY":{"description":"See `offsetX`.","type":"number","uniqueKey":"editedVersion.steps.items.[INDEX].placement.oneOf.1.offsetY","typeLabel":"number"},"backdrop":{"type":"boolean","uniqueKey":"editedVersion.steps.items.[INDEX].placement.oneOf.1.backdrop","typeLabel":"boolean"}},"additionalProperties":false,"uniqueKey":"editedVersion.steps.items.[INDEX].placement.oneOf.1","typeLabel":"object"}],"uniqueKey":"editedVersion.steps.items.[INDEX].placement","typeLabel":"object"},"width":{"description":"Per-step width override in pixels (border-box outer width) — absent = the theme's surface width.","type":"number","uniqueKey":"editedVersion.steps.items.[INDEX].width","typeLabel":"number"},"skippable":{"type":"boolean","uniqueKey":"editedVersion.steps.items.[INDEX].skippable","typeLabel":"boolean"},"explicitCompletionStep":{"description":"Marks this step as the flow's completion point: reaching it counts the flow as COMPLETED (progress hits 100 and the completion event fires there), and later steps no longer report progress. With no step marked, only reaching the LAST step completes the flow — which is what a checklist task waiting on \"this flow completed\" depends on.","type":"boolean","uniqueKey":"editedVersion.steps.items.[INDEX].explicitCompletionStep","typeLabel":"boolean"},"triggers":{"type":"array","items":{"type":"object","properties":{"do":{"type":"array","items":{"oneOf":[{"type":"object","required":["type","step"],"properties":{"type":{"type":"string","enum":["goto_step"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].do.items.[INDEX].oneOf.0.type","typeLabel":"enum\u003cstring>"},"step":{"type":"string","description":"Target step: a step `key` declared elsewhere in the same write, or an existing step cvid. Resolved server-side to the cvid.","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].do.items.[INDEX].oneOf.0.step","typeLabel":"string"}},"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].do.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","required":["type","content"],"properties":{"type":{"type":"string","enum":["start_content"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].do.items.[INDEX].oneOf.1.type","typeLabel":"enum\u003cstring>"},"content":{"type":"string","description":"contentId of the flow or checklist to launch (an id from the content list) — a raw content id, NOT a step key (unlike goto_step). Must reference a flow or checklist (a banner / launcher / resource-center / tracker is rejected at write). The target must be PUBLISHED to actually start at runtime; an unknown/dangling id is rejected at validate.","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].do.items.[INDEX].oneOf.1.content","typeLabel":"string"},"step":{"description":"Optional cvid of a step within the launched flow to start at.","type":"string","uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].do.items.[INDEX].oneOf.1.step","typeLabel":"string"}},"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].do.items.[INDEX].oneOf.1","typeLabel":"object"},{"type":"object","required":["type","url"],"properties":{"type":{"type":"string","enum":["navigate"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].do.items.[INDEX].oneOf.2.type","typeLabel":"enum\u003cstring>"},"url":{"type":"string","description":"Absolute URL, or an app-relative path (\"/docs/x\") resolved against the origin the user is on — relative paths are the normal choice for in-app navigation.","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].do.items.[INDEX].oneOf.2.url","typeLabel":"string"},"newTab":{"description":"Open the URL in a new browser tab instead of navigating the current one.","type":"boolean","uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].do.items.[INDEX].oneOf.2.newTab","typeLabel":"boolean"}},"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].do.items.[INDEX].oneOf.2","typeLabel":"object"},{"type":"object","description":"Dismiss the piece the action lives on. NOT accepted everywhere this union appears: a resource center has no dismiss (closing the panel is a UI affordance, not an action) and an announcement is marked seen, never dismissed — writes there are rejected (E1017), not ignored. Flows / checklists / launchers / banners all accept it.","required":["type"],"properties":{"type":{"type":"string","enum":["dismiss"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].do.items.[INDEX].oneOf.3.type","typeLabel":"enum\u003cstring>"}},"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].do.items.[INDEX].oneOf.3","typeLabel":"object"},{"type":"object","description":"Read-back of an existing script action — scripts are not authorable through this API. Echo it back UNCHANGED (same script) when rewriting the surrounding list and the stored action is preserved; omitting it deletes it (action lists are full replacements). Authoring a new or edited script is rejected.","required":["type","script"],"properties":{"type":{"type":"string","enum":["run_javascript"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].do.items.[INDEX].oneOf.4.type","typeLabel":"enum\u003cstring>"},"script":{"type":"string","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].do.items.[INDEX].oneOf.4.script","typeLabel":"string"}},"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].do.items.[INDEX].oneOf.4","typeLabel":"object"},{"type":"object","description":"Echo-only placeholder for a stored action this schema cannot express (`note` = internal type). Echo it back to preserve the stored action; writing one fresh is rejected.","required":["type"],"properties":{"type":{"type":"string","enum":["unsupported"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].do.items.[INDEX].oneOf.5.type","typeLabel":"enum\u003cstring>"},"note":{"type":"string","uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].do.items.[INDEX].oneOf.5.note","typeLabel":"string"}},"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].do.items.[INDEX].oneOf.5","typeLabel":"object"}],"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].do.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].do","typeLabel":"object[]"},"when":{"description":"REACTIVE slot — polled live in the browser while the step is on screen, so it accepts only client-evaluable condition types: attribute / current_url / element / text_input / text_filled / time_window. Event / segment / content_state conditions are server-evaluated and rejected here (E1017). A trigger with NO `when` never fires (an empty set is \"not matched\", not \"always\").","type":"array","items":{"oneOf":[{"type":"object","required":["type","match","conditions"],"properties":{"type":{"type":"string","enum":["group"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.0.type","typeLabel":"enum\u003cstring>"},"match":{"type":"string","enum":["all","any"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.0.match","typeLabel":"enum\u003cstring>"},"conditions":{"minItems":1,"type":"array","items":{"$circularRef":"8bf0052c-740f-4e24-a54d-effeac73767f"},"description":"The grouped conditions — at least one. An EMPTY group is not \"no filter\": it never matches, so next to an AND it makes the whole rule unmatchable, and writing one is rejected. A version saved with an empty group in the BUILDER still reads back with it (validate warns); writing that list back is refused until the group is filled or dropped.","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.0.conditions","typeLabel":"array"}},"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","required":["type","scope","attribute","op"],"properties":{"type":{"type":"string","enum":["attribute"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.1.type","typeLabel":"enum\u003cstring>"},"scope":{"type":"string","enum":["user","company","companyMembership"],"description":"Which entity owns the attribute — `user` (the end user), `company`, or `companyMembership`. Same value as the attribute definition's `scope` (see the attribute definitions list); required to disambiguate a codeName that exists in more than one scope.","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.1.scope","typeLabel":"enum\u003cstring>"},"attribute":{"type":"string","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.1.attribute","typeLabel":"string"},"op":{"type":"string","enum":["is","not","contains","not_contains","starts_with","ends_with","any","empty","lt","lte","gt","gte","between","true","false","includes_any","includes_all","not_includes_any","not_includes_all","less_than","exactly","more_than","before","on","after"],"description":"Operator — the allowed set depends on the attribute dataType. String: is | not | contains | not_contains | starts_with | ends_with | any | empty. Number: is | not | lt | lte | gt | gte | between | any | empty. Boolean: true | false | any | empty. List: includes_any | includes_all | not_includes_any | not_includes_all | any | empty. DateTime: less_than | exactly | more_than (relative — `value` is a number of days) | before | on | after (`value` is an absolute date) | any | empty. The relative ops are ONE-SIDED bounds around (now − N days): `less_than N` = the date is AFTER now−N — so it also matches every FUTURE date, and on a future-dated attribute (a trial end, a renewal date) it is NOT \"within the last N days\"; `more_than N` = the date is BEFORE now−N. **\"Signed up in the last N days\" therefore needs BOTH bounds** — `less_than N` AND `more_than 0` in one `all` group; `less_than N` alone silently includes anyone whose date is in the future (a mis-mapped trial-end column, a clock/timezone slip), and those are exactly the users a new-user audience must not contain (observed in testing). Negative N shifts the bound into the future: the rolling \"within the NEXT 7 days\" window is `less_than` value \"0\" AND `more_than` value \"-7\" (two conditions, both required). The relative ops are DAY-granularity only — no unit field; for hour/minute windows use an `event` condition with a `within` (which has a `unit`).","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.1.op","typeLabel":"enum\u003cstring>"},"value":{"description":"The comparison value (string / number-as-string / date). Omit for any/empty/true/false.","type":"string","uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.1.value","typeLabel":"string"},"value2":{"description":"Upper bound for the `between` operator (`value` is the lower bound).","type":"string","uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.1.value2","typeLabel":"string"},"values":{"description":"Values for the List operators (includes_any / includes_all / …).","type":"array","items":{"type":"string","uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.1.values.items.[INDEX]","typeLabel":"string"},"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.1.values","typeLabel":"string[]"}},"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.1","typeLabel":"object"},{"type":"object","required":["type","segment","in"],"properties":{"type":{"type":"string","enum":["segment"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.2.type","typeLabel":"enum\u003cstring>"},"segment":{"type":"string","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.2.segment","typeLabel":"string"},"in":{"type":"boolean","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.2.in","typeLabel":"boolean"}},"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.2","typeLabel":"object"},{"type":"object","required":["type","includes"],"properties":{"type":{"type":"string","enum":["current_url"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.3.type","typeLabel":"enum\u003cstring>"},"includes":{"type":"array","items":{"type":"string","uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.3.includes.items.[INDEX]","typeLabel":"string"},"description":"URL patterns (anchored whole-url match, NOT substring/regex). `*` = wildcard within one url part; `:name` = one path segment. A bare `*` (i.e. `[\"*\"]`) matches EVERY page on every host incl. deep paths — the canonical always-on / whole-site pattern (use it when content should be available everywhere). Scope it down instead with: `*/` (homepage only — path exactly `/`), `*/pricing` (one page), `*/app/*` (a section + below), `host.com/*` (any page on a specific host). Multiple patterns are OR-matched: the URL matches this list if it matches ANY one pattern (so \"/tasks OR /dashboard\" is one condition with both patterns here — no group needed).","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.3.includes","typeLabel":"string[]"},"excludes":{"description":"URL patterns to exclude (same syntax as includes); excludes win over includes.","type":"array","items":{"type":"string","uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.3.excludes.items.[INDEX]","typeLabel":"string"},"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.3.excludes","typeLabel":"string[]"}},"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.3","typeLabel":"object"},{"type":"object","required":["type","state"],"properties":{"type":{"type":"string","enum":["element"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.4.type","typeLabel":"enum\u003cstring>"},"state":{"type":"string","enum":["present","hidden","disabled","enabled","clicked","unclicked"],"description":"`present` means NOT CLIPPED AWAY: the element is in the DOM and its box lies inside the viewport / its scroll ancestors — scrolled off-screen or `display:none` never satisfies it (and `hidden` is its negation). It is NOT \"the user can see something there\": an EMPTY, zero-height placeholder node satisfies `present` (observed in testing: a checklist task keyed on an initially-empty `\u003cp>` status line ticked itself the moment the checklist appeared, before the shopper did anything). So do not use element presence as a proxy for \"the app has said something\": most apps keep the container mounted and only fill in its text. Match the TEXT instead (`target.text` + `present`, or the negation trick: the old text `hidden`). Appearances shorter than about a second can be missed entirely. `disabled`/`enabled` read the element disabled state at evaluation time. **`clicked` means \"clicked since page load AND the element is STILL in the DOM right now\"** — both halves, re-checked every evaluation. The click memory latches (the listener attaches the FIRST time the condition is evaluated, so earlier clicks are invisible, and the memory survives a re-render), but the element lookup is redone each poll. Two consequences, one of them silent: (1) **an element that UNMOUNTS on click can NEVER satisfy it** — the click lands, the element vanishes, the lookup fails from then on and the condition stays false forever with no error (observed in testing: a tracker on a button that clears its own toolbar counted ZERO real clicks); (2) an element that unmounts and REMOUNTS satisfies it again, so a tracker gated on it fires once per remount — not once per page load. Unlike `present`, this lookup does NOT require viewport visibility: scrolling the target off-screen keeps `clicked` true. `unclicked` negates the same pair, so it is also false while the element is absent. To count a COMPLETED action, condition on what the app shows afterwards (a success toast, a state change) rather than `clicked` on the button that starts it.","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.4.state","typeLabel":"enum\u003cstring>"},"target":{"type":"object","properties":{"selector":{"type":"string","minLength":1,"description":"A stable CSS selector for the element, on the page or inside a same-origin iframe (written relative to the frame's own document). The runtime targets the FIRST match — so either make the selector unique, or pair a stable non-unique selector with `nth` to pick the intended match. A non-unique selector with no `nth` targets the first (often wrong) element and the tooltip silently won't render.","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.4.target.selector","typeLabel":"string"},"text":{"description":"Optional refinement of `selector`. Requires the targeted element's visible text to equal this (exact match, after trim) — use it to pin a specific content/state (e.g. a stable id whose displayed text you want to match: id + text). It refines the element chosen by `selector`/`nth`; on its own it does NOT search among multiple matches, so disambiguate a non-unique selector with `nth`, not `text` alone.","type":"string","uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.4.target.text","typeLabel":"string"},"nth":{"description":"Optional refinement of `selector`. 0-based index to pick which match when the selector isn't unique — e.g. a stable selector matching 3 elements + `nth: 1` targets the 2nd, giving a unique result. Matches are taken in document order (as they appear in the page HTML). Range 0–4 — only the first 5 matches are addressable; a larger value is rejected.","type":"integer","minimum":0,"maximum":4,"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.4.target.nth","typeLabel":"integer"}},"required":["selector"],"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.4.target","typeLabel":"object"}},"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.4","typeLabel":"object"},{"type":"object","required":["type","content","state"],"properties":{"type":{"type":"string","enum":["content_state"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.5.type","typeLabel":"enum\u003cstring>"},"content":{"type":"string","description":"contentId of the FLOW or CHECKLIST whose per-user state to check (an id from the content list). Only flows and checklists record this state — referencing a banner / launcher / resource-center / tracker is rejected at write.","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.5.content","typeLabel":"string"},"state":{"type":"string","enum":["seen","unseen","completed","uncompleted","active","inactive"],"description":"The referenced flow/checklist's state for THIS user. seen = started at least once (for a flow, TRUE from the moment it opens; for a checklist, TRUE only once the user EXPANDS the panel — a `initialDisplay: \"button\"` checklist whose launcher is never clicked stays unseen forever); unseen = never started; active = currently open/running; inactive = NOT currently running (covers both never-started and ran-then-closed); completed = reached a goal/completion step; uncompleted = not completed. To gate piece B until flow A has run AND closed (the usual \"show next thing after the welcome flow\" sequencing), use `seen` AND `inactive` together — `seen` alone fires while A is still open (B piles on top), and `completed` alone strands users who skip/dismiss A.","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.5.state","typeLabel":"enum\u003cstring>"}},"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.5","typeLabel":"object"},{"type":"object","required":["type","event"],"properties":{"type":{"type":"string","enum":["event"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.6.type","typeLabel":"enum\u003cstring>"},"event":{"type":"string","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.6.event","typeLabel":"string"},"count":{"description":"How many times the event must have occurred. Omit it for the common case \"the event has happened\" (treated as at_least 1). Set `op`/`n` for a threshold (`between` needs `n` and `n2`). `at_least`/`between` require n ≥ 1; use `at_most`/`exactly` with 0 for \"never happened\".","type":"object","properties":{"op":{"type":"string","enum":["at_least","at_most","exactly","between"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.6.count.op","typeLabel":"enum\u003cstring>"},"n":{"type":"integer","minimum":0,"maximum":9007199254740991,"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.6.count.n","typeLabel":"integer"},"n2":{"type":"integer","minimum":0,"maximum":9007199254740991,"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.6.count.n2","typeLabel":"integer"}},"required":["op","n"],"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.6.count","typeLabel":"object"},"within":{"description":"Optional time window for the event count. Omit it (or use `any_time`) to count over all time — \"the event has ever happened\". Any other `op` (`in_the_last` / `more_than` / `between`) requires BOTH `value` and `unit`, and `between` also `value2` — rejected at write otherwise.","type":"object","properties":{"op":{"type":"string","enum":["in_the_last","more_than","between","any_time"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.6.within.op","typeLabel":"enum\u003cstring>"},"value":{"type":"number","uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.6.within.value","typeLabel":"number"},"value2":{"type":"number","uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.6.within.value2","typeLabel":"number"},"unit":{"type":"string","enum":["seconds","minutes","hours","days"],"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.6.within.unit","typeLabel":"enum\u003cstring>"}},"required":["op"],"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.6.within","typeLabel":"object"},"scope":{"description":"Whose event activity to count (default `current_user`). `current_user` = only this user's own events. `current_user_in_company` = this user's events, but counted within their currently-associated company context (needs the user associated to a company via `group()` / the company-membership API). `any_user_in_company` = events by ANY user in this user's company — account-level activity (e.g. \"anyone on the account has done X\"). The two company scopes require the user to be in a company or they never match.","type":"string","enum":["current_user","current_user_in_company","any_user_in_company"],"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.6.scope","typeLabel":"enum\u003cstring>"},"where":{"type":"array","items":{"oneOf":[{"type":"object","required":["type","attribute","op"],"properties":{"type":{"type":"string","enum":["event_attribute"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.0.type","typeLabel":"enum\u003cstring>"},"attribute":{"type":"string","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.0.attribute","typeLabel":"string"},"op":{"type":"string","enum":["is","not","contains","not_contains","starts_with","ends_with","any","empty","lt","lte","gt","gte","between","true","false","includes_any","includes_all","not_includes_any","not_includes_all","less_than","exactly","more_than","before","on","after"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.0.op","typeLabel":"enum\u003cstring>"},"value":{"type":"string","uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.0.value","typeLabel":"string"},"value2":{"type":"string","uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.0.value2","typeLabel":"string"},"values":{"type":"array","items":{"type":"string","uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.0.values.items.[INDEX]","typeLabel":"string"},"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.0.values","typeLabel":"string[]"}},"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","required":["type","match","conditions"],"properties":{"type":{"type":"string","enum":["group"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.1.type","typeLabel":"enum\u003cstring>"},"match":{"type":"string","enum":["all","any"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.1.match","typeLabel":"enum\u003cstring>"},"conditions":{"minItems":1,"type":"array","items":{"$circularRef":"7599b088-c1e6-49bf-842c-0ee9fa13f591"},"description":"The grouped conditions — at least one. An EMPTY group is not \"no filter\": it never matches, so next to an AND it makes the whole rule unmatchable, and writing one is rejected. A version saved with an empty group in the BUILDER still reads back with it (validate warns); writing that list back is refused until the group is filled or dropped.","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.1.conditions","typeLabel":"array"}},"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.1","typeLabel":"object"}],"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.6.where.items.[INDEX]","typeLabel":"object"},"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.6.where","typeLabel":"object[]"}},"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.6","typeLabel":"object"},{"type":"object","required":["type","op"],"properties":{"type":{"type":"string","enum":["text_input"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.7.type","typeLabel":"enum\u003cstring>"},"op":{"type":"string","enum":["is","not","contains","not_contains","starts_with","ends_with","match","unmatch","any","empty"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.7.op","typeLabel":"enum\u003cstring>"},"target":{"type":"object","properties":{"selector":{"type":"string","minLength":1,"description":"A stable CSS selector for the element, on the page or inside a same-origin iframe (written relative to the frame's own document). The runtime targets the FIRST match — so either make the selector unique, or pair a stable non-unique selector with `nth` to pick the intended match. A non-unique selector with no `nth` targets the first (often wrong) element and the tooltip silently won't render.","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.7.target.selector","typeLabel":"string"},"text":{"description":"Optional refinement of `selector`. Requires the targeted element's visible text to equal this (exact match, after trim) — use it to pin a specific content/state (e.g. a stable id whose displayed text you want to match: id + text). It refines the element chosen by `selector`/`nth`; on its own it does NOT search among multiple matches, so disambiguate a non-unique selector with `nth`, not `text` alone.","type":"string","uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.7.target.text","typeLabel":"string"},"nth":{"description":"Optional refinement of `selector`. 0-based index to pick which match when the selector isn't unique — e.g. a stable selector matching 3 elements + `nth: 1` targets the 2nd, giving a unique result. Matches are taken in document order (as they appear in the page HTML). Range 0–4 — only the first 5 matches are addressable; a larger value is rejected.","type":"integer","minimum":0,"maximum":4,"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.7.target.nth","typeLabel":"integer"}},"required":["selector"],"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.7.target","typeLabel":"object"},"value":{"type":"string","uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.7.value","typeLabel":"string"}},"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.7","typeLabel":"object"},{"type":"object","required":["type"],"properties":{"type":{"type":"string","enum":["text_filled"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.8.type","typeLabel":"enum\u003cstring>"},"target":{"type":"object","properties":{"selector":{"type":"string","minLength":1,"description":"A stable CSS selector for the element, on the page or inside a same-origin iframe (written relative to the frame's own document). The runtime targets the FIRST match — so either make the selector unique, or pair a stable non-unique selector with `nth` to pick the intended match. A non-unique selector with no `nth` targets the first (often wrong) element and the tooltip silently won't render.","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.8.target.selector","typeLabel":"string"},"text":{"description":"Optional refinement of `selector`. Requires the targeted element's visible text to equal this (exact match, after trim) — use it to pin a specific content/state (e.g. a stable id whose displayed text you want to match: id + text). It refines the element chosen by `selector`/`nth`; on its own it does NOT search among multiple matches, so disambiguate a non-unique selector with `nth`, not `text` alone.","type":"string","uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.8.target.text","typeLabel":"string"},"nth":{"description":"Optional refinement of `selector`. 0-based index to pick which match when the selector isn't unique — e.g. a stable selector matching 3 elements + `nth: 1` targets the 2nd, giving a unique result. Matches are taken in document order (as they appear in the page HTML). Range 0–4 — only the first 5 matches are addressable; a larger value is rejected.","type":"integer","minimum":0,"maximum":4,"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.8.target.nth","typeLabel":"integer"}},"required":["selector"],"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.8.target","typeLabel":"object"}},"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.8","typeLabel":"object"},{"type":"object","required":["type","start"],"properties":{"type":{"type":"string","enum":["time_window"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.9.type","typeLabel":"enum\u003cstring>"},"start":{"type":"string","description":"Window start (ISO datetime). REQUIRED — the runtime never matches a window without a start, so an end-only window is rejected at write. For \"until X\" semantics, set start to any past instant and end to X.","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.9.start","typeLabel":"string"},"end":{"description":"Window end (ISO datetime). Omit for an open-ended \"from start onwards\" window.","type":"string","uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.9.end","typeLabel":"string"}},"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.9","typeLabel":"object"},{"type":"object","description":"Read-side placeholder for a stored condition this API cannot express (`note` says what it stands for — usually a DEAD condition the runtime never matches: a deleted attribute/event, an end-only time window). It cannot be written back (the placeholder carries no data to preserve): echoing it is rejected. Either remove it from the list you write — an explicit choice that DELETES the stored condition; mind that a never-matching node inside an AND list pins the whole rule to \"never fires\", so deleting it can bring the remaining conditions to life — or repair the original condition in the Usertour builder first.","required":["type"],"properties":{"type":{"type":"string","enum":["unsupported"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.10.type","typeLabel":"enum\u003cstring>"},"note":{"type":"string","uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.10.note","typeLabel":"string"}},"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX].oneOf.10","typeLabel":"object"}],"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].when.items.[INDEX]","typeLabel":"object"},"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].when","typeLabel":"object[]"},"waitSeconds":{"description":"Delay in SECONDS between the `when` conditions matching and the `do` actions firing. The timer arms the first time `when` matches and the actions fire after the wait EVEN IF the conditions have since stopped matching (the match is latched, not re-checked). Capped at 300 seconds by the runtime (a larger value is clamped).","type":"number","uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX].waitSeconds","typeLabel":"number"}},"required":["do"],"uniqueKey":"editedVersion.steps.items.[INDEX].triggers.items.[INDEX]","typeLabel":"object"},"uniqueKey":"editedVersion.steps.items.[INDEX].triggers","typeLabel":"object[]"},"onClick":{"description":"Actions that run when the user clicks the step's TARGET ELEMENT on the page (click-to-advance) — distinct from a `button` block, whose actions fire on a button rendered inside the step. `tooltip` steps only: the other kinds have no target element to click, and the write rejects `onClick` on them.","type":"array","items":{"oneOf":[{"type":"object","required":["type","step"],"properties":{"type":{"type":"string","enum":["goto_step"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].onClick.items.[INDEX].oneOf.0.type","typeLabel":"enum\u003cstring>"},"step":{"type":"string","description":"Target step: a step `key` declared elsewhere in the same write, or an existing step cvid. Resolved server-side to the cvid.","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].onClick.items.[INDEX].oneOf.0.step","typeLabel":"string"}},"uniqueKey":"editedVersion.steps.items.[INDEX].onClick.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","required":["type","content"],"properties":{"type":{"type":"string","enum":["start_content"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].onClick.items.[INDEX].oneOf.1.type","typeLabel":"enum\u003cstring>"},"content":{"type":"string","description":"contentId of the flow or checklist to launch (an id from the content list) — a raw content id, NOT a step key (unlike goto_step). Must reference a flow or checklist (a banner / launcher / resource-center / tracker is rejected at write). The target must be PUBLISHED to actually start at runtime; an unknown/dangling id is rejected at validate.","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].onClick.items.[INDEX].oneOf.1.content","typeLabel":"string"},"step":{"description":"Optional cvid of a step within the launched flow to start at.","type":"string","uniqueKey":"editedVersion.steps.items.[INDEX].onClick.items.[INDEX].oneOf.1.step","typeLabel":"string"}},"uniqueKey":"editedVersion.steps.items.[INDEX].onClick.items.[INDEX].oneOf.1","typeLabel":"object"},{"type":"object","required":["type","url"],"properties":{"type":{"type":"string","enum":["navigate"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].onClick.items.[INDEX].oneOf.2.type","typeLabel":"enum\u003cstring>"},"url":{"type":"string","description":"Absolute URL, or an app-relative path (\"/docs/x\") resolved against the origin the user is on — relative paths are the normal choice for in-app navigation.","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].onClick.items.[INDEX].oneOf.2.url","typeLabel":"string"},"newTab":{"description":"Open the URL in a new browser tab instead of navigating the current one.","type":"boolean","uniqueKey":"editedVersion.steps.items.[INDEX].onClick.items.[INDEX].oneOf.2.newTab","typeLabel":"boolean"}},"uniqueKey":"editedVersion.steps.items.[INDEX].onClick.items.[INDEX].oneOf.2","typeLabel":"object"},{"type":"object","description":"Dismiss the piece the action lives on. NOT accepted everywhere this union appears: a resource center has no dismiss (closing the panel is a UI affordance, not an action) and an announcement is marked seen, never dismissed — writes there are rejected (E1017), not ignored. Flows / checklists / launchers / banners all accept it.","required":["type"],"properties":{"type":{"type":"string","enum":["dismiss"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].onClick.items.[INDEX].oneOf.3.type","typeLabel":"enum\u003cstring>"}},"uniqueKey":"editedVersion.steps.items.[INDEX].onClick.items.[INDEX].oneOf.3","typeLabel":"object"},{"type":"object","description":"Read-back of an existing script action — scripts are not authorable through this API. Echo it back UNCHANGED (same script) when rewriting the surrounding list and the stored action is preserved; omitting it deletes it (action lists are full replacements). Authoring a new or edited script is rejected.","required":["type","script"],"properties":{"type":{"type":"string","enum":["run_javascript"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].onClick.items.[INDEX].oneOf.4.type","typeLabel":"enum\u003cstring>"},"script":{"type":"string","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].onClick.items.[INDEX].oneOf.4.script","typeLabel":"string"}},"uniqueKey":"editedVersion.steps.items.[INDEX].onClick.items.[INDEX].oneOf.4","typeLabel":"object"},{"type":"object","description":"Echo-only placeholder for a stored action this schema cannot express (`note` = internal type). Echo it back to preserve the stored action; writing one fresh is rejected.","required":["type"],"properties":{"type":{"type":"string","enum":["unsupported"],"isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].onClick.items.[INDEX].oneOf.5.type","typeLabel":"enum\u003cstring>"},"note":{"type":"string","uniqueKey":"editedVersion.steps.items.[INDEX].onClick.items.[INDEX].oneOf.5.note","typeLabel":"string"}},"uniqueKey":"editedVersion.steps.items.[INDEX].onClick.items.[INDEX].oneOf.5","typeLabel":"object"}],"uniqueKey":"editedVersion.steps.items.[INDEX].onClick.items.[INDEX]","typeLabel":"object"},"uniqueKey":"editedVersion.steps.items.[INDEX].onClick","typeLabel":"object[]"},"advanced":{"type":"object","properties":{"hasUnsupported":{"type":"boolean","description":"true = this step carries stored configuration this API cannot express (e.g. an auto-recorded element fingerprint). Read-only signal: echoing the step back preserves that configuration untouched; it is not editable here.","isRequired":true,"uniqueKey":"editedVersion.steps.items.[INDEX].advanced.hasUnsupported","typeLabel":"boolean"}},"required":["hasUnsupported"],"uniqueKey":"editedVersion.steps.items.[INDEX].advanced","typeLabel":"object"}},"required":["object","id","cvid","name","type","sequence","themeId","content"],"uniqueKey":"editedVersion.steps.items.[INDEX]","typeLabel":"object"},"uniqueKey":"editedVersion.steps","typeLabel":"object[]"},"startRules":{"type":"object","properties":{"when":{"description":"Start conditions (full replacement when present). Omit to keep the existing conditions and change only the settings.","type":"array","items":{"oneOf":[{"type":"object","required":["type","match","conditions"],"properties":{"type":{"type":"string","enum":["group"],"isRequired":true,"uniqueKey":"editedVersion.startRules.when.items.[INDEX].oneOf.0.type","typeLabel":"enum\u003cstring>"},"match":{"type":"string","enum":["all","any"],"isRequired":true,"uniqueKey":"editedVersion.startRules.when.items.[INDEX].oneOf.0.match","typeLabel":"enum\u003cstring>"},"conditions":{"minItems":1,"type":"array","items":{"$circularRef":"8bf0052c-740f-4e24-a54d-effeac73767f"},"description":"The grouped conditions — at least one. An EMPTY group is not \"no filter\": it never matches, so next to an AND it makes the whole rule unmatchable, and writing one is rejected. A version saved with an empty group in the BUILDER still reads back with it (validate warns); writing that list back is refused until the group is filled or dropped.","isRequired":true,"uniqueKey":"editedVersion.startRules.when.items.[INDEX].oneOf.0.conditions","typeLabel":"array"}},"uniqueKey":"editedVersion.startRules.when.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","required":["type","scope","attribute","op"],"properties":{"type":{"type":"string","enum":["attribute"],"isRequired":true,"uniqueKey":"editedVersion.startRules.when.items.[INDEX].oneOf.1.type","typeLabel":"enum\u003cstring>"},"scope":{"type":"string","enum":["user","company","companyMembership"],"description":"Which entity owns the attribute — `user` (the end user), `company`, or `companyMembership`. Same value as the attribute definition's `scope` (see the attribute definitions list); required to disambiguate a codeName that exists in more than one scope.","isRequired":true,"uniqueKey":"editedVersion.startRules.when.items.[INDEX].oneOf.1.scope","typeLabel":"enum\u003cstring>"},"attribute":{"type":"string","isRequired":true,"uniqueKey":"editedVersion.startRules.when.items.[INDEX].oneOf.1.attribute","typeLabel":"string"},"op":{"type":"string","enum":["is","not","contains","not_contains","starts_with","ends_with","any","empty","lt","lte","gt","gte","between","true","false","includes_any","includes_all","not_includes_any","not_includes_all","less_than","exactly","more_than","before","on","after"],"description":"Operator — the allowed set depends on the attribute dataType. String: is | not | contains | not_contains | starts_with | ends_with | any | empty. Number: is | not | lt | lte | gt | gte | between | any | empty. Boolean: true | false | any | empty. List: includes_any | includes_all | not_includes_any | not_includes_all | any | empty. DateTime: less_than | exactly | more_than (relative — `value` is a number of days) | before | on | after (`value` is an absolute date) | any | empty. The relative ops are ONE-SIDED bounds around (now − N days): `less_than N` = the date is AFTER now−N — so it also matches every FUTURE date, and on a future-dated attribute (a trial end, a renewal date) it is NOT \"within the last N days\"; `more_than N` = the date is BEFORE now−N. **\"Signed up in the last N days\" therefore needs BOTH bounds** — `less_than N` AND `more_than 0` in one `all` group; `less_than N` alone silently includes anyone whose date is in the future (a mis-mapped trial-end column, a clock/timezone slip), and those are exactly the users a new-user audience must not contain (observed in testing). Negative N shifts the bound into the future: the rolling \"within the NEXT 7 days\" window is `less_than` value \"0\" AND `more_than` value \"-7\" (two conditions, both required). The relative ops are DAY-granularity only — no unit field; for hour/minute windows use an `event` condition with a `within` (which has a `unit`).","isRequired":true,"uniqueKey":"editedVersion.startRules.when.items.[INDEX].oneOf.1.op","typeLabel":"enum\u003cstring>"},"value":{"description":"The comparison value (string / number-as-string / date). Omit for any/empty/true/false.","type":"string","uniqueKey":"editedVersion.startRules.when.items.[INDEX].oneOf.1.value","typeLabel":"string"},"value2":{"description":"Upper bound for the `between` operator (`value` is the lower bound).","type":"string","uniqueKey":"editedVersion.startRules.when.items.[INDEX].oneOf.1.value2","typeLabel":"string"},"values":{"description":"Values for the List operators (includes_any / includes_all / …).","type":"array","items":{"type":"string","uniqueKey":"editedVersion.startRules.when.items.[INDEX].oneOf.1.values.items.[INDEX]","typeLabel":"string"},"uniqueKey":"editedVersion.startRules.when.items.[INDEX].oneOf.1.values","typeLabel":"string[]"}},"uniqueKey":"editedVersion.startRules.when.items.[INDEX].oneOf.1","typeLabel":"object"},{"type":"object","required":["type","segment","in"],"properties":{"type":{"type":"string","enum":["segment"],"isRequired":true,"uniqueKey":"editedVersion.startRules.when.items.[INDEX].oneOf.2.type","typeLabel":"enum\u003cstring>"},"segment":{"type":"string","isRequired":true,"uniqueKey":"editedVersion.startRules.when.items.[INDEX].oneOf.2.segment","typeLabel":"string"},"in":{"type":"boolean","isRequired":true,"uniqueKey":"editedVersion.startRules.when.items.[INDEX].oneOf.2.in","typeLabel":"boolean"}},"uniqueKey":"editedVersion.startRules.when.items.[INDEX].oneOf.2","typeLabel":"object"},{"type":"object","required":["type","includes"],"properties":{"type":{"type":"string","enum":["current_url"],"isRequired":true,"uniqueKey":"editedVersion.startRules.when.items.[INDEX].oneOf.3.type","typeLabel":"enum\u003cstring>"},"includes":{"type":"array","items":{"type":"string","uniqueKey":"editedVersion.startRules.when.items.[INDEX].oneOf.3.includes.items.[INDEX]","typeLabel":"string"},"description":"URL patterns (anchored whole-url match, NOT substring/regex). `*` = wildcard within one url part; `:name` = one path segment. A bare `*` (i.e. `[\"*\"]`) matches EVERY page on every host incl. deep paths — the canonical always-on / whole-site pattern (use it when content should be available everywhere). Scope it down instead with: `*/` (homepage only — path exactly `/`), `*/pricing` (one page), `*/app/*` (a section + below), `host.com/*` (any page on a specific host). Multiple patterns are OR-matched: the URL matches this list if it matches ANY one pattern (so \"/tasks OR /dashboard\" is one condition with both patterns here — no group needed).","isRequired":true,"uniqueKey":"editedVersion.startRules.when.items.[INDEX].oneOf.3.includes","typeLabel":"string[]"},"excludes":{"description":"URL patterns to exclude (same syntax as includes); excludes win over includes.","type":"array","items":{"type":"string","uniqueKey":"editedVersion.startRules.when.items.[INDEX].oneOf.3.excludes.items.[INDEX]","typeLabel":"string"},"uniqueKey":"editedVersion.startRules.when.items.[INDEX].oneOf.3.excludes","typeLabel":"string[]"}},"uniqueKey":"editedVersion.startRules.when.items.[INDEX].oneOf.3","typeLabel":"object"},{"type":"object","required":["type","state"],"properties":{"type":{"type":"string","enum":["element"],"isRequired":true,"uniqueKey":"editedVersion.startRules.when.items.[INDEX].oneOf.4.type","typeLabel":"enum\u003cstring>"},"state":{"type":"string","enum":["present","hidden","disabled","enabled","clicked","unclicked"],"description":"`present` means NOT CLIPPED AWAY: the element is in the DOM and its box lies inside the viewport / its scroll ancestors — scrolled off-screen or `display:none` never satisfies it (and `hidden` is its negation). It is NOT \"the user can see something there\": an EMPTY, zero-height placeholder node satisfies `present` (observed in testing: a checklist task keyed on an initially-empty `\u003cp>` status line ticked itself the moment the checklist appeared, before the shopper did anything). So do not use element presence as a proxy for \"the app has said something\": most apps keep the container mounted and only fill in its text. Match the TEXT instead (`target.text` + `present`, or the negation trick: the old text `hidden`). Appearances shorter than about a second can be missed entirely. `disabled`/`enabled` read the element disabled state at evaluation time. **`clicked` means \"clicked since page load AND the element is STILL in the DOM right now\"** — both halves, re-checked every evaluation. The click memory latches (the listener attaches the FIRST time the condition is evaluated, so earlier clicks are invisible, and the memory survives a re-render), but the element lookup is redone each poll. Two consequences, one of them silent: (1) **an element that UNMOUNTS on click can NEVER satisfy it** — the click lands, the element vanishes, the lookup fails from then on and the condition stays false forever with no error (observed in testing: a tracker on a button that clears its own toolbar counted ZERO real clicks); (2) an element that unmounts and REMOUNTS satisfies it again, so a tracker gated on it fires once per remount — not once per page load. Unlike `present`, this lookup does NOT require viewport visibility: scrolling the target off-screen keeps `clicked` true. `unclicked` negates the same pair, so it is also false while the element is absent. To count a COMPLETED action, condition on what the app shows afterwards (a success toast, a state change) rather than `clicked` on the button that starts it.","isRequired":true,"uniqueKey":"editedVersion.startRules.when.items.[INDEX].oneOf.4.state","typeLabel":"enum\u003cstring>"},"target":{"type":"object","properties":{"selector":{"type":"string","minLength":1,"description":"A stable CSS selector for the element, on the page or inside a same-origin iframe (written relative to the frame's own document). The runtime targets the FIRST match — so either make the selector unique, or pair a stable non-unique selector with `nth` to pick the intended match. A non-unique selector with no `nth` targets the first (often wrong) element and the tooltip silently won't render.","isRequired":true,"uniqueKey":"editedVersion.startRules.when.items.[INDEX].oneOf.4.target.selector","typeLabel":"string"},"text":{"description":"Optional refinement of `selector`. Requires the targeted element's visible text to equal this (exact match, after trim) — use it to pin a specific content/state (e.g. a stable id whose displayed text you want to match: id + text). It refines the element chosen by `selector`/`nth`; on its own it does NOT search among multiple matches, so disambiguate a non-unique selector with `nth`, not `text` alone.","type":"string","uniqueKey":"editedVersion.startRules.when.items.[INDEX].oneOf.4.target.text","typeLabel":"string"},"nth":{"description":"Optional refinement of `selector`. 0-based index to pick which match when the selector isn't unique — e.g. a stable selector matching 3 elements + `nth: 1` targets the 2nd, giving a unique result. Matches are taken in document order (as they appear in the page HTML). Range 0–4 — only the first 5 matches are addressable; a larger value is rejected.","type":"integer","minimum":0,"maximum":4,"uniqueKey":"editedVersion.startRules.when.items.[INDEX].oneOf.4.target.nth","typeLabel":"integer"}},"required":["selector"],"uniqueKey":"editedVersion.startRules.when.items.[INDEX].oneOf.4.target","typeLabel":"object"}},"uniqueKey":"editedVersion.startRules.when.items.[INDEX].oneOf.4","typeLabel":"object"},{"type":"object","required":["type","content","state"],"properties":{"type":{"type":"string","enum":["content_state"],"isRequired":true,"uniqueKey":"editedVersion.startRules.when.items.[INDEX].oneOf.5.type","typeLabel":"enum\u003cstring>"},"content":{"type":"string","description":"contentId of the FLOW or CHECKLIST whose per-user state to check (an id from the content list). Only flows and checklists record this state — referencing a banner / launcher / resource-center / tracker is rejected at write.","isRequired":true,"uniqueKey":"editedVersion.startRules.when.items.[INDEX].oneOf.5.content","typeLabel":"string"},"state":{"type":"string","enum":["seen","unseen","completed","uncompleted","active","inactive"],"description":"The referenced flow/checklist's state for THIS user. seen = started at least once (for a flow, TRUE from the moment it opens; for a checklist, TRUE only once the user EXPANDS the panel — a `initialDisplay: \"button\"` checklist whose launcher is never clicked stays unseen forever); unseen = never started; active = currently open/running; inactive = NOT currently running (covers both never-started and ran-then-closed); completed = reached a goal/completion step; uncompleted = not completed. To gate piece B until flow A has run AND closed (the usual \"show next thing after the welcome flow\" sequencing), use `seen` AND `inactive` together — `seen` alone fires while A is still open (B piles on top), and `completed` alone strands users who skip/dismiss A.","isRequired":true,"uniqueKey":"editedVersion.startRules.when.items.[INDEX].oneOf.5.state","typeLabel":"enum\u003cstring>"}},"uniqueKey":"editedVersion.startRules.when.items.[INDEX].oneOf.5","typeLabel":"object"},{"type":"object","required":["type","event"],"properties":{"type":{"type":"string","enum":["event"],"isRequired":true,"uniqueKey":"editedVersion.startRules.when.items.[INDEX].oneOf.6.type","typeLabel":"enum\u003cstring>"},"event":{"type":"string","isRequired":true,"uniqueKey":"editedVersion.startRules.when.items.[INDEX].oneOf.6.event","typeLabel":"string"},"count":{"description":"How many times the event must have occurred. Omit it for the common case \"the event has happened\" (treated as at_least 1). Set `op`/`n` for a threshold (`between` needs `n` and `n2`). `at_least`/`between` require n ≥ 1; use `at_most`/`exactly` with 0 for \"never happened\".","type":"object","properties":{"op":{"type":"string","enum":["at_least","at_most","exactly","between"],"isRequired":true,"uniqueKey":"editedVersion.startRules.when.items.[INDEX].oneOf.6.count.op","typeLabel":"enum\u003cstring>"},"n":{"type":"integer","minimum":0,"maximum":9007199254740991,"isRequired":true,"uniqueKey":"editedVersion.startRules.when.items.[INDEX].oneOf.6.count.n","typeLabel":"integer"},"n2":{"type":"integer","minimum":0,"maximum":9007199254740991,"uniqueKey":"editedVersion.startRules.when.items.[INDEX].oneOf.6.count.n2","typeLabel":"integer"}},"required":["op","n"],"uniqueKey":"editedVersion.startRules.when.items.[INDEX].oneOf.6.count","typeLabel":"object"},"within":{"description":"Optional time window for the event count. Omit it (or use `any_time`) to count over all time — \"the event has ever happened\". Any other `op` (`in_the_last` / `more_than` / `between`) requires BOTH `value` and `unit`, and `between` also `value2` — rejected at write otherwise.","type":"object","properties":{"op":{"type":"string","enum":["in_the_last","more_than","between","any_time"],"isRequired":true,"uniqueKey":"editedVersion.startRules.when.items.[INDEX].oneOf.6.within.op","typeLabel":"enum\u003cstring>"},"value":{"type":"number","uniqueKey":"editedVersion.startRules.when.items.[INDEX].oneOf.6.within.value","typeLabel":"number"},"value2":{"type":"number","uniqueKey":"editedVersion.startRules.when.items.[INDEX].oneOf.6.within.value2","typeLabel":"number"},"unit":{"type":"string","enum":["seconds","minutes","hours","days"],"uniqueKey":"editedVersion.startRules.when.items.[INDEX].oneOf.6.within.unit","typeLabel":"enum\u003cstring>"}},"required":["op"],"uniqueKey":"editedVersion.startRules.when.items.[INDEX].oneOf.6.within","typeLabel":"object"},"scope":{"description":"Whose event activity to count (default `current_user`). `current_user` = only this user's own events. `current_user_in_company` = this user's events, but counted within their currently-associated company context (needs the user associated to a company via `group()` / the company-membership API). `any_user_in_company` = events by ANY user in this user's company — account-level activity (e.g. \"anyone on the account has done X\"). The two company scopes require the user to be in a company or they never match.","type":"string","enum":["current_user","current_user_in_company","any_user_in_company"],"uniqueKey":"editedVersion.startRules.when.items.[INDEX].oneOf.6.scope","typeLabel":"enum\u003cstring>"},"where":{"type":"array","items":{"oneOf":[{"type":"object","required":["type","attribute","op"],"properties":{"type":{"type":"string","enum":["event_attribute"],"isRequired":true,"uniqueKey":"editedVersion.startRules.when.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.0.type","typeLabel":"enum\u003cstring>"},"attribute":{"type":"string","isRequired":true,"uniqueKey":"editedVersion.startRules.when.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.0.attribute","typeLabel":"string"},"op":{"type":"string","enum":["is","not","contains","not_contains","starts_with","ends_with","any","empty","lt","lte","gt","gte","between","true","false","includes_any","includes_all","not_includes_any","not_includes_all","less_than","exactly","more_than","before","on","after"],"isRequired":true,"uniqueKey":"editedVersion.startRules.when.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.0.op","typeLabel":"enum\u003cstring>"},"value":{"type":"string","uniqueKey":"editedVersion.startRules.when.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.0.value","typeLabel":"string"},"value2":{"type":"string","uniqueKey":"editedVersion.startRules.when.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.0.value2","typeLabel":"string"},"values":{"type":"array","items":{"type":"string","uniqueKey":"editedVersion.startRules.when.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.0.values.items.[INDEX]","typeLabel":"string"},"uniqueKey":"editedVersion.startRules.when.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.0.values","typeLabel":"string[]"}},"uniqueKey":"editedVersion.startRules.when.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","required":["type","match","conditions"],"properties":{"type":{"type":"string","enum":["group"],"isRequired":true,"uniqueKey":"editedVersion.startRules.when.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.1.type","typeLabel":"enum\u003cstring>"},"match":{"type":"string","enum":["all","any"],"isRequired":true,"uniqueKey":"editedVersion.startRules.when.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.1.match","typeLabel":"enum\u003cstring>"},"conditions":{"minItems":1,"type":"array","items":{"$circularRef":"7599b088-c1e6-49bf-842c-0ee9fa13f591"},"description":"The grouped conditions — at least one. An EMPTY group is not \"no filter\": it never matches, so next to an AND it makes the whole rule unmatchable, and writing one is rejected. A version saved with an empty group in the BUILDER still reads back with it (validate warns); writing that list back is refused until the group is filled or dropped.","isRequired":true,"uniqueKey":"editedVersion.startRules.when.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.1.conditions","typeLabel":"array"}},"uniqueKey":"editedVersion.startRules.when.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.1","typeLabel":"object"}],"uniqueKey":"editedVersion.startRules.when.items.[INDEX].oneOf.6.where.items.[INDEX]","typeLabel":"object"},"uniqueKey":"editedVersion.startRules.when.items.[INDEX].oneOf.6.where","typeLabel":"object[]"}},"uniqueKey":"editedVersion.startRules.when.items.[INDEX].oneOf.6","typeLabel":"object"},{"type":"object","required":["type","op"],"properties":{"type":{"type":"string","enum":["text_input"],"isRequired":true,"uniqueKey":"editedVersion.startRules.when.items.[INDEX].oneOf.7.type","typeLabel":"enum\u003cstring>"},"op":{"type":"string","enum":["is","not","contains","not_contains","starts_with","ends_with","match","unmatch","any","empty"],"isRequired":true,"uniqueKey":"editedVersion.startRules.when.items.[INDEX].oneOf.7.op","typeLabel":"enum\u003cstring>"},"target":{"type":"object","properties":{"selector":{"type":"string","minLength":1,"description":"A stable CSS selector for the element, on the page or inside a same-origin iframe (written relative to the frame's own document). The runtime targets the FIRST match — so either make the selector unique, or pair a stable non-unique selector with `nth` to pick the intended match. A non-unique selector with no `nth` targets the first (often wrong) element and the tooltip silently won't render.","isRequired":true,"uniqueKey":"editedVersion.startRules.when.items.[INDEX].oneOf.7.target.selector","typeLabel":"string"},"text":{"description":"Optional refinement of `selector`. Requires the targeted element's visible text to equal this (exact match, after trim) — use it to pin a specific content/state (e.g. a stable id whose displayed text you want to match: id + text). It refines the element chosen by `selector`/`nth`; on its own it does NOT search among multiple matches, so disambiguate a non-unique selector with `nth`, not `text` alone.","type":"string","uniqueKey":"editedVersion.startRules.when.items.[INDEX].oneOf.7.target.text","typeLabel":"string"},"nth":{"description":"Optional refinement of `selector`. 0-based index to pick which match when the selector isn't unique — e.g. a stable selector matching 3 elements + `nth: 1` targets the 2nd, giving a unique result. Matches are taken in document order (as they appear in the page HTML). Range 0–4 — only the first 5 matches are addressable; a larger value is rejected.","type":"integer","minimum":0,"maximum":4,"uniqueKey":"editedVersion.startRules.when.items.[INDEX].oneOf.7.target.nth","typeLabel":"integer"}},"required":["selector"],"uniqueKey":"editedVersion.startRules.when.items.[INDEX].oneOf.7.target","typeLabel":"object"},"value":{"type":"string","uniqueKey":"editedVersion.startRules.when.items.[INDEX].oneOf.7.value","typeLabel":"string"}},"uniqueKey":"editedVersion.startRules.when.items.[INDEX].oneOf.7","typeLabel":"object"},{"type":"object","required":["type"],"properties":{"type":{"type":"string","enum":["text_filled"],"isRequired":true,"uniqueKey":"editedVersion.startRules.when.items.[INDEX].oneOf.8.type","typeLabel":"enum\u003cstring>"},"target":{"type":"object","properties":{"selector":{"type":"string","minLength":1,"description":"A stable CSS selector for the element, on the page or inside a same-origin iframe (written relative to the frame's own document). The runtime targets the FIRST match — so either make the selector unique, or pair a stable non-unique selector with `nth` to pick the intended match. A non-unique selector with no `nth` targets the first (often wrong) element and the tooltip silently won't render.","isRequired":true,"uniqueKey":"editedVersion.startRules.when.items.[INDEX].oneOf.8.target.selector","typeLabel":"string"},"text":{"description":"Optional refinement of `selector`. Requires the targeted element's visible text to equal this (exact match, after trim) — use it to pin a specific content/state (e.g. a stable id whose displayed text you want to match: id + text). It refines the element chosen by `selector`/`nth`; on its own it does NOT search among multiple matches, so disambiguate a non-unique selector with `nth`, not `text` alone.","type":"string","uniqueKey":"editedVersion.startRules.when.items.[INDEX].oneOf.8.target.text","typeLabel":"string"},"nth":{"description":"Optional refinement of `selector`. 0-based index to pick which match when the selector isn't unique — e.g. a stable selector matching 3 elements + `nth: 1` targets the 2nd, giving a unique result. Matches are taken in document order (as they appear in the page HTML). Range 0–4 — only the first 5 matches are addressable; a larger value is rejected.","type":"integer","minimum":0,"maximum":4,"uniqueKey":"editedVersion.startRules.when.items.[INDEX].oneOf.8.target.nth","typeLabel":"integer"}},"required":["selector"],"uniqueKey":"editedVersion.startRules.when.items.[INDEX].oneOf.8.target","typeLabel":"object"}},"uniqueKey":"editedVersion.startRules.when.items.[INDEX].oneOf.8","typeLabel":"object"},{"type":"object","required":["type","start"],"properties":{"type":{"type":"string","enum":["time_window"],"isRequired":true,"uniqueKey":"editedVersion.startRules.when.items.[INDEX].oneOf.9.type","typeLabel":"enum\u003cstring>"},"start":{"type":"string","description":"Window start (ISO datetime). REQUIRED — the runtime never matches a window without a start, so an end-only window is rejected at write. For \"until X\" semantics, set start to any past instant and end to X.","isRequired":true,"uniqueKey":"editedVersion.startRules.when.items.[INDEX].oneOf.9.start","typeLabel":"string"},"end":{"description":"Window end (ISO datetime). Omit for an open-ended \"from start onwards\" window.","type":"string","uniqueKey":"editedVersion.startRules.when.items.[INDEX].oneOf.9.end","typeLabel":"string"}},"uniqueKey":"editedVersion.startRules.when.items.[INDEX].oneOf.9","typeLabel":"object"},{"type":"object","description":"Read-side placeholder for a stored condition this API cannot express (`note` says what it stands for — usually a DEAD condition the runtime never matches: a deleted attribute/event, an end-only time window). It cannot be written back (the placeholder carries no data to preserve): echoing it is rejected. Either remove it from the list you write — an explicit choice that DELETES the stored condition; mind that a never-matching node inside an AND list pins the whole rule to \"never fires\", so deleting it can bring the remaining conditions to life — or repair the original condition in the Usertour builder first.","required":["type"],"properties":{"type":{"type":"string","enum":["unsupported"],"isRequired":true,"uniqueKey":"editedVersion.startRules.when.items.[INDEX].oneOf.10.type","typeLabel":"enum\u003cstring>"},"note":{"type":"string","uniqueKey":"editedVersion.startRules.when.items.[INDEX].oneOf.10.note","typeLabel":"string"}},"uniqueKey":"editedVersion.startRules.when.items.[INDEX].oneOf.10","typeLabel":"object"}],"uniqueKey":"editedVersion.startRules.when.items.[INDEX]","typeLabel":"object"},"uniqueKey":"editedVersion.startRules.when","typeLabel":"object[]"},"frequency":{"description":"How often the content may auto-start (flow/checklist only). Left unset on a write, the builder default (`once`) is seeded and STORED — read-backs show the effective mode explicitly. A version stored with NO frequency at all (reachable only through legacy/builder-external writes, never through this API) runs with NO limit: it starts again every time its rules match once the prior session ends — validate_content_version warns on that state.","type":"object","properties":{"mode":{"type":"string","enum":["once","multiple","unlimited"],"description":"once = show a single time; multiple = up to N times per window; unlimited = every time the conditions match (subject to `every`).","isRequired":true,"uniqueKey":"editedVersion.startRules.frequency.mode","typeLabel":"enum\u003cstring>"},"every":{"description":"Re-show window. Used by `multiple` (with `times`) and `unlimited`; ignored for `once`. If omitted for those modes a default window is applied. Manual and programmatic starts also count toward the `multiple` limit.","type":"object","properties":{"duration":{"type":"number","isRequired":true,"uniqueKey":"editedVersion.startRules.frequency.every.duration","typeLabel":"number"},"unit":{"type":"string","enum":["seconds","minutes","hours","days"],"isRequired":true,"uniqueKey":"editedVersion.startRules.frequency.every.unit","typeLabel":"enum\u003cstring>"},"times":{"type":"number","uniqueKey":"editedVersion.startRules.frequency.every.times","typeLabel":"number"}},"required":["duration","unit"],"uniqueKey":"editedVersion.startRules.frequency.every","typeLabel":"object"},"atLeast":{"description":"Only auto-start if no OTHER content of the SAME type has been shown within this window — and since only flows accept this knob, in practice: no other FLOW. A banner / checklist / launcher showing does NOT block it. Avoids stacking several flows on a user at once.","type":"object","properties":{"duration":{"type":"number","isRequired":true,"uniqueKey":"editedVersion.startRules.frequency.atLeast.duration","typeLabel":"number"},"unit":{"type":"string","enum":["seconds","minutes","hours","days"],"isRequired":true,"uniqueKey":"editedVersion.startRules.frequency.atLeast.unit","typeLabel":"enum\u003cstring>"}},"required":["duration","unit"],"uniqueKey":"editedVersion.startRules.frequency.atLeast","typeLabel":"object"}},"required":["mode"],"uniqueKey":"editedVersion.startRules.frequency","typeLabel":"object"},"priority":{"description":"Tie-breaker when a user matches the start conditions for more than one piece of content at the same time — the higher priority starts first. Content with no priority set ranks as `medium`.","type":"string","enum":["highest","high","medium","low","lowest"],"uniqueKey":"editedVersion.startRules.priority","typeLabel":"enum\u003cstring>"},"waitSeconds":{"description":"Delay in SECONDS between the start conditions matching and the content becoming ELIGIBLE to start. The countdown itself survives the conditions un-matching mid-wait, but unlike a trigger wait (which fires its actions regardless), an elapsed start-rule wait guarantees nothing: the conditions are RE-CHECKED at show time, and the content starts at the next moment they match again. One exception: when a session of the same content type starts or ends mid-wait, in-flight timers are cancelled and re-armed — a still-matching version then restarts its wait from zero. Capped at 300 seconds by the runtime (a larger value is clamped).","type":"number","uniqueKey":"editedVersion.startRules.waitSeconds","typeLabel":"number"},"startIfNotComplete":{"description":"When true, this content won't auto-start for users who have already completed it.","type":"boolean","uniqueKey":"editedVersion.startRules.startIfNotComplete","typeLabel":"boolean"}},"uniqueKey":"editedVersion.startRules","typeLabel":"object"},"hideRules":{"type":"object","properties":{"when":{"type":"array","items":{"oneOf":[{"type":"object","required":["type","match","conditions"],"properties":{"type":{"type":"string","enum":["group"],"isRequired":true,"uniqueKey":"editedVersion.hideRules.when.items.[INDEX].oneOf.0.type","typeLabel":"enum\u003cstring>"},"match":{"type":"string","enum":["all","any"],"isRequired":true,"uniqueKey":"editedVersion.hideRules.when.items.[INDEX].oneOf.0.match","typeLabel":"enum\u003cstring>"},"conditions":{"minItems":1,"type":"array","items":{"$circularRef":"8bf0052c-740f-4e24-a54d-effeac73767f"},"description":"The grouped conditions — at least one. An EMPTY group is not \"no filter\": it never matches, so next to an AND it makes the whole rule unmatchable, and writing one is rejected. A version saved with an empty group in the BUILDER still reads back with it (validate warns); writing that list back is refused until the group is filled or dropped.","isRequired":true,"uniqueKey":"editedVersion.hideRules.when.items.[INDEX].oneOf.0.conditions","typeLabel":"array"}},"uniqueKey":"editedVersion.hideRules.when.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","required":["type","scope","attribute","op"],"properties":{"type":{"type":"string","enum":["attribute"],"isRequired":true,"uniqueKey":"editedVersion.hideRules.when.items.[INDEX].oneOf.1.type","typeLabel":"enum\u003cstring>"},"scope":{"type":"string","enum":["user","company","companyMembership"],"description":"Which entity owns the attribute — `user` (the end user), `company`, or `companyMembership`. Same value as the attribute definition's `scope` (see the attribute definitions list); required to disambiguate a codeName that exists in more than one scope.","isRequired":true,"uniqueKey":"editedVersion.hideRules.when.items.[INDEX].oneOf.1.scope","typeLabel":"enum\u003cstring>"},"attribute":{"type":"string","isRequired":true,"uniqueKey":"editedVersion.hideRules.when.items.[INDEX].oneOf.1.attribute","typeLabel":"string"},"op":{"type":"string","enum":["is","not","contains","not_contains","starts_with","ends_with","any","empty","lt","lte","gt","gte","between","true","false","includes_any","includes_all","not_includes_any","not_includes_all","less_than","exactly","more_than","before","on","after"],"description":"Operator — the allowed set depends on the attribute dataType. String: is | not | contains | not_contains | starts_with | ends_with | any | empty. Number: is | not | lt | lte | gt | gte | between | any | empty. Boolean: true | false | any | empty. List: includes_any | includes_all | not_includes_any | not_includes_all | any | empty. DateTime: less_than | exactly | more_than (relative — `value` is a number of days) | before | on | after (`value` is an absolute date) | any | empty. The relative ops are ONE-SIDED bounds around (now − N days): `less_than N` = the date is AFTER now−N — so it also matches every FUTURE date, and on a future-dated attribute (a trial end, a renewal date) it is NOT \"within the last N days\"; `more_than N` = the date is BEFORE now−N. **\"Signed up in the last N days\" therefore needs BOTH bounds** — `less_than N` AND `more_than 0` in one `all` group; `less_than N` alone silently includes anyone whose date is in the future (a mis-mapped trial-end column, a clock/timezone slip), and those are exactly the users a new-user audience must not contain (observed in testing). Negative N shifts the bound into the future: the rolling \"within the NEXT 7 days\" window is `less_than` value \"0\" AND `more_than` value \"-7\" (two conditions, both required). The relative ops are DAY-granularity only — no unit field; for hour/minute windows use an `event` condition with a `within` (which has a `unit`).","isRequired":true,"uniqueKey":"editedVersion.hideRules.when.items.[INDEX].oneOf.1.op","typeLabel":"enum\u003cstring>"},"value":{"description":"The comparison value (string / number-as-string / date). Omit for any/empty/true/false.","type":"string","uniqueKey":"editedVersion.hideRules.when.items.[INDEX].oneOf.1.value","typeLabel":"string"},"value2":{"description":"Upper bound for the `between` operator (`value` is the lower bound).","type":"string","uniqueKey":"editedVersion.hideRules.when.items.[INDEX].oneOf.1.value2","typeLabel":"string"},"values":{"description":"Values for the List operators (includes_any / includes_all / …).","type":"array","items":{"type":"string","uniqueKey":"editedVersion.hideRules.when.items.[INDEX].oneOf.1.values.items.[INDEX]","typeLabel":"string"},"uniqueKey":"editedVersion.hideRules.when.items.[INDEX].oneOf.1.values","typeLabel":"string[]"}},"uniqueKey":"editedVersion.hideRules.when.items.[INDEX].oneOf.1","typeLabel":"object"},{"type":"object","required":["type","segment","in"],"properties":{"type":{"type":"string","enum":["segment"],"isRequired":true,"uniqueKey":"editedVersion.hideRules.when.items.[INDEX].oneOf.2.type","typeLabel":"enum\u003cstring>"},"segment":{"type":"string","isRequired":true,"uniqueKey":"editedVersion.hideRules.when.items.[INDEX].oneOf.2.segment","typeLabel":"string"},"in":{"type":"boolean","isRequired":true,"uniqueKey":"editedVersion.hideRules.when.items.[INDEX].oneOf.2.in","typeLabel":"boolean"}},"uniqueKey":"editedVersion.hideRules.when.items.[INDEX].oneOf.2","typeLabel":"object"},{"type":"object","required":["type","includes"],"properties":{"type":{"type":"string","enum":["current_url"],"isRequired":true,"uniqueKey":"editedVersion.hideRules.when.items.[INDEX].oneOf.3.type","typeLabel":"enum\u003cstring>"},"includes":{"type":"array","items":{"type":"string","uniqueKey":"editedVersion.hideRules.when.items.[INDEX].oneOf.3.includes.items.[INDEX]","typeLabel":"string"},"description":"URL patterns (anchored whole-url match, NOT substring/regex). `*` = wildcard within one url part; `:name` = one path segment. A bare `*` (i.e. `[\"*\"]`) matches EVERY page on every host incl. deep paths — the canonical always-on / whole-site pattern (use it when content should be available everywhere). Scope it down instead with: `*/` (homepage only — path exactly `/`), `*/pricing` (one page), `*/app/*` (a section + below), `host.com/*` (any page on a specific host). Multiple patterns are OR-matched: the URL matches this list if it matches ANY one pattern (so \"/tasks OR /dashboard\" is one condition with both patterns here — no group needed).","isRequired":true,"uniqueKey":"editedVersion.hideRules.when.items.[INDEX].oneOf.3.includes","typeLabel":"string[]"},"excludes":{"description":"URL patterns to exclude (same syntax as includes); excludes win over includes.","type":"array","items":{"type":"string","uniqueKey":"editedVersion.hideRules.when.items.[INDEX].oneOf.3.excludes.items.[INDEX]","typeLabel":"string"},"uniqueKey":"editedVersion.hideRules.when.items.[INDEX].oneOf.3.excludes","typeLabel":"string[]"}},"uniqueKey":"editedVersion.hideRules.when.items.[INDEX].oneOf.3","typeLabel":"object"},{"type":"object","required":["type","state"],"properties":{"type":{"type":"string","enum":["element"],"isRequired":true,"uniqueKey":"editedVersion.hideRules.when.items.[INDEX].oneOf.4.type","typeLabel":"enum\u003cstring>"},"state":{"type":"string","enum":["present","hidden","disabled","enabled","clicked","unclicked"],"description":"`present` means NOT CLIPPED AWAY: the element is in the DOM and its box lies inside the viewport / its scroll ancestors — scrolled off-screen or `display:none` never satisfies it (and `hidden` is its negation). It is NOT \"the user can see something there\": an EMPTY, zero-height placeholder node satisfies `present` (observed in testing: a checklist task keyed on an initially-empty `\u003cp>` status line ticked itself the moment the checklist appeared, before the shopper did anything). So do not use element presence as a proxy for \"the app has said something\": most apps keep the container mounted and only fill in its text. Match the TEXT instead (`target.text` + `present`, or the negation trick: the old text `hidden`). Appearances shorter than about a second can be missed entirely. `disabled`/`enabled` read the element disabled state at evaluation time. **`clicked` means \"clicked since page load AND the element is STILL in the DOM right now\"** — both halves, re-checked every evaluation. The click memory latches (the listener attaches the FIRST time the condition is evaluated, so earlier clicks are invisible, and the memory survives a re-render), but the element lookup is redone each poll. Two consequences, one of them silent: (1) **an element that UNMOUNTS on click can NEVER satisfy it** — the click lands, the element vanishes, the lookup fails from then on and the condition stays false forever with no error (observed in testing: a tracker on a button that clears its own toolbar counted ZERO real clicks); (2) an element that unmounts and REMOUNTS satisfies it again, so a tracker gated on it fires once per remount — not once per page load. Unlike `present`, this lookup does NOT require viewport visibility: scrolling the target off-screen keeps `clicked` true. `unclicked` negates the same pair, so it is also false while the element is absent. To count a COMPLETED action, condition on what the app shows afterwards (a success toast, a state change) rather than `clicked` on the button that starts it.","isRequired":true,"uniqueKey":"editedVersion.hideRules.when.items.[INDEX].oneOf.4.state","typeLabel":"enum\u003cstring>"},"target":{"type":"object","properties":{"selector":{"type":"string","minLength":1,"description":"A stable CSS selector for the element, on the page or inside a same-origin iframe (written relative to the frame's own document). The runtime targets the FIRST match — so either make the selector unique, or pair a stable non-unique selector with `nth` to pick the intended match. A non-unique selector with no `nth` targets the first (often wrong) element and the tooltip silently won't render.","isRequired":true,"uniqueKey":"editedVersion.hideRules.when.items.[INDEX].oneOf.4.target.selector","typeLabel":"string"},"text":{"description":"Optional refinement of `selector`. Requires the targeted element's visible text to equal this (exact match, after trim) — use it to pin a specific content/state (e.g. a stable id whose displayed text you want to match: id + text). It refines the element chosen by `selector`/`nth`; on its own it does NOT search among multiple matches, so disambiguate a non-unique selector with `nth`, not `text` alone.","type":"string","uniqueKey":"editedVersion.hideRules.when.items.[INDEX].oneOf.4.target.text","typeLabel":"string"},"nth":{"description":"Optional refinement of `selector`. 0-based index to pick which match when the selector isn't unique — e.g. a stable selector matching 3 elements + `nth: 1` targets the 2nd, giving a unique result. Matches are taken in document order (as they appear in the page HTML). Range 0–4 — only the first 5 matches are addressable; a larger value is rejected.","type":"integer","minimum":0,"maximum":4,"uniqueKey":"editedVersion.hideRules.when.items.[INDEX].oneOf.4.target.nth","typeLabel":"integer"}},"required":["selector"],"uniqueKey":"editedVersion.hideRules.when.items.[INDEX].oneOf.4.target","typeLabel":"object"}},"uniqueKey":"editedVersion.hideRules.when.items.[INDEX].oneOf.4","typeLabel":"object"},{"type":"object","required":["type","content","state"],"properties":{"type":{"type":"string","enum":["content_state"],"isRequired":true,"uniqueKey":"editedVersion.hideRules.when.items.[INDEX].oneOf.5.type","typeLabel":"enum\u003cstring>"},"content":{"type":"string","description":"contentId of the FLOW or CHECKLIST whose per-user state to check (an id from the content list). Only flows and checklists record this state — referencing a banner / launcher / resource-center / tracker is rejected at write.","isRequired":true,"uniqueKey":"editedVersion.hideRules.when.items.[INDEX].oneOf.5.content","typeLabel":"string"},"state":{"type":"string","enum":["seen","unseen","completed","uncompleted","active","inactive"],"description":"The referenced flow/checklist's state for THIS user. seen = started at least once (for a flow, TRUE from the moment it opens; for a checklist, TRUE only once the user EXPANDS the panel — a `initialDisplay: \"button\"` checklist whose launcher is never clicked stays unseen forever); unseen = never started; active = currently open/running; inactive = NOT currently running (covers both never-started and ran-then-closed); completed = reached a goal/completion step; uncompleted = not completed. To gate piece B until flow A has run AND closed (the usual \"show next thing after the welcome flow\" sequencing), use `seen` AND `inactive` together — `seen` alone fires while A is still open (B piles on top), and `completed` alone strands users who skip/dismiss A.","isRequired":true,"uniqueKey":"editedVersion.hideRules.when.items.[INDEX].oneOf.5.state","typeLabel":"enum\u003cstring>"}},"uniqueKey":"editedVersion.hideRules.when.items.[INDEX].oneOf.5","typeLabel":"object"},{"type":"object","required":["type","event"],"properties":{"type":{"type":"string","enum":["event"],"isRequired":true,"uniqueKey":"editedVersion.hideRules.when.items.[INDEX].oneOf.6.type","typeLabel":"enum\u003cstring>"},"event":{"type":"string","isRequired":true,"uniqueKey":"editedVersion.hideRules.when.items.[INDEX].oneOf.6.event","typeLabel":"string"},"count":{"description":"How many times the event must have occurred. Omit it for the common case \"the event has happened\" (treated as at_least 1). Set `op`/`n` for a threshold (`between` needs `n` and `n2`). `at_least`/`between` require n ≥ 1; use `at_most`/`exactly` with 0 for \"never happened\".","type":"object","properties":{"op":{"type":"string","enum":["at_least","at_most","exactly","between"],"isRequired":true,"uniqueKey":"editedVersion.hideRules.when.items.[INDEX].oneOf.6.count.op","typeLabel":"enum\u003cstring>"},"n":{"type":"integer","minimum":0,"maximum":9007199254740991,"isRequired":true,"uniqueKey":"editedVersion.hideRules.when.items.[INDEX].oneOf.6.count.n","typeLabel":"integer"},"n2":{"type":"integer","minimum":0,"maximum":9007199254740991,"uniqueKey":"editedVersion.hideRules.when.items.[INDEX].oneOf.6.count.n2","typeLabel":"integer"}},"required":["op","n"],"uniqueKey":"editedVersion.hideRules.when.items.[INDEX].oneOf.6.count","typeLabel":"object"},"within":{"description":"Optional time window for the event count. Omit it (or use `any_time`) to count over all time — \"the event has ever happened\". Any other `op` (`in_the_last` / `more_than` / `between`) requires BOTH `value` and `unit`, and `between` also `value2` — rejected at write otherwise.","type":"object","properties":{"op":{"type":"string","enum":["in_the_last","more_than","between","any_time"],"isRequired":true,"uniqueKey":"editedVersion.hideRules.when.items.[INDEX].oneOf.6.within.op","typeLabel":"enum\u003cstring>"},"value":{"type":"number","uniqueKey":"editedVersion.hideRules.when.items.[INDEX].oneOf.6.within.value","typeLabel":"number"},"value2":{"type":"number","uniqueKey":"editedVersion.hideRules.when.items.[INDEX].oneOf.6.within.value2","typeLabel":"number"},"unit":{"type":"string","enum":["seconds","minutes","hours","days"],"uniqueKey":"editedVersion.hideRules.when.items.[INDEX].oneOf.6.within.unit","typeLabel":"enum\u003cstring>"}},"required":["op"],"uniqueKey":"editedVersion.hideRules.when.items.[INDEX].oneOf.6.within","typeLabel":"object"},"scope":{"description":"Whose event activity to count (default `current_user`). `current_user` = only this user's own events. `current_user_in_company` = this user's events, but counted within their currently-associated company context (needs the user associated to a company via `group()` / the company-membership API). `any_user_in_company` = events by ANY user in this user's company — account-level activity (e.g. \"anyone on the account has done X\"). The two company scopes require the user to be in a company or they never match.","type":"string","enum":["current_user","current_user_in_company","any_user_in_company"],"uniqueKey":"editedVersion.hideRules.when.items.[INDEX].oneOf.6.scope","typeLabel":"enum\u003cstring>"},"where":{"type":"array","items":{"oneOf":[{"type":"object","required":["type","attribute","op"],"properties":{"type":{"type":"string","enum":["event_attribute"],"isRequired":true,"uniqueKey":"editedVersion.hideRules.when.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.0.type","typeLabel":"enum\u003cstring>"},"attribute":{"type":"string","isRequired":true,"uniqueKey":"editedVersion.hideRules.when.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.0.attribute","typeLabel":"string"},"op":{"type":"string","enum":["is","not","contains","not_contains","starts_with","ends_with","any","empty","lt","lte","gt","gte","between","true","false","includes_any","includes_all","not_includes_any","not_includes_all","less_than","exactly","more_than","before","on","after"],"isRequired":true,"uniqueKey":"editedVersion.hideRules.when.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.0.op","typeLabel":"enum\u003cstring>"},"value":{"type":"string","uniqueKey":"editedVersion.hideRules.when.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.0.value","typeLabel":"string"},"value2":{"type":"string","uniqueKey":"editedVersion.hideRules.when.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.0.value2","typeLabel":"string"},"values":{"type":"array","items":{"type":"string","uniqueKey":"editedVersion.hideRules.when.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.0.values.items.[INDEX]","typeLabel":"string"},"uniqueKey":"editedVersion.hideRules.when.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.0.values","typeLabel":"string[]"}},"uniqueKey":"editedVersion.hideRules.when.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","required":["type","match","conditions"],"properties":{"type":{"type":"string","enum":["group"],"isRequired":true,"uniqueKey":"editedVersion.hideRules.when.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.1.type","typeLabel":"enum\u003cstring>"},"match":{"type":"string","enum":["all","any"],"isRequired":true,"uniqueKey":"editedVersion.hideRules.when.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.1.match","typeLabel":"enum\u003cstring>"},"conditions":{"minItems":1,"type":"array","items":{"$circularRef":"7599b088-c1e6-49bf-842c-0ee9fa13f591"},"description":"The grouped conditions — at least one. An EMPTY group is not \"no filter\": it never matches, so next to an AND it makes the whole rule unmatchable, and writing one is rejected. A version saved with an empty group in the BUILDER still reads back with it (validate warns); writing that list back is refused until the group is filled or dropped.","isRequired":true,"uniqueKey":"editedVersion.hideRules.when.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.1.conditions","typeLabel":"array"}},"uniqueKey":"editedVersion.hideRules.when.items.[INDEX].oneOf.6.where.items.[INDEX].oneOf.1","typeLabel":"object"}],"uniqueKey":"editedVersion.hideRules.when.items.[INDEX].oneOf.6.where.items.[INDEX]","typeLabel":"object"},"uniqueKey":"editedVersion.hideRules.when.items.[INDEX].oneOf.6.where","typeLabel":"object[]"}},"uniqueKey":"editedVersion.hideRules.when.items.[INDEX].oneOf.6","typeLabel":"object"},{"type":"object","required":["type","op"],"properties":{"type":{"type":"string","enum":["text_input"],"isRequired":true,"uniqueKey":"editedVersion.hideRules.when.items.[INDEX].oneOf.7.type","typeLabel":"enum\u003cstring>"},"op":{"type":"string","enum":["is","not","contains","not_contains","starts_with","ends_with","match","unmatch","any","empty"],"isRequired":true,"uniqueKey":"editedVersion.hideRules.when.items.[INDEX].oneOf.7.op","typeLabel":"enum\u003cstring>"},"target":{"type":"object","properties":{"selector":{"type":"string","minLength":1,"description":"A stable CSS selector for the element, on the page or inside a same-origin iframe (written relative to the frame's own document). The runtime targets the FIRST match — so either make the selector unique, or pair a stable non-unique selector with `nth` to pick the intended match. A non-unique selector with no `nth` targets the first (often wrong) element and the tooltip silently won't render.","isRequired":true,"uniqueKey":"editedVersion.hideRules.when.items.[INDEX].oneOf.7.target.selector","typeLabel":"string"},"text":{"description":"Optional refinement of `selector`. Requires the targeted element's visible text to equal this (exact match, after trim) — use it to pin a specific content/state (e.g. a stable id whose displayed text you want to match: id + text). It refines the element chosen by `selector`/`nth`; on its own it does NOT search among multiple matches, so disambiguate a non-unique selector with `nth`, not `text` alone.","type":"string","uniqueKey":"editedVersion.hideRules.when.items.[INDEX].oneOf.7.target.text","typeLabel":"string"},"nth":{"description":"Optional refinement of `selector`. 0-based index to pick which match when the selector isn't unique — e.g. a stable selector matching 3 elements + `nth: 1` targets the 2nd, giving a unique result. Matches are taken in document order (as they appear in the page HTML). Range 0–4 — only the first 5 matches are addressable; a larger value is rejected.","type":"integer","minimum":0,"maximum":4,"uniqueKey":"editedVersion.hideRules.when.items.[INDEX].oneOf.7.target.nth","typeLabel":"integer"}},"required":["selector"],"uniqueKey":"editedVersion.hideRules.when.items.[INDEX].oneOf.7.target","typeLabel":"object"},"value":{"type":"string","uniqueKey":"editedVersion.hideRules.when.items.[INDEX].oneOf.7.value","typeLabel":"string"}},"uniqueKey":"editedVersion.hideRules.when.items.[INDEX].oneOf.7","typeLabel":"object"},{"type":"object","required":["type"],"properties":{"type":{"type":"string","enum":["text_filled"],"isRequired":true,"uniqueKey":"editedVersion.hideRules.when.items.[INDEX].oneOf.8.type","typeLabel":"enum\u003cstring>"},"target":{"type":"object","properties":{"selector":{"type":"string","minLength":1,"description":"A stable CSS selector for the element, on the page or inside a same-origin iframe (written relative to the frame's own document). The runtime targets the FIRST match — so either make the selector unique, or pair a stable non-unique selector with `nth` to pick the intended match. A non-unique selector with no `nth` targets the first (often wrong) element and the tooltip silently won't render.","isRequired":true,"uniqueKey":"editedVersion.hideRules.when.items.[INDEX].oneOf.8.target.selector","typeLabel":"string"},"text":{"description":"Optional refinement of `selector`. Requires the targeted element's visible text to equal this (exact match, after trim) — use it to pin a specific content/state (e.g. a stable id whose displayed text you want to match: id + text). It refines the element chosen by `selector`/`nth`; on its own it does NOT search among multiple matches, so disambiguate a non-unique selector with `nth`, not `text` alone.","type":"string","uniqueKey":"editedVersion.hideRules.when.items.[INDEX].oneOf.8.target.text","typeLabel":"string"},"nth":{"description":"Optional refinement of `selector`. 0-based index to pick which match when the selector isn't unique — e.g. a stable selector matching 3 elements + `nth: 1` targets the 2nd, giving a unique result. Matches are taken in document order (as they appear in the page HTML). Range 0–4 — only the first 5 matches are addressable; a larger value is rejected.","type":"integer","minimum":0,"maximum":4,"uniqueKey":"editedVersion.hideRules.when.items.[INDEX].oneOf.8.target.nth","typeLabel":"integer"}},"required":["selector"],"uniqueKey":"editedVersion.hideRules.when.items.[INDEX].oneOf.8.target","typeLabel":"object"}},"uniqueKey":"editedVersion.hideRules.when.items.[INDEX].oneOf.8","typeLabel":"object"},{"type":"object","required":["type","start"],"properties":{"type":{"type":"string","enum":["time_window"],"isRequired":true,"uniqueKey":"editedVersion.hideRules.when.items.[INDEX].oneOf.9.type","typeLabel":"enum\u003cstring>"},"start":{"type":"string","description":"Window start (ISO datetime). REQUIRED — the runtime never matches a window without a start, so an end-only window is rejected at write. For \"until X\" semantics, set start to any past instant and end to X.","isRequired":true,"uniqueKey":"editedVersion.hideRules.when.items.[INDEX].oneOf.9.start","typeLabel":"string"},"end":{"description":"Window end (ISO datetime). Omit for an open-ended \"from start onwards\" window.","type":"string","uniqueKey":"editedVersion.hideRules.when.items.[INDEX].oneOf.9.end","typeLabel":"string"}},"uniqueKey":"editedVersion.hideRules.when.items.[INDEX].oneOf.9","typeLabel":"object"},{"type":"object","description":"Read-side placeholder for a stored condition this API cannot express (`note` says what it stands for — usually a DEAD condition the runtime never matches: a deleted attribute/event, an end-only time window). It cannot be written back (the placeholder carries no data to preserve): echoing it is rejected. Either remove it from the list you write — an explicit choice that DELETES the stored condition; mind that a never-matching node inside an AND list pins the whole rule to \"never fires\", so deleting it can bring the remaining conditions to life — or repair the original condition in the Usertour builder first.","required":["type"],"properties":{"type":{"type":"string","enum":["unsupported"],"isRequired":true,"uniqueKey":"editedVersion.hideRules.when.items.[INDEX].oneOf.10.type","typeLabel":"enum\u003cstring>"},"note":{"type":"string","uniqueKey":"editedVersion.hideRules.when.items.[INDEX].oneOf.10.note","typeLabel":"string"}},"uniqueKey":"editedVersion.hideRules.when.items.[INDEX].oneOf.10","typeLabel":"object"}],"uniqueKey":"editedVersion.hideRules.when.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"editedVersion.hideRules.when","typeLabel":"object[]"}},"required":["when"],"description":"While `when` matches, on-screen content of this version is hidden — the session is SUSPENDED, not ended: when the conditions stop matching the same session reappears at the same step. Use start-rule conditions to keep content from starting; use hide rules to blank it in specific places (e.g. a settings page).","uniqueKey":"editedVersion.hideRules","typeLabel":"object"},"data":{"description":"Decompiled type-specific body for non-flow content — the same six per-type shapes as the write `data` (fully typed on the content-versions endpoints). Present only with the `data` expand; a flow has no `data` — its body is `steps`.","uniqueKey":"editedVersion.data","typeLabel":"any"},"localizations":{"description":"Per-locale translation status — present only when the `localizations` expand is requested on the content-versions endpoints. One entry per non-default project locale, including locales this version was never translated into.","type":"array","items":{"type":"object","properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"editedVersion.localizations.items.[INDEX].code","typeLabel":"string"},"name":{"type":"string","isRequired":true,"uniqueKey":"editedVersion.localizations.items.[INDEX].name","typeLabel":"string"},"enabled":{"type":"boolean","isRequired":true,"uniqueKey":"editedVersion.localizations.items.[INDEX].enabled","typeLabel":"boolean"},"missing":{"type":"number","isRequired":true,"uniqueKey":"editedVersion.localizations.items.[INDEX].missing","typeLabel":"number"},"outdated":{"type":"number","isRequired":true,"uniqueKey":"editedVersion.localizations.items.[INDEX].outdated","typeLabel":"number"}},"required":["code","name","enabled","missing","outdated"],"uniqueKey":"editedVersion.localizations.items.[INDEX]","typeLabel":"object"},"uniqueKey":"editedVersion.localizations","typeLabel":"object[]"},"scheduledAt":{"description":"Announcement versions only: the \"announcement time\" gating feed visibility and ordering. Absent on other content types and until set (publish stamps it when the author left it null, so published announcements always carry one).","type":"string","uniqueKey":"editedVersion.scheduledAt","typeLabel":"string"},"updatedAt":{"type":"string","format":"date-time","uniqueKey":"editedVersion.updatedAt","typeLabel":"string\u003cdate-time>"},"createdAt":{"type":"string","format":"date-time","uniqueKey":"editedVersion.createdAt","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"editedVersion","typeLabel":"object"}},"required":["id","object","name","type","buildUrl","editedVersionId","environments","deleted","updatedAt","createdAt"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"\u003cstring>","object":"content","name":"\u003cstring>","type":"checklist","buildUrl":"\u003cstring>","editedVersionId":"\u003cstring>","environments":[{"environmentId":"\u003cstring>","published":true,"publishedVersionId":"\u003cstring>","publishedAt":"2023-11-07T05:31:56Z","publishedVersion":{"id":"\u003cstring>","object":"contentVersion","number":123,"firstPublishedAt":"\u003cstring>","themeId":"\u003cstring>","questions":[{"object":"question","cvid":"\u003cstring>","name":"\u003cstring>","type":"nps"}],"updatedAt":"2023-11-07T05:31:56Z","createdAt":"2023-11-07T05:31:56Z","steps":[{"object":"step","id":"\u003cstring>","cvid":"\u003cstring>","name":"\u003cstring>","type":"tooltip","sequence":123,"themeId":"\u003cstring>","content":[{"type":"text","markdown":"\u003cstring>","object":"block","id":"\u003cstring>"}],"target":{"selector":"\u003cstring>","text":"\u003cstring>","nth":2},"placement":{"side":"top","align":"start","sideOffset":123,"alignOffset":123,"alignType":"auto","backdrop":true,"blockTarget":true},"width":123,"skippable":true,"explicitCompletionStep":true,"triggers":[{"do":[{"type":"goto_step","step":"\u003cstring>"}],"when":[{"type":"group","match":"all","conditions":"\u003carray>"}],"waitSeconds":123}],"onClick":[{"type":"goto_step","step":"\u003cstring>"}],"advanced":{"hasUnsupported":true}}],"startRules":{"when":[{"type":"group","match":"all","conditions":"\u003carray>"}],"frequency":{"mode":"once","every":{"duration":123,"unit":"seconds","times":123},"atLeast":{"duration":123,"unit":"seconds"}},"priority":"highest","waitSeconds":123,"startIfNotComplete":true},"hideRules":{"when":[{"type":"group","match":"all","conditions":"\u003carray>"}]},"data":"\u003cunknown>","localizations":[{"code":"\u003cstring>","name":"\u003cstring>","enabled":true,"missing":123,"outdated":123}],"scheduledAt":"\u003cstring>"}}],"deleted":true,"updatedAt":"2023-11-07T05:31:56Z","createdAt":"2023-11-07T05:31:56Z","editedVersion":{"id":"\u003cstring>","object":"contentVersion","number":123,"firstPublishedAt":"\u003cstring>","themeId":"\u003cstring>","questions":[{"object":"question","cvid":"\u003cstring>","name":"\u003cstring>","type":"nps"}],"steps":[{"object":"step","id":"\u003cstring>","cvid":"\u003cstring>","name":"\u003cstring>","type":"tooltip","sequence":123,"themeId":"\u003cstring>","content":[{"type":"text","markdown":"\u003cstring>","object":"block","id":"\u003cstring>"}],"target":{"selector":"\u003cstring>","text":"\u003cstring>","nth":2},"placement":{"side":"top","align":"start","sideOffset":123,"alignOffset":123,"alignType":"auto","backdrop":true,"blockTarget":true},"width":123,"skippable":true,"explicitCompletionStep":true,"triggers":[{"do":[{"type":"goto_step","step":"\u003cstring>"}],"when":[{"type":"group","match":"all","conditions":"\u003carray>"}],"waitSeconds":123}],"onClick":[{"type":"goto_step","step":"\u003cstring>"}],"advanced":{"hasUnsupported":true}}],"startRules":{"when":[{"type":"group","match":"all","conditions":"\u003carray>"}],"frequency":{"mode":"once","every":{"duration":123,"unit":"seconds","times":123},"atLeast":{"duration":123,"unit":"seconds"}},"priority":"highest","waitSeconds":123,"startIfNotComplete":true},"hideRules":{"when":[{"type":"group","match":"all","conditions":"\u003carray>"}]},"data":"\u003cunknown>","localizations":[{"code":"\u003cstring>","name":"\u003cstring>","enabled":true,"missing":123,"outdated":123}],"scheduledAt":"\u003cstring>","updatedAt":"2023-11-07T05:31:56Z","createdAt":"2023-11-07T05:31:56Z"}}}},"exampleType":"generated"}},"exampleType":"generated"},"19b7d541-9260-4b38-ba99-baea9c44af57":{"description":"Invalid request — E1017 validation (may carry `issues`; an invalid orderBy/limit is also E1017), E1015 invalid scope, E0003 invalid against current domain state.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","description":"Stable machine-readable code (e.g. E1017). Match on this, never on `message`.","uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable summary. Wording may change between releases.","uniqueKey":"error.message","typeLabel":"string"},"issues":{"description":"Validation errors (E1017) may carry one entry per problem so every field can be fixed in a single round-trip. Absent on other errors.","type":"array","items":{"type":"object","properties":{"rule":{"type":"string","description":"Which validation layer rejected it: schema | reactive_condition | action_not_allowed | step_shape | reference_target | auto_start | media_url | destination_url. New values may be added; treat an unknown value as a generic validation failure.","isRequired":true,"uniqueKey":"error.issues.items.[INDEX].rule","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.issues.items.[INDEX].message","typeLabel":"string"},"path":{"description":"Path into the request body (e.g. `steps[0].triggers[0].when[1]`).","type":"string","uniqueKey":"error.issues.items.[INDEX].path","typeLabel":"string"}},"required":["rule","message"],"uniqueKey":"error.issues.items.[INDEX]","typeLabel":"object"},"uniqueKey":"error.issues","typeLabel":"object[]"},"doc_url":{"type":"string","description":"Base URL of the API documentation.","uniqueKey":"error.doc_url","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","issues":[{"rule":"\u003cstring>","message":"\u003cstring>","path":"\u003cstring>"}],"doc_url":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"09765a14-def3-4353-9e7b-db4eefa777f5":{"description":"Missing or expired API key — E1010, E1020.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","description":"Stable machine-readable code (e.g. E1017). Match on this, never on `message`.","uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable summary. Wording may change between releases.","uniqueKey":"error.message","typeLabel":"string"},"issues":{"description":"Validation errors (E1017) may carry one entry per problem so every field can be fixed in a single round-trip. Absent on other errors.","type":"array","items":{"type":"object","properties":{"rule":{"type":"string","description":"Which validation layer rejected it: schema | reactive_condition | action_not_allowed | step_shape | reference_target | auto_start | media_url | destination_url. New values may be added; treat an unknown value as a generic validation failure.","isRequired":true,"uniqueKey":"error.issues.items.[INDEX].rule","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.issues.items.[INDEX].message","typeLabel":"string"},"path":{"description":"Path into the request body (e.g. `steps[0].triggers[0].when[1]`).","type":"string","uniqueKey":"error.issues.items.[INDEX].path","typeLabel":"string"}},"required":["rule","message"],"uniqueKey":"error.issues.items.[INDEX]","typeLabel":"object"},"uniqueKey":"error.issues","typeLabel":"object[]"},"doc_url":{"type":"string","description":"Base URL of the API documentation.","uniqueKey":"error.doc_url","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","issues":[{"rule":"\u003cstring>","message":"\u003cstring>","path":"\u003cstring>"}],"doc_url":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"d0e2cbb1-91e1-40df-b5fc-3e7e433319bf":{"description":"Refused — E1000 invalid key, E1011 project not in token scope, E1012 insufficient scope, E1029 environment not in token scope, E1032 environment creation needs a token without env-targeted capabilities (its allowlist cannot cover a not-yet-existing environment), E0043 the project's plan does not include the feature (e.g. webhooks require a paid plan on cloud).","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","description":"Stable machine-readable code (e.g. E1017). Match on this, never on `message`.","uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable summary. Wording may change between releases.","uniqueKey":"error.message","typeLabel":"string"},"issues":{"description":"Validation errors (E1017) may carry one entry per problem so every field can be fixed in a single round-trip. Absent on other errors.","type":"array","items":{"type":"object","properties":{"rule":{"type":"string","description":"Which validation layer rejected it: schema | reactive_condition | action_not_allowed | step_shape | reference_target | auto_start | media_url | destination_url. New values may be added; treat an unknown value as a generic validation failure.","isRequired":true,"uniqueKey":"error.issues.items.[INDEX].rule","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.issues.items.[INDEX].message","typeLabel":"string"},"path":{"description":"Path into the request body (e.g. `steps[0].triggers[0].when[1]`).","type":"string","uniqueKey":"error.issues.items.[INDEX].path","typeLabel":"string"}},"required":["rule","message"],"uniqueKey":"error.issues.items.[INDEX]","typeLabel":"object"},"uniqueKey":"error.issues","typeLabel":"object[]"},"doc_url":{"type":"string","description":"Base URL of the API documentation.","uniqueKey":"error.doc_url","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","issues":[{"rule":"\u003cstring>","message":"\u003cstring>","path":"\u003cstring>"}],"doc_url":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"c16294d6-c91c-47dc-a0ff-59fa06f0c00b":{"description":"Content not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","description":"Stable machine-readable code (e.g. E1017). Match on this, never on `message`.","uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable summary. Wording may change between releases.","uniqueKey":"error.message","typeLabel":"string"},"issues":{"description":"Validation errors (E1017) may carry one entry per problem so every field can be fixed in a single round-trip. Absent on other errors.","type":"array","items":{"type":"object","properties":{"rule":{"type":"string","description":"Which validation layer rejected it: schema | reactive_condition | action_not_allowed | step_shape | reference_target | auto_start | media_url | destination_url. New values may be added; treat an unknown value as a generic validation failure.","isRequired":true,"uniqueKey":"error.issues.items.[INDEX].rule","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.issues.items.[INDEX].message","typeLabel":"string"},"path":{"description":"Path into the request body (e.g. `steps[0].triggers[0].when[1]`).","type":"string","uniqueKey":"error.issues.items.[INDEX].path","typeLabel":"string"}},"required":["rule","message"],"uniqueKey":"error.issues.items.[INDEX]","typeLabel":"object"},"uniqueKey":"error.issues","typeLabel":"object[]"},"doc_url":{"type":"string","description":"Base URL of the API documentation.","uniqueKey":"error.doc_url","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","issues":[{"rule":"\u003cstring>","message":"\u003cstring>","path":"\u003cstring>"}],"doc_url":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"534da967-4485-4ce5-96f1-f85acec11585":{"description":"Rate limit exceeded — E1013. The limit follows the project's plan (100/500/1000/3000 requests per minute); unknown credentials share a per-IP bucket. Every response also carries X-RateLimit-Limit / -Remaining / -Reset for pacing; a 429 adds the standard Retry-After header (seconds to back off).","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","description":"Stable machine-readable code (e.g. E1017). Match on this, never on `message`.","uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable summary. Wording may change between releases.","uniqueKey":"error.message","typeLabel":"string"},"issues":{"description":"Validation errors (E1017) may carry one entry per problem so every field can be fixed in a single round-trip. Absent on other errors.","type":"array","items":{"type":"object","properties":{"rule":{"type":"string","description":"Which validation layer rejected it: schema | reactive_condition | action_not_allowed | step_shape | reference_target | auto_start | media_url | destination_url. New values may be added; treat an unknown value as a generic validation failure.","isRequired":true,"uniqueKey":"error.issues.items.[INDEX].rule","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.issues.items.[INDEX].message","typeLabel":"string"},"path":{"description":"Path into the request body (e.g. `steps[0].triggers[0].when[1]`).","type":"string","uniqueKey":"error.issues.items.[INDEX].path","typeLabel":"string"}},"required":["rule","message"],"uniqueKey":"error.issues.items.[INDEX]","typeLabel":"object"},"uniqueKey":"error.issues","typeLabel":"object[]"},"doc_url":{"type":"string","description":"Base URL of the API documentation.","uniqueKey":"error.doc_url","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","issues":[{"rule":"\u003cstring>","message":"\u003cstring>","path":"\u003cstring>"}],"doc_url":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"09262c4e-2420-46b9-a942-1275dc14da0b":{"bearer":{"scheme":"bearer","bearerFormat":"utp_... personal API token (opaque)","type":"http","scopes":[],"schemeName":"bearer"}}},"servers":{"23c31da0-5340-453a-ad80-9d71f43aa3ab":{"url":"https://api.usertour.io"}},"schemas":{"8bf0052c-740f-4e24-a54d-effeac73767f":{"oneOf":[{"type":"object","required":["type","match","conditions"],"properties":{"type":{"type":"string","enum":["group"],"isRequired":true},"match":{"type":"string","enum":["all","any"],"isRequired":true},"conditions":{"minItems":1,"type":"array","items":{"$circularRef":"8bf0052c-740f-4e24-a54d-effeac73767f"},"description":"The grouped conditions — at least one. An EMPTY group is not \"no filter\": it never matches, so next to an AND it makes the whole rule unmatchable, and writing one is rejected. A version saved with an empty group in the BUILDER still reads back with it (validate warns); writing that list back is refused until the group is filled or dropped.","isRequired":true}}},{"type":"object","required":["type","scope","attribute","op"],"properties":{"type":{"type":"string","enum":["attribute"],"isRequired":true},"scope":{"type":"string","enum":["user","company","companyMembership"],"description":"Which entity owns the attribute — `user` (the end user), `company`, or `companyMembership`. Same value as the attribute definition's `scope` (see the attribute definitions list); required to disambiguate a codeName that exists in more than one scope.","isRequired":true},"attribute":{"type":"string","isRequired":true},"op":{"type":"string","enum":["is","not","contains","not_contains","starts_with","ends_with","any","empty","lt","lte","gt","gte","between","true","false","includes_any","includes_all","not_includes_any","not_includes_all","less_than","exactly","more_than","before","on","after"],"description":"Operator — the allowed set depends on the attribute dataType. String: is | not | contains | not_contains | starts_with | ends_with | any | empty. Number: is | not | lt | lte | gt | gte | between | any | empty. Boolean: true | false | any | empty. List: includes_any | includes_all | not_includes_any | not_includes_all | any | empty. DateTime: less_than | exactly | more_than (relative — `value` is a number of days) | before | on | after (`value` is an absolute date) | any | empty. The relative ops are ONE-SIDED bounds around (now − N days): `less_than N` = the date is AFTER now−N — so it also matches every FUTURE date, and on a future-dated attribute (a trial end, a renewal date) it is NOT \"within the last N days\"; `more_than N` = the date is BEFORE now−N. **\"Signed up in the last N days\" therefore needs BOTH bounds** — `less_than N` AND `more_than 0` in one `all` group; `less_than N` alone silently includes anyone whose date is in the future (a mis-mapped trial-end column, a clock/timezone slip), and those are exactly the users a new-user audience must not contain (observed in testing). Negative N shifts the bound into the future: the rolling \"within the NEXT 7 days\" window is `less_than` value \"0\" AND `more_than` value \"-7\" (two conditions, both required). The relative ops are DAY-granularity only — no unit field; for hour/minute windows use an `event` condition with a `within` (which has a `unit`).","isRequired":true},"value":{"description":"The comparison value (string / number-as-string / date). Omit for any/empty/true/false.","type":"string"},"value2":{"description":"Upper bound for the `between` operator (`value` is the lower bound).","type":"string"},"values":{"description":"Values for the List operators (includes_any / includes_all / …).","type":"array","items":{"type":"string"}}}},{"type":"object","required":["type","segment","in"],"properties":{"type":{"type":"string","enum":["segment"],"isRequired":true},"segment":{"type":"string","isRequired":true},"in":{"type":"boolean","isRequired":true}}},{"type":"object","required":["type","includes"],"properties":{"type":{"type":"string","enum":["current_url"],"isRequired":true},"includes":{"type":"array","items":{"type":"string"},"description":"URL patterns (anchored whole-url match, NOT substring/regex). `*` = wildcard within one url part; `:name` = one path segment. A bare `*` (i.e. `[\"*\"]`) matches EVERY page on every host incl. deep paths — the canonical always-on / whole-site pattern (use it when content should be available everywhere). Scope it down instead with: `*/` (homepage only — path exactly `/`), `*/pricing` (one page), `*/app/*` (a section + below), `host.com/*` (any page on a specific host). Multiple patterns are OR-matched: the URL matches this list if it matches ANY one pattern (so \"/tasks OR /dashboard\" is one condition with both patterns here — no group needed).","isRequired":true},"excludes":{"description":"URL patterns to exclude (same syntax as includes); excludes win over includes.","type":"array","items":{"type":"string"}}}},{"type":"object","required":["type","state"],"properties":{"type":{"type":"string","enum":["element"],"isRequired":true},"state":{"type":"string","enum":["present","hidden","disabled","enabled","clicked","unclicked"],"description":"`present` means NOT CLIPPED AWAY: the element is in the DOM and its box lies inside the viewport / its scroll ancestors — scrolled off-screen or `display:none` never satisfies it (and `hidden` is its negation). It is NOT \"the user can see something there\": an EMPTY, zero-height placeholder node satisfies `present` (observed in testing: a checklist task keyed on an initially-empty `\u003cp>` status line ticked itself the moment the checklist appeared, before the shopper did anything). So do not use element presence as a proxy for \"the app has said something\": most apps keep the container mounted and only fill in its text. Match the TEXT instead (`target.text` + `present`, or the negation trick: the old text `hidden`). Appearances shorter than about a second can be missed entirely. `disabled`/`enabled` read the element disabled state at evaluation time. **`clicked` means \"clicked since page load AND the element is STILL in the DOM right now\"** — both halves, re-checked every evaluation. The click memory latches (the listener attaches the FIRST time the condition is evaluated, so earlier clicks are invisible, and the memory survives a re-render), but the element lookup is redone each poll. Two consequences, one of them silent: (1) **an element that UNMOUNTS on click can NEVER satisfy it** — the click lands, the element vanishes, the lookup fails from then on and the condition stays false forever with no error (observed in testing: a tracker on a button that clears its own toolbar counted ZERO real clicks); (2) an element that unmounts and REMOUNTS satisfies it again, so a tracker gated on it fires once per remount — not once per page load. Unlike `present`, this lookup does NOT require viewport visibility: scrolling the target off-screen keeps `clicked` true. `unclicked` negates the same pair, so it is also false while the element is absent. To count a COMPLETED action, condition on what the app shows afterwards (a success toast, a state change) rather than `clicked` on the button that starts it.","isRequired":true},"target":{"type":"object","properties":{"selector":{"type":"string","minLength":1,"description":"A stable CSS selector for the element, on the page or inside a same-origin iframe (written relative to the frame's own document). The runtime targets the FIRST match — so either make the selector unique, or pair a stable non-unique selector with `nth` to pick the intended match. A non-unique selector with no `nth` targets the first (often wrong) element and the tooltip silently won't render.","isRequired":true},"text":{"description":"Optional refinement of `selector`. Requires the targeted element's visible text to equal this (exact match, after trim) — use it to pin a specific content/state (e.g. a stable id whose displayed text you want to match: id + text). It refines the element chosen by `selector`/`nth`; on its own it does NOT search among multiple matches, so disambiguate a non-unique selector with `nth`, not `text` alone.","type":"string"},"nth":{"description":"Optional refinement of `selector`. 0-based index to pick which match when the selector isn't unique — e.g. a stable selector matching 3 elements + `nth: 1` targets the 2nd, giving a unique result. Matches are taken in document order (as they appear in the page HTML). Range 0–4 — only the first 5 matches are addressable; a larger value is rejected.","type":"integer","minimum":0,"maximum":4}},"required":["selector"]}}},{"type":"object","required":["type","content","state"],"properties":{"type":{"type":"string","enum":["content_state"],"isRequired":true},"content":{"type":"string","description":"contentId of the FLOW or CHECKLIST whose per-user state to check (an id from the content list). Only flows and checklists record this state — referencing a banner / launcher / resource-center / tracker is rejected at write.","isRequired":true},"state":{"type":"string","enum":["seen","unseen","completed","uncompleted","active","inactive"],"description":"The referenced flow/checklist's state for THIS user. seen = started at least once (for a flow, TRUE from the moment it opens; for a checklist, TRUE only once the user EXPANDS the panel — a `initialDisplay: \"button\"` checklist whose launcher is never clicked stays unseen forever); unseen = never started; active = currently open/running; inactive = NOT currently running (covers both never-started and ran-then-closed); completed = reached a goal/completion step; uncompleted = not completed. To gate piece B until flow A has run AND closed (the usual \"show next thing after the welcome flow\" sequencing), use `seen` AND `inactive` together — `seen` alone fires while A is still open (B piles on top), and `completed` alone strands users who skip/dismiss A.","isRequired":true}}},{"type":"object","required":["type","event"],"properties":{"type":{"type":"string","enum":["event"],"isRequired":true},"event":{"type":"string","isRequired":true},"count":{"description":"How many times the event must have occurred. Omit it for the common case \"the event has happened\" (treated as at_least 1). Set `op`/`n` for a threshold (`between` needs `n` and `n2`). `at_least`/`between` require n ≥ 1; use `at_most`/`exactly` with 0 for \"never happened\".","type":"object","properties":{"op":{"type":"string","enum":["at_least","at_most","exactly","between"],"isRequired":true},"n":{"type":"integer","minimum":0,"maximum":9007199254740991,"isRequired":true},"n2":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["op","n"]},"within":{"description":"Optional time window for the event count. Omit it (or use `any_time`) to count over all time — \"the event has ever happened\". Any other `op` (`in_the_last` / `more_than` / `between`) requires BOTH `value` and `unit`, and `between` also `value2` — rejected at write otherwise.","type":"object","properties":{"op":{"type":"string","enum":["in_the_last","more_than","between","any_time"],"isRequired":true},"value":{"type":"number"},"value2":{"type":"number"},"unit":{"type":"string","enum":["seconds","minutes","hours","days"]}},"required":["op"]},"scope":{"description":"Whose event activity to count (default `current_user`). `current_user` = only this user's own events. `current_user_in_company` = this user's events, but counted within their currently-associated company context (needs the user associated to a company via `group()` / the company-membership API). `any_user_in_company` = events by ANY user in this user's company — account-level activity (e.g. \"anyone on the account has done X\"). The two company scopes require the user to be in a company or they never match.","type":"string","enum":["current_user","current_user_in_company","any_user_in_company"]},"where":{"type":"array","items":{"oneOf":[{"type":"object","required":["type","attribute","op"],"properties":{"type":{"type":"string","enum":["event_attribute"],"isRequired":true},"attribute":{"type":"string","isRequired":true},"op":{"type":"string","enum":["is","not","contains","not_contains","starts_with","ends_with","any","empty","lt","lte","gt","gte","between","true","false","includes_any","includes_all","not_includes_any","not_includes_all","less_than","exactly","more_than","before","on","after"],"isRequired":true},"value":{"type":"string"},"value2":{"type":"string"},"values":{"type":"array","items":{"type":"string"}}}},{"type":"object","required":["type","match","conditions"],"properties":{"type":{"type":"string","enum":["group"],"isRequired":true},"match":{"type":"string","enum":["all","any"],"isRequired":true},"conditions":{"minItems":1,"type":"array","items":{"$circularRef":"7599b088-c1e6-49bf-842c-0ee9fa13f591"},"description":"The grouped conditions — at least one. An EMPTY group is not \"no filter\": it never matches, so next to an AND it makes the whole rule unmatchable, and writing one is rejected. A version saved with an empty group in the BUILDER still reads back with it (validate warns); writing that list back is refused until the group is filled or dropped.","isRequired":true}}}]}}}},{"type":"object","required":["type","op"],"properties":{"type":{"type":"string","enum":["text_input"],"isRequired":true},"op":{"type":"string","enum":["is","not","contains","not_contains","starts_with","ends_with","match","unmatch","any","empty"],"isRequired":true},"target":{"type":"object","properties":{"selector":{"type":"string","minLength":1,"description":"A stable CSS selector for the element, on the page or inside a same-origin iframe (written relative to the frame's own document). The runtime targets the FIRST match — so either make the selector unique, or pair a stable non-unique selector with `nth` to pick the intended match. A non-unique selector with no `nth` targets the first (often wrong) element and the tooltip silently won't render.","isRequired":true},"text":{"description":"Optional refinement of `selector`. Requires the targeted element's visible text to equal this (exact match, after trim) — use it to pin a specific content/state (e.g. a stable id whose displayed text you want to match: id + text). It refines the element chosen by `selector`/`nth`; on its own it does NOT search among multiple matches, so disambiguate a non-unique selector with `nth`, not `text` alone.","type":"string"},"nth":{"description":"Optional refinement of `selector`. 0-based index to pick which match when the selector isn't unique — e.g. a stable selector matching 3 elements + `nth: 1` targets the 2nd, giving a unique result. Matches are taken in document order (as they appear in the page HTML). Range 0–4 — only the first 5 matches are addressable; a larger value is rejected.","type":"integer","minimum":0,"maximum":4}},"required":["selector"]},"value":{"type":"string"}}},{"type":"object","required":["type"],"properties":{"type":{"type":"string","enum":["text_filled"],"isRequired":true},"target":{"type":"object","properties":{"selector":{"type":"string","minLength":1,"description":"A stable CSS selector for the element, on the page or inside a same-origin iframe (written relative to the frame's own document). The runtime targets the FIRST match — so either make the selector unique, or pair a stable non-unique selector with `nth` to pick the intended match. A non-unique selector with no `nth` targets the first (often wrong) element and the tooltip silently won't render.","isRequired":true},"text":{"description":"Optional refinement of `selector`. Requires the targeted element's visible text to equal this (exact match, after trim) — use it to pin a specific content/state (e.g. a stable id whose displayed text you want to match: id + text). It refines the element chosen by `selector`/`nth`; on its own it does NOT search among multiple matches, so disambiguate a non-unique selector with `nth`, not `text` alone.","type":"string"},"nth":{"description":"Optional refinement of `selector`. 0-based index to pick which match when the selector isn't unique — e.g. a stable selector matching 3 elements + `nth: 1` targets the 2nd, giving a unique result. Matches are taken in document order (as they appear in the page HTML). Range 0–4 — only the first 5 matches are addressable; a larger value is rejected.","type":"integer","minimum":0,"maximum":4}},"required":["selector"]}}},{"type":"object","required":["type","start"],"properties":{"type":{"type":"string","enum":["time_window"],"isRequired":true},"start":{"type":"string","description":"Window start (ISO datetime). REQUIRED — the runtime never matches a window without a start, so an end-only window is rejected at write. For \"until X\" semantics, set start to any past instant and end to X.","isRequired":true},"end":{"description":"Window end (ISO datetime). Omit for an open-ended \"from start onwards\" window.","type":"string"}}},{"type":"object","description":"Read-side placeholder for a stored condition this API cannot express (`note` says what it stands for — usually a DEAD condition the runtime never matches: a deleted attribute/event, an end-only time window). It cannot be written back (the placeholder carries no data to preserve): echoing it is rejected. Either remove it from the list you write — an explicit choice that DELETES the stored condition; mind that a never-matching node inside an AND list pins the whole rule to \"never fires\", so deleting it can bring the remaining conditions to life — or repair the original condition in the Usertour builder first.","required":["type"],"properties":{"type":{"type":"string","enum":["unsupported"],"isRequired":true},"note":{"type":"string"}}}]},"7599b088-c1e6-49bf-842c-0ee9fa13f591":{"oneOf":[{"type":"object","required":["type","attribute","op"],"properties":{"type":{"type":"string","enum":["event_attribute"],"isRequired":true},"attribute":{"type":"string","isRequired":true},"op":{"type":"string","enum":["is","not","contains","not_contains","starts_with","ends_with","any","empty","lt","lte","gt","gte","between","true","false","includes_any","includes_all","not_includes_any","not_includes_all","less_than","exactly","more_than","before","on","after"],"isRequired":true},"value":{"type":"string"},"value2":{"type":"string"},"values":{"type":"array","items":{"type":"string"}}}},{"type":"object","required":["type","match","conditions"],"properties":{"type":{"type":"string","enum":["group"],"isRequired":true},"match":{"type":"string","enum":["all","any"],"isRequired":true},"conditions":{"minItems":1,"type":"array","items":{"$circularRef":"7599b088-c1e6-49bf-842c-0ee9fa13f591"},"description":"The grouped conditions — at least one. An EMPTY group is not \"no filter\": it never matches, so next to an AND it makes the whole rule unmatchable, and writing one is rejected. A version saved with an empty group in the BUILDER still reads back with it (validate warns); writing that list back is refused until the group is filled or dropped.","isRequired":true}}}]},"cbc2a478-9fbf-4840-91c6-77587e9b8cf5":{"oneOf":[{"type":"object","required":["type","markdown"],"properties":{"type":{"type":"string","enum":["text"],"isRequired":true},"markdown":{"type":"string","description":"A small markdown subset: paragraphs, `# `/`## ` headings (h1/h2 only — no h3+), `-`/`*` and `1.` lists, ``` code fences; inline `**bold**`, `*italic*`, `[text](url)`, and `{{ attribute_code | default: \"x\" }}` for user attributes. Anything outside this subset is SILENTLY normalized, not rejected: h3+ → h2; blockquotes flatten to paragraphs; tables, horizontal rules, strikethrough, inline images/code, and liquid filters other than `default` are dropped. Unsupported syntax won't round-trip — don't rely on it.","isRequired":true},"object":{"default":"block","type":"string","enum":["block"]},"id":{"type":"string"}}},{"type":"object","required":["type","url"],"properties":{"type":{"type":"string","enum":["image"],"isRequired":true},"url":{"type":"string","minLength":1,"isRequired":true},"object":{"default":"block","type":"string","enum":["block"]},"id":{"type":"string"},"alt":{"type":"string"},"link":{"type":"object","properties":{"url":{"type":"string","isRequired":true},"newTab":{"type":"boolean"}},"required":["url"]},"width":{"type":"object","properties":{"unit":{"type":"string","enum":["percent","pixels"],"isRequired":true},"value":{"type":"number","minimum":0}},"required":["unit"]},"margin":{"type":"object","properties":{"enabled":{"type":"boolean"},"top":{"type":"number"},"bottom":{"type":"number"},"left":{"type":"number"},"right":{"type":"number"}}}}},{"type":"object","required":["type","text"],"properties":{"type":{"type":"string","enum":["button"],"isRequired":true},"text":{"type":"string","isRequired":true},"object":{"default":"block","type":"string","enum":["block"]},"id":{"type":"string"},"actions":{"type":"array","items":{"oneOf":[{"type":"object","required":["type","step"],"properties":{"type":{"type":"string","enum":["goto_step"],"isRequired":true},"step":{"type":"string","description":"Target step: a step `key` declared elsewhere in the same write, or an existing step cvid. Resolved server-side to the cvid.","isRequired":true}}},{"type":"object","required":["type","content"],"properties":{"type":{"type":"string","enum":["start_content"],"isRequired":true},"content":{"type":"string","description":"contentId of the flow or checklist to launch (an id from the content list) — a raw content id, NOT a step key (unlike goto_step). Must reference a flow or checklist (a banner / launcher / resource-center / tracker is rejected at write). The target must be PUBLISHED to actually start at runtime; an unknown/dangling id is rejected at validate.","isRequired":true},"step":{"description":"Optional cvid of a step within the launched flow to start at.","type":"string"}}},{"type":"object","required":["type","url"],"properties":{"type":{"type":"string","enum":["navigate"],"isRequired":true},"url":{"type":"string","description":"Absolute URL, or an app-relative path (\"/docs/x\") resolved against the origin the user is on — relative paths are the normal choice for in-app navigation.","isRequired":true},"newTab":{"description":"Open the URL in a new browser tab instead of navigating the current one.","type":"boolean"}}},{"type":"object","description":"Dismiss the piece the action lives on. NOT accepted everywhere this union appears: a resource center has no dismiss (closing the panel is a UI affordance, not an action) and an announcement is marked seen, never dismissed — writes there are rejected (E1017), not ignored. Flows / checklists / launchers / banners all accept it.","required":["type"],"properties":{"type":{"type":"string","enum":["dismiss"],"isRequired":true}}},{"type":"object","description":"Read-back of an existing script action — scripts are not authorable through this API. Echo it back UNCHANGED (same script) when rewriting the surrounding list and the stored action is preserved; omitting it deletes it (action lists are full replacements). Authoring a new or edited script is rejected.","required":["type","script"],"properties":{"type":{"type":"string","enum":["run_javascript"],"isRequired":true},"script":{"type":"string","isRequired":true}}},{"type":"object","description":"Echo-only placeholder for a stored action this schema cannot express (`note` = internal type). Echo it back to preserve the stored action; writing one fresh is rejected.","required":["type"],"properties":{"type":{"type":"string","enum":["unsupported"],"isRequired":true},"note":{"type":"string"}}}]}},"disabledWhen":{"description":"REACTIVE slot — polled live in the browser (the button disables the moment the conditions match). Client-evaluable condition types only: attribute / current_url / element / text_input / text_filled / time_window; event / segment / content_state are rejected (E1017).","type":"array","items":{"oneOf":[{"type":"object","required":["type","match","conditions"],"properties":{"type":{"type":"string","enum":["group"],"isRequired":true},"match":{"type":"string","enum":["all","any"],"isRequired":true},"conditions":{"minItems":1,"type":"array","items":{"$circularRef":"8bf0052c-740f-4e24-a54d-effeac73767f"},"description":"The grouped conditions — at least one. An EMPTY group is not \"no filter\": it never matches, so next to an AND it makes the whole rule unmatchable, and writing one is rejected. A version saved with an empty group in the BUILDER still reads back with it (validate warns); writing that list back is refused until the group is filled or dropped.","isRequired":true}}},{"type":"object","required":["type","scope","attribute","op"],"properties":{"type":{"type":"string","enum":["attribute"],"isRequired":true},"scope":{"type":"string","enum":["user","company","companyMembership"],"description":"Which entity owns the attribute — `user` (the end user), `company`, or `companyMembership`. Same value as the attribute definition's `scope` (see the attribute definitions list); required to disambiguate a codeName that exists in more than one scope.","isRequired":true},"attribute":{"type":"string","isRequired":true},"op":{"type":"string","enum":["is","not","contains","not_contains","starts_with","ends_with","any","empty","lt","lte","gt","gte","between","true","false","includes_any","includes_all","not_includes_any","not_includes_all","less_than","exactly","more_than","before","on","after"],"description":"Operator — the allowed set depends on the attribute dataType. String: is | not | contains | not_contains | starts_with | ends_with | any | empty. Number: is | not | lt | lte | gt | gte | between | any | empty. Boolean: true | false | any | empty. List: includes_any | includes_all | not_includes_any | not_includes_all | any | empty. DateTime: less_than | exactly | more_than (relative — `value` is a number of days) | before | on | after (`value` is an absolute date) | any | empty. The relative ops are ONE-SIDED bounds around (now − N days): `less_than N` = the date is AFTER now−N — so it also matches every FUTURE date, and on a future-dated attribute (a trial end, a renewal date) it is NOT \"within the last N days\"; `more_than N` = the date is BEFORE now−N. **\"Signed up in the last N days\" therefore needs BOTH bounds** — `less_than N` AND `more_than 0` in one `all` group; `less_than N` alone silently includes anyone whose date is in the future (a mis-mapped trial-end column, a clock/timezone slip), and those are exactly the users a new-user audience must not contain (observed in testing). Negative N shifts the bound into the future: the rolling \"within the NEXT 7 days\" window is `less_than` value \"0\" AND `more_than` value \"-7\" (two conditions, both required). The relative ops are DAY-granularity only — no unit field; for hour/minute windows use an `event` condition with a `within` (which has a `unit`).","isRequired":true},"value":{"description":"The comparison value (string / number-as-string / date). Omit for any/empty/true/false.","type":"string"},"value2":{"description":"Upper bound for the `between` operator (`value` is the lower bound).","type":"string"},"values":{"description":"Values for the List operators (includes_any / includes_all / …).","type":"array","items":{"type":"string"}}}},{"type":"object","required":["type","segment","in"],"properties":{"type":{"type":"string","enum":["segment"],"isRequired":true},"segment":{"type":"string","isRequired":true},"in":{"type":"boolean","isRequired":true}}},{"type":"object","required":["type","includes"],"properties":{"type":{"type":"string","enum":["current_url"],"isRequired":true},"includes":{"type":"array","items":{"type":"string"},"description":"URL patterns (anchored whole-url match, NOT substring/regex). `*` = wildcard within one url part; `:name` = one path segment. A bare `*` (i.e. `[\"*\"]`) matches EVERY page on every host incl. deep paths — the canonical always-on / whole-site pattern (use it when content should be available everywhere). Scope it down instead with: `*/` (homepage only — path exactly `/`), `*/pricing` (one page), `*/app/*` (a section + below), `host.com/*` (any page on a specific host). Multiple patterns are OR-matched: the URL matches this list if it matches ANY one pattern (so \"/tasks OR /dashboard\" is one condition with both patterns here — no group needed).","isRequired":true},"excludes":{"description":"URL patterns to exclude (same syntax as includes); excludes win over includes.","type":"array","items":{"type":"string"}}}},{"type":"object","required":["type","state"],"properties":{"type":{"type":"string","enum":["element"],"isRequired":true},"state":{"type":"string","enum":["present","hidden","disabled","enabled","clicked","unclicked"],"description":"`present` means NOT CLIPPED AWAY: the element is in the DOM and its box lies inside the viewport / its scroll ancestors — scrolled off-screen or `display:none` never satisfies it (and `hidden` is its negation). It is NOT \"the user can see something there\": an EMPTY, zero-height placeholder node satisfies `present` (observed in testing: a checklist task keyed on an initially-empty `\u003cp>` status line ticked itself the moment the checklist appeared, before the shopper did anything). So do not use element presence as a proxy for \"the app has said something\": most apps keep the container mounted and only fill in its text. Match the TEXT instead (`target.text` + `present`, or the negation trick: the old text `hidden`). Appearances shorter than about a second can be missed entirely. `disabled`/`enabled` read the element disabled state at evaluation time. **`clicked` means \"clicked since page load AND the element is STILL in the DOM right now\"** — both halves, re-checked every evaluation. The click memory latches (the listener attaches the FIRST time the condition is evaluated, so earlier clicks are invisible, and the memory survives a re-render), but the element lookup is redone each poll. Two consequences, one of them silent: (1) **an element that UNMOUNTS on click can NEVER satisfy it** — the click lands, the element vanishes, the lookup fails from then on and the condition stays false forever with no error (observed in testing: a tracker on a button that clears its own toolbar counted ZERO real clicks); (2) an element that unmounts and REMOUNTS satisfies it again, so a tracker gated on it fires once per remount — not once per page load. Unlike `present`, this lookup does NOT require viewport visibility: scrolling the target off-screen keeps `clicked` true. `unclicked` negates the same pair, so it is also false while the element is absent. To count a COMPLETED action, condition on what the app shows afterwards (a success toast, a state change) rather than `clicked` on the button that starts it.","isRequired":true},"target":{"type":"object","properties":{"selector":{"type":"string","minLength":1,"description":"A stable CSS selector for the element, on the page or inside a same-origin iframe (written relative to the frame's own document). The runtime targets the FIRST match — so either make the selector unique, or pair a stable non-unique selector with `nth` to pick the intended match. A non-unique selector with no `nth` targets the first (often wrong) element and the tooltip silently won't render.","isRequired":true},"text":{"description":"Optional refinement of `selector`. Requires the targeted element's visible text to equal this (exact match, after trim) — use it to pin a specific content/state (e.g. a stable id whose displayed text you want to match: id + text). It refines the element chosen by `selector`/`nth`; on its own it does NOT search among multiple matches, so disambiguate a non-unique selector with `nth`, not `text` alone.","type":"string"},"nth":{"description":"Optional refinement of `selector`. 0-based index to pick which match when the selector isn't unique — e.g. a stable selector matching 3 elements + `nth: 1` targets the 2nd, giving a unique result. Matches are taken in document order (as they appear in the page HTML). Range 0–4 — only the first 5 matches are addressable; a larger value is rejected.","type":"integer","minimum":0,"maximum":4}},"required":["selector"]}}},{"type":"object","required":["type","content","state"],"properties":{"type":{"type":"string","enum":["content_state"],"isRequired":true},"content":{"type":"string","description":"contentId of the FLOW or CHECKLIST whose per-user state to check (an id from the content list). Only flows and checklists record this state — referencing a banner / launcher / resource-center / tracker is rejected at write.","isRequired":true},"state":{"type":"string","enum":["seen","unseen","completed","uncompleted","active","inactive"],"description":"The referenced flow/checklist's state for THIS user. seen = started at least once (for a flow, TRUE from the moment it opens; for a checklist, TRUE only once the user EXPANDS the panel — a `initialDisplay: \"button\"` checklist whose launcher is never clicked stays unseen forever); unseen = never started; active = currently open/running; inactive = NOT currently running (covers both never-started and ran-then-closed); completed = reached a goal/completion step; uncompleted = not completed. To gate piece B until flow A has run AND closed (the usual \"show next thing after the welcome flow\" sequencing), use `seen` AND `inactive` together — `seen` alone fires while A is still open (B piles on top), and `completed` alone strands users who skip/dismiss A.","isRequired":true}}},{"type":"object","required":["type","event"],"properties":{"type":{"type":"string","enum":["event"],"isRequired":true},"event":{"type":"string","isRequired":true},"count":{"description":"How many times the event must have occurred. Omit it for the common case \"the event has happened\" (treated as at_least 1). Set `op`/`n` for a threshold (`between` needs `n` and `n2`). `at_least`/`between` require n ≥ 1; use `at_most`/`exactly` with 0 for \"never happened\".","type":"object","properties":{"op":{"type":"string","enum":["at_least","at_most","exactly","between"],"isRequired":true},"n":{"type":"integer","minimum":0,"maximum":9007199254740991,"isRequired":true},"n2":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["op","n"]},"within":{"description":"Optional time window for the event count. Omit it (or use `any_time`) to count over all time — \"the event has ever happened\". Any other `op` (`in_the_last` / `more_than` / `between`) requires BOTH `value` and `unit`, and `between` also `value2` — rejected at write otherwise.","type":"object","properties":{"op":{"type":"string","enum":["in_the_last","more_than","between","any_time"],"isRequired":true},"value":{"type":"number"},"value2":{"type":"number"},"unit":{"type":"string","enum":["seconds","minutes","hours","days"]}},"required":["op"]},"scope":{"description":"Whose event activity to count (default `current_user`). `current_user` = only this user's own events. `current_user_in_company` = this user's events, but counted within their currently-associated company context (needs the user associated to a company via `group()` / the company-membership API). `any_user_in_company` = events by ANY user in this user's company — account-level activity (e.g. \"anyone on the account has done X\"). The two company scopes require the user to be in a company or they never match.","type":"string","enum":["current_user","current_user_in_company","any_user_in_company"]},"where":{"type":"array","items":{"oneOf":[{"type":"object","required":["type","attribute","op"],"properties":{"type":{"type":"string","enum":["event_attribute"],"isRequired":true},"attribute":{"type":"string","isRequired":true},"op":{"type":"string","enum":["is","not","contains","not_contains","starts_with","ends_with","any","empty","lt","lte","gt","gte","between","true","false","includes_any","includes_all","not_includes_any","not_includes_all","less_than","exactly","more_than","before","on","after"],"isRequired":true},"value":{"type":"string"},"value2":{"type":"string"},"values":{"type":"array","items":{"type":"string"}}}},{"type":"object","required":["type","match","conditions"],"properties":{"type":{"type":"string","enum":["group"],"isRequired":true},"match":{"type":"string","enum":["all","any"],"isRequired":true},"conditions":{"minItems":1,"type":"array","items":{"$circularRef":"7599b088-c1e6-49bf-842c-0ee9fa13f591"},"description":"The grouped conditions — at least one. An EMPTY group is not \"no filter\": it never matches, so next to an AND it makes the whole rule unmatchable, and writing one is rejected. A version saved with an empty group in the BUILDER still reads back with it (validate warns); writing that list back is refused until the group is filled or dropped.","isRequired":true}}}]}}}},{"type":"object","required":["type","op"],"properties":{"type":{"type":"string","enum":["text_input"],"isRequired":true},"op":{"type":"string","enum":["is","not","contains","not_contains","starts_with","ends_with","match","unmatch","any","empty"],"isRequired":true},"target":{"type":"object","properties":{"selector":{"type":"string","minLength":1,"description":"A stable CSS selector for the element, on the page or inside a same-origin iframe (written relative to the frame's own document). The runtime targets the FIRST match — so either make the selector unique, or pair a stable non-unique selector with `nth` to pick the intended match. A non-unique selector with no `nth` targets the first (often wrong) element and the tooltip silently won't render.","isRequired":true},"text":{"description":"Optional refinement of `selector`. Requires the targeted element's visible text to equal this (exact match, after trim) — use it to pin a specific content/state (e.g. a stable id whose displayed text you want to match: id + text). It refines the element chosen by `selector`/`nth`; on its own it does NOT search among multiple matches, so disambiguate a non-unique selector with `nth`, not `text` alone.","type":"string"},"nth":{"description":"Optional refinement of `selector`. 0-based index to pick which match when the selector isn't unique — e.g. a stable selector matching 3 elements + `nth: 1` targets the 2nd, giving a unique result. Matches are taken in document order (as they appear in the page HTML). Range 0–4 — only the first 5 matches are addressable; a larger value is rejected.","type":"integer","minimum":0,"maximum":4}},"required":["selector"]},"value":{"type":"string"}}},{"type":"object","required":["type"],"properties":{"type":{"type":"string","enum":["text_filled"],"isRequired":true},"target":{"type":"object","properties":{"selector":{"type":"string","minLength":1,"description":"A stable CSS selector for the element, on the page or inside a same-origin iframe (written relative to the frame's own document). The runtime targets the FIRST match — so either make the selector unique, or pair a stable non-unique selector with `nth` to pick the intended match. A non-unique selector with no `nth` targets the first (often wrong) element and the tooltip silently won't render.","isRequired":true},"text":{"description":"Optional refinement of `selector`. Requires the targeted element's visible text to equal this (exact match, after trim) — use it to pin a specific content/state (e.g. a stable id whose displayed text you want to match: id + text). It refines the element chosen by `selector`/`nth`; on its own it does NOT search among multiple matches, so disambiguate a non-unique selector with `nth`, not `text` alone.","type":"string"},"nth":{"description":"Optional refinement of `selector`. 0-based index to pick which match when the selector isn't unique — e.g. a stable selector matching 3 elements + `nth: 1` targets the 2nd, giving a unique result. Matches are taken in document order (as they appear in the page HTML). Range 0–4 — only the first 5 matches are addressable; a larger value is rejected.","type":"integer","minimum":0,"maximum":4}},"required":["selector"]}}},{"type":"object","required":["type","start"],"properties":{"type":{"type":"string","enum":["time_window"],"isRequired":true},"start":{"type":"string","description":"Window start (ISO datetime). REQUIRED — the runtime never matches a window without a start, so an end-only window is rejected at write. For \"until X\" semantics, set start to any past instant and end to X.","isRequired":true},"end":{"description":"Window end (ISO datetime). Omit for an open-ended \"from start onwards\" window.","type":"string"}}},{"type":"object","description":"Read-side placeholder for a stored condition this API cannot express (`note` says what it stands for — usually a DEAD condition the runtime never matches: a deleted attribute/event, an end-only time window). It cannot be written back (the placeholder carries no data to preserve): echoing it is rejected. Either remove it from the list you write — an explicit choice that DELETES the stored condition; mind that a never-matching node inside an AND list pins the whole rule to \"never fires\", so deleting it can bring the remaining conditions to life — or repair the original condition in the Usertour builder first.","required":["type"],"properties":{"type":{"type":"string","enum":["unsupported"],"isRequired":true},"note":{"type":"string"}}}]}},"hiddenWhen":{"description":"REACTIVE slot — polled live in the browser (the button shows/hides as conditions change). Same client-evaluable-only rule as `disabledWhen`.","type":"array","items":{"oneOf":[{"type":"object","required":["type","match","conditions"],"properties":{"type":{"type":"string","enum":["group"],"isRequired":true},"match":{"type":"string","enum":["all","any"],"isRequired":true},"conditions":{"minItems":1,"type":"array","items":{"$circularRef":"8bf0052c-740f-4e24-a54d-effeac73767f"},"description":"The grouped conditions — at least one. An EMPTY group is not \"no filter\": it never matches, so next to an AND it makes the whole rule unmatchable, and writing one is rejected. A version saved with an empty group in the BUILDER still reads back with it (validate warns); writing that list back is refused until the group is filled or dropped.","isRequired":true}}},{"type":"object","required":["type","scope","attribute","op"],"properties":{"type":{"type":"string","enum":["attribute"],"isRequired":true},"scope":{"type":"string","enum":["user","company","companyMembership"],"description":"Which entity owns the attribute — `user` (the end user), `company`, or `companyMembership`. Same value as the attribute definition's `scope` (see the attribute definitions list); required to disambiguate a codeName that exists in more than one scope.","isRequired":true},"attribute":{"type":"string","isRequired":true},"op":{"type":"string","enum":["is","not","contains","not_contains","starts_with","ends_with","any","empty","lt","lte","gt","gte","between","true","false","includes_any","includes_all","not_includes_any","not_includes_all","less_than","exactly","more_than","before","on","after"],"description":"Operator — the allowed set depends on the attribute dataType. String: is | not | contains | not_contains | starts_with | ends_with | any | empty. Number: is | not | lt | lte | gt | gte | between | any | empty. Boolean: true | false | any | empty. List: includes_any | includes_all | not_includes_any | not_includes_all | any | empty. DateTime: less_than | exactly | more_than (relative — `value` is a number of days) | before | on | after (`value` is an absolute date) | any | empty. The relative ops are ONE-SIDED bounds around (now − N days): `less_than N` = the date is AFTER now−N — so it also matches every FUTURE date, and on a future-dated attribute (a trial end, a renewal date) it is NOT \"within the last N days\"; `more_than N` = the date is BEFORE now−N. **\"Signed up in the last N days\" therefore needs BOTH bounds** — `less_than N` AND `more_than 0` in one `all` group; `less_than N` alone silently includes anyone whose date is in the future (a mis-mapped trial-end column, a clock/timezone slip), and those are exactly the users a new-user audience must not contain (observed in testing). Negative N shifts the bound into the future: the rolling \"within the NEXT 7 days\" window is `less_than` value \"0\" AND `more_than` value \"-7\" (two conditions, both required). The relative ops are DAY-granularity only — no unit field; for hour/minute windows use an `event` condition with a `within` (which has a `unit`).","isRequired":true},"value":{"description":"The comparison value (string / number-as-string / date). Omit for any/empty/true/false.","type":"string"},"value2":{"description":"Upper bound for the `between` operator (`value` is the lower bound).","type":"string"},"values":{"description":"Values for the List operators (includes_any / includes_all / …).","type":"array","items":{"type":"string"}}}},{"type":"object","required":["type","segment","in"],"properties":{"type":{"type":"string","enum":["segment"],"isRequired":true},"segment":{"type":"string","isRequired":true},"in":{"type":"boolean","isRequired":true}}},{"type":"object","required":["type","includes"],"properties":{"type":{"type":"string","enum":["current_url"],"isRequired":true},"includes":{"type":"array","items":{"type":"string"},"description":"URL patterns (anchored whole-url match, NOT substring/regex). `*` = wildcard within one url part; `:name` = one path segment. A bare `*` (i.e. `[\"*\"]`) matches EVERY page on every host incl. deep paths — the canonical always-on / whole-site pattern (use it when content should be available everywhere). Scope it down instead with: `*/` (homepage only — path exactly `/`), `*/pricing` (one page), `*/app/*` (a section + below), `host.com/*` (any page on a specific host). Multiple patterns are OR-matched: the URL matches this list if it matches ANY one pattern (so \"/tasks OR /dashboard\" is one condition with both patterns here — no group needed).","isRequired":true},"excludes":{"description":"URL patterns to exclude (same syntax as includes); excludes win over includes.","type":"array","items":{"type":"string"}}}},{"type":"object","required":["type","state"],"properties":{"type":{"type":"string","enum":["element"],"isRequired":true},"state":{"type":"string","enum":["present","hidden","disabled","enabled","clicked","unclicked"],"description":"`present` means NOT CLIPPED AWAY: the element is in the DOM and its box lies inside the viewport / its scroll ancestors — scrolled off-screen or `display:none` never satisfies it (and `hidden` is its negation). It is NOT \"the user can see something there\": an EMPTY, zero-height placeholder node satisfies `present` (observed in testing: a checklist task keyed on an initially-empty `\u003cp>` status line ticked itself the moment the checklist appeared, before the shopper did anything). So do not use element presence as a proxy for \"the app has said something\": most apps keep the container mounted and only fill in its text. Match the TEXT instead (`target.text` + `present`, or the negation trick: the old text `hidden`). Appearances shorter than about a second can be missed entirely. `disabled`/`enabled` read the element disabled state at evaluation time. **`clicked` means \"clicked since page load AND the element is STILL in the DOM right now\"** — both halves, re-checked every evaluation. The click memory latches (the listener attaches the FIRST time the condition is evaluated, so earlier clicks are invisible, and the memory survives a re-render), but the element lookup is redone each poll. Two consequences, one of them silent: (1) **an element that UNMOUNTS on click can NEVER satisfy it** — the click lands, the element vanishes, the lookup fails from then on and the condition stays false forever with no error (observed in testing: a tracker on a button that clears its own toolbar counted ZERO real clicks); (2) an element that unmounts and REMOUNTS satisfies it again, so a tracker gated on it fires once per remount — not once per page load. Unlike `present`, this lookup does NOT require viewport visibility: scrolling the target off-screen keeps `clicked` true. `unclicked` negates the same pair, so it is also false while the element is absent. To count a COMPLETED action, condition on what the app shows afterwards (a success toast, a state change) rather than `clicked` on the button that starts it.","isRequired":true},"target":{"type":"object","properties":{"selector":{"type":"string","minLength":1,"description":"A stable CSS selector for the element, on the page or inside a same-origin iframe (written relative to the frame's own document). The runtime targets the FIRST match — so either make the selector unique, or pair a stable non-unique selector with `nth` to pick the intended match. A non-unique selector with no `nth` targets the first (often wrong) element and the tooltip silently won't render.","isRequired":true},"text":{"description":"Optional refinement of `selector`. Requires the targeted element's visible text to equal this (exact match, after trim) — use it to pin a specific content/state (e.g. a stable id whose displayed text you want to match: id + text). It refines the element chosen by `selector`/`nth`; on its own it does NOT search among multiple matches, so disambiguate a non-unique selector with `nth`, not `text` alone.","type":"string"},"nth":{"description":"Optional refinement of `selector`. 0-based index to pick which match when the selector isn't unique — e.g. a stable selector matching 3 elements + `nth: 1` targets the 2nd, giving a unique result. Matches are taken in document order (as they appear in the page HTML). Range 0–4 — only the first 5 matches are addressable; a larger value is rejected.","type":"integer","minimum":0,"maximum":4}},"required":["selector"]}}},{"type":"object","required":["type","content","state"],"properties":{"type":{"type":"string","enum":["content_state"],"isRequired":true},"content":{"type":"string","description":"contentId of the FLOW or CHECKLIST whose per-user state to check (an id from the content list). Only flows and checklists record this state — referencing a banner / launcher / resource-center / tracker is rejected at write.","isRequired":true},"state":{"type":"string","enum":["seen","unseen","completed","uncompleted","active","inactive"],"description":"The referenced flow/checklist's state for THIS user. seen = started at least once (for a flow, TRUE from the moment it opens; for a checklist, TRUE only once the user EXPANDS the panel — a `initialDisplay: \"button\"` checklist whose launcher is never clicked stays unseen forever); unseen = never started; active = currently open/running; inactive = NOT currently running (covers both never-started and ran-then-closed); completed = reached a goal/completion step; uncompleted = not completed. To gate piece B until flow A has run AND closed (the usual \"show next thing after the welcome flow\" sequencing), use `seen` AND `inactive` together — `seen` alone fires while A is still open (B piles on top), and `completed` alone strands users who skip/dismiss A.","isRequired":true}}},{"type":"object","required":["type","event"],"properties":{"type":{"type":"string","enum":["event"],"isRequired":true},"event":{"type":"string","isRequired":true},"count":{"description":"How many times the event must have occurred. Omit it for the common case \"the event has happened\" (treated as at_least 1). Set `op`/`n` for a threshold (`between` needs `n` and `n2`). `at_least`/`between` require n ≥ 1; use `at_most`/`exactly` with 0 for \"never happened\".","type":"object","properties":{"op":{"type":"string","enum":["at_least","at_most","exactly","between"],"isRequired":true},"n":{"type":"integer","minimum":0,"maximum":9007199254740991,"isRequired":true},"n2":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["op","n"]},"within":{"description":"Optional time window for the event count. Omit it (or use `any_time`) to count over all time — \"the event has ever happened\". Any other `op` (`in_the_last` / `more_than` / `between`) requires BOTH `value` and `unit`, and `between` also `value2` — rejected at write otherwise.","type":"object","properties":{"op":{"type":"string","enum":["in_the_last","more_than","between","any_time"],"isRequired":true},"value":{"type":"number"},"value2":{"type":"number"},"unit":{"type":"string","enum":["seconds","minutes","hours","days"]}},"required":["op"]},"scope":{"description":"Whose event activity to count (default `current_user`). `current_user` = only this user's own events. `current_user_in_company` = this user's events, but counted within their currently-associated company context (needs the user associated to a company via `group()` / the company-membership API). `any_user_in_company` = events by ANY user in this user's company — account-level activity (e.g. \"anyone on the account has done X\"). The two company scopes require the user to be in a company or they never match.","type":"string","enum":["current_user","current_user_in_company","any_user_in_company"]},"where":{"type":"array","items":{"oneOf":[{"type":"object","required":["type","attribute","op"],"properties":{"type":{"type":"string","enum":["event_attribute"],"isRequired":true},"attribute":{"type":"string","isRequired":true},"op":{"type":"string","enum":["is","not","contains","not_contains","starts_with","ends_with","any","empty","lt","lte","gt","gte","between","true","false","includes_any","includes_all","not_includes_any","not_includes_all","less_than","exactly","more_than","before","on","after"],"isRequired":true},"value":{"type":"string"},"value2":{"type":"string"},"values":{"type":"array","items":{"type":"string"}}}},{"type":"object","required":["type","match","conditions"],"properties":{"type":{"type":"string","enum":["group"],"isRequired":true},"match":{"type":"string","enum":["all","any"],"isRequired":true},"conditions":{"minItems":1,"type":"array","items":{"$circularRef":"7599b088-c1e6-49bf-842c-0ee9fa13f591"},"description":"The grouped conditions — at least one. An EMPTY group is not \"no filter\": it never matches, so next to an AND it makes the whole rule unmatchable, and writing one is rejected. A version saved with an empty group in the BUILDER still reads back with it (validate warns); writing that list back is refused until the group is filled or dropped.","isRequired":true}}}]}}}},{"type":"object","required":["type","op"],"properties":{"type":{"type":"string","enum":["text_input"],"isRequired":true},"op":{"type":"string","enum":["is","not","contains","not_contains","starts_with","ends_with","match","unmatch","any","empty"],"isRequired":true},"target":{"type":"object","properties":{"selector":{"type":"string","minLength":1,"description":"A stable CSS selector for the element, on the page or inside a same-origin iframe (written relative to the frame's own document). The runtime targets the FIRST match — so either make the selector unique, or pair a stable non-unique selector with `nth` to pick the intended match. A non-unique selector with no `nth` targets the first (often wrong) element and the tooltip silently won't render.","isRequired":true},"text":{"description":"Optional refinement of `selector`. Requires the targeted element's visible text to equal this (exact match, after trim) — use it to pin a specific content/state (e.g. a stable id whose displayed text you want to match: id + text). It refines the element chosen by `selector`/`nth`; on its own it does NOT search among multiple matches, so disambiguate a non-unique selector with `nth`, not `text` alone.","type":"string"},"nth":{"description":"Optional refinement of `selector`. 0-based index to pick which match when the selector isn't unique — e.g. a stable selector matching 3 elements + `nth: 1` targets the 2nd, giving a unique result. Matches are taken in document order (as they appear in the page HTML). Range 0–4 — only the first 5 matches are addressable; a larger value is rejected.","type":"integer","minimum":0,"maximum":4}},"required":["selector"]},"value":{"type":"string"}}},{"type":"object","required":["type"],"properties":{"type":{"type":"string","enum":["text_filled"],"isRequired":true},"target":{"type":"object","properties":{"selector":{"type":"string","minLength":1,"description":"A stable CSS selector for the element, on the page or inside a same-origin iframe (written relative to the frame's own document). The runtime targets the FIRST match — so either make the selector unique, or pair a stable non-unique selector with `nth` to pick the intended match. A non-unique selector with no `nth` targets the first (often wrong) element and the tooltip silently won't render.","isRequired":true},"text":{"description":"Optional refinement of `selector`. Requires the targeted element's visible text to equal this (exact match, after trim) — use it to pin a specific content/state (e.g. a stable id whose displayed text you want to match: id + text). It refines the element chosen by `selector`/`nth`; on its own it does NOT search among multiple matches, so disambiguate a non-unique selector with `nth`, not `text` alone.","type":"string"},"nth":{"description":"Optional refinement of `selector`. 0-based index to pick which match when the selector isn't unique — e.g. a stable selector matching 3 elements + `nth: 1` targets the 2nd, giving a unique result. Matches are taken in document order (as they appear in the page HTML). Range 0–4 — only the first 5 matches are addressable; a larger value is rejected.","type":"integer","minimum":0,"maximum":4}},"required":["selector"]}}},{"type":"object","required":["type","start"],"properties":{"type":{"type":"string","enum":["time_window"],"isRequired":true},"start":{"type":"string","description":"Window start (ISO datetime). REQUIRED — the runtime never matches a window without a start, so an end-only window is rejected at write. For \"until X\" semantics, set start to any past instant and end to X.","isRequired":true},"end":{"description":"Window end (ISO datetime). Omit for an open-ended \"from start onwards\" window.","type":"string"}}},{"type":"object","description":"Read-side placeholder for a stored condition this API cannot express (`note` says what it stands for — usually a DEAD condition the runtime never matches: a deleted attribute/event, an end-only time window). It cannot be written back (the placeholder carries no data to preserve): echoing it is rejected. Either remove it from the list you write — an explicit choice that DELETES the stored condition; mind that a never-matching node inside an AND list pins the whole rule to \"never fires\", so deleting it can bring the remaining conditions to life — or repair the original condition in the Usertour builder first.","required":["type"],"properties":{"type":{"type":"string","enum":["unsupported"],"isRequired":true},"note":{"type":"string"}}}]}},"variant":{"type":"string","enum":["primary","secondary"]},"margin":{"type":"object","properties":{"enabled":{"type":"boolean"},"top":{"type":"number"},"bottom":{"type":"number"},"left":{"type":"number"},"right":{"type":"number"}}}}},{"type":"object","required":["type","url"],"properties":{"type":{"type":"string","enum":["embed"],"isRequired":true},"url":{"type":"string","minLength":1,"description":"Paste the page's normal URL (e.g. a youtube.com/watch link) — on write it is resolved through the standard oEmbed provider registry (YouTube, Vimeo, Loom, Figma, …) and the provider's official embed markup is stored, so you never hand-build /embed/ URLs. A URL no provider claims is iframed as-is — it renders only if that site allows being framed (no X-Frame-Options/CSP block).","isRequired":true},"object":{"default":"block","type":"string","enum":["block"]},"id":{"type":"string"},"width":{"type":"object","properties":{"unit":{"type":"string","enum":["percent","pixels"],"isRequired":true},"value":{"type":"number","minimum":0}},"required":["unit"]},"height":{"description":"Embed height. Optional ONLY for provider embeds (YouTube/Vimeo/… size themselves by aspect ratio); a URL with NO oEmbed provider has no ratio, and omitting a pixel height leaves the iframe at the browser's built-in default — a strip ~150px tall, almost never the intended size (validate warns). For plain-iframe URLs always set `{ \"unit\": \"pixels\", \"value\": … }`.","type":"object","properties":{"unit":{"type":"string","enum":["percent","pixels"],"isRequired":true},"value":{"type":"number","minimum":0}},"required":["unit"]},"margin":{"type":"object","properties":{"enabled":{"type":"boolean"},"top":{"type":"number"},"bottom":{"type":"number"},"left":{"type":"number"},"right":{"type":"number"}}}}},{"type":"object","required":["type","question"],"properties":{"type":{"type":"string","enum":["question"],"isRequired":true},"question":{"oneOf":[{"type":"object","required":["kind","name"],"properties":{"kind":{"type":"string","enum":["nps"],"isRequired":true},"name":{"type":"string","description":"The question's internal name / analytics label (it is the `questionName` on captured responses). It is NOT rendered to the user — the widget shows only the input (scale / options / text field), not this string. To show a visible question prompt, add a `text` block in the SAME step before the question block; a question with only a `name` renders as bare options with no question text.","isRequired":true},"cvid":{"type":"string"},"lowLabel":{"type":"string"},"highLabel":{"type":"string"},"bindAttribute":{"description":"Optional: codeName of an EXISTING attribute (create the attribute definition first) to ALSO save this answer onto the user for targeting/segmentation — use the codeName, NOT the id. The write does not check it, but the version validation WARNS when the attribute is missing or its dataType mismatches the answer — read warnings. A wrong code that slips through silently captures nothing at runtime. Match the attribute dataType to the answer: number (nps / rating), string (single-select choice), list (multi-select choice). Leaving it unset still records the answer as a response event — bind only when you need to target/segment on it.","type":"string"}},"isRequired":true},{"type":"object","required":["kind","name","style","range"],"properties":{"kind":{"type":"string","enum":["rating"],"isRequired":true},"name":{"type":"string","description":"The question's internal name / analytics label (it is the `questionName` on captured responses). It is NOT rendered to the user — the widget shows only the input (scale / options / text field), not this string. To show a visible question prompt, add a `text` block in the SAME step before the question block; a question with only a `name` renders as bare options with no question text.","isRequired":true},"style":{"type":"string","enum":["star","scale"],"description":"star = star rating; scale = a numeric scale. A \"scale\" question IS a rating with style:\"scale\" — there is no separate \"scale\" kind.","isRequired":true},"range":{"type":"object","properties":{"low":{"type":"number","isRequired":true},"high":{"type":"number","isRequired":true}},"required":["low","high"],"description":"Numeric range, e.g. { low: 1, high: 5 }.","isRequired":true},"cvid":{"type":"string"},"lowLabel":{"type":"string"},"highLabel":{"type":"string"},"bindAttribute":{"description":"Optional: codeName of an EXISTING attribute (create the attribute definition first) to ALSO save this answer onto the user for targeting/segmentation — use the codeName, NOT the id. The write does not check it, but the version validation WARNS when the attribute is missing or its dataType mismatches the answer — read warnings. A wrong code that slips through silently captures nothing at runtime. Match the attribute dataType to the answer: number (nps / rating), string (single-select choice), list (multi-select choice). Leaving it unset still records the answer as a response event — bind only when you need to target/segment on it.","type":"string"}},"isRequired":true},{"type":"object","required":["kind","name","multiline"],"properties":{"kind":{"type":"string","enum":["text"],"isRequired":true},"name":{"type":"string","description":"The question's internal name / analytics label (it is the `questionName` on captured responses). It is NOT rendered to the user — the widget shows only the input (scale / options / text field), not this string. To show a visible question prompt, add a `text` block in the SAME step before the question block; a question with only a `name` renders as bare options with no question text.","isRequired":true},"multiline":{"type":"boolean","isRequired":true},"cvid":{"type":"string"},"placeholder":{"type":"string"},"buttonText":{"type":"string"},"required":{"description":"Require an answer before submit. ONLY `text` supports this — nps / rating / choice cannot be marked required.","type":"boolean"},"bindAttribute":{"description":"Optional: codeName of an EXISTING attribute (create the attribute definition first) to ALSO save this answer onto the user for targeting/segmentation — use the codeName, NOT the id. The write does not check it, but the version validation WARNS when the attribute is missing or its dataType mismatches the answer — read warnings. A wrong code that slips through silently captures nothing at runtime. Match the attribute dataType to the answer: number (nps / rating), string (single-select choice), list (multi-select choice). Leaving it unset still records the answer as a response event — bind only when you need to target/segment on it.","type":"string"}},"isRequired":true},{"type":"object","required":["kind","name","options","allowMultiple"],"properties":{"kind":{"type":"string","enum":["choice"],"isRequired":true},"name":{"type":"string","description":"The question's internal name / analytics label (it is the `questionName` on captured responses). It is NOT rendered to the user — the widget shows only the input (scale / options / text field), not this string. To show a visible question prompt, add a `text` block in the SAME step before the question block; a question with only a `name` renders as bare options with no question text.","isRequired":true},"options":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string","isRequired":true},"value":{"type":"string","isRequired":true}},"required":["label","value"]},"description":"Each option has a human-facing `label` and a stored `value` — the `value` is what gets recorded/bound as the answer.","isRequired":true},"allowMultiple":{"type":"boolean","description":"false = single-select, true = multi-select. A multi-select answer needs a `list`-typed bound attribute.","isRequired":true},"cvid":{"type":"string"},"enableOther":{"type":"boolean"},"otherPlaceholder":{"type":"string"},"shuffle":{"type":"boolean"},"buttonText":{"type":"string"},"bindAttribute":{"description":"Optional: codeName of an EXISTING attribute (create the attribute definition first) to ALSO save this answer onto the user for targeting/segmentation — use the codeName, NOT the id. The write does not check it, but the version validation WARNS when the attribute is missing or its dataType mismatches the answer — read warnings. A wrong code that slips through silently captures nothing at runtime. Match the attribute dataType to the answer: number (nps / rating), string (single-select choice), list (multi-select choice). Leaving it unset still records the answer as a response event — bind only when you need to target/segment on it.","type":"string"}},"isRequired":true}],"isRequired":true},"object":{"default":"block","type":"string","enum":["block"]},"id":{"type":"string"},"actions":{"description":"Actions that fire when this question is answered (on pick for nps/rating/single-select; on its Submit button for text/multi-select). Put a `goto_step` HERE to advance to the next step — without it the question records the answer but the flow does NOT advance (validate flags the next step \"not reachable\"). Do NOT add a separate `button` block just to advance: it doubles up with the question's own submit affordance.","type":"array","items":{"oneOf":[{"type":"object","required":["type","step"],"properties":{"type":{"type":"string","enum":["goto_step"],"isRequired":true},"step":{"type":"string","description":"Target step: a step `key` declared elsewhere in the same write, or an existing step cvid. Resolved server-side to the cvid.","isRequired":true}}},{"type":"object","required":["type","content"],"properties":{"type":{"type":"string","enum":["start_content"],"isRequired":true},"content":{"type":"string","description":"contentId of the flow or checklist to launch (an id from the content list) — a raw content id, NOT a step key (unlike goto_step). Must reference a flow or checklist (a banner / launcher / resource-center / tracker is rejected at write). The target must be PUBLISHED to actually start at runtime; an unknown/dangling id is rejected at validate.","isRequired":true},"step":{"description":"Optional cvid of a step within the launched flow to start at.","type":"string"}}},{"type":"object","required":["type","url"],"properties":{"type":{"type":"string","enum":["navigate"],"isRequired":true},"url":{"type":"string","description":"Absolute URL, or an app-relative path (\"/docs/x\") resolved against the origin the user is on — relative paths are the normal choice for in-app navigation.","isRequired":true},"newTab":{"description":"Open the URL in a new browser tab instead of navigating the current one.","type":"boolean"}}},{"type":"object","description":"Dismiss the piece the action lives on. NOT accepted everywhere this union appears: a resource center has no dismiss (closing the panel is a UI affordance, not an action) and an announcement is marked seen, never dismissed — writes there are rejected (E1017), not ignored. Flows / checklists / launchers / banners all accept it.","required":["type"],"properties":{"type":{"type":"string","enum":["dismiss"],"isRequired":true}}},{"type":"object","description":"Read-back of an existing script action — scripts are not authorable through this API. Echo it back UNCHANGED (same script) when rewriting the surrounding list and the stored action is preserved; omitting it deletes it (action lists are full replacements). Authoring a new or edited script is rejected.","required":["type","script"],"properties":{"type":{"type":"string","enum":["run_javascript"],"isRequired":true},"script":{"type":"string","isRequired":true}}},{"type":"object","description":"Echo-only placeholder for a stored action this schema cannot express (`note` = internal type). Echo it back to preserve the stored action; writing one fresh is rejected.","required":["type"],"properties":{"type":{"type":"string","enum":["unsupported"],"isRequired":true},"note":{"type":"string"}}}]}}}},{"type":"object","description":"Lays 2+ blocks out side by side in one row. Top-level `content` blocks otherwise stack vertically — each is its own full-width row — so two `button` blocks placed directly in `content` render as two stacked rows, NOT a button pair. For a modal/tooltip footer with a Skip + primary button: one `columns` block with two `{ width: { unit: \"fill\" }, blocks: [...] }` entries, one button per column.","required":["type","columns"],"properties":{"type":{"type":"string","enum":["columns"],"isRequired":true},"columns":{"type":"array","items":{"type":"object","properties":{"blocks":{"type":"array","items":{"$circularRef":"cbc2a478-9fbf-4840-91c6-77587e9b8cf5"},"isRequired":true},"width":{"type":"object","properties":{"unit":{"type":"string","enum":["percent","pixels","fill"],"isRequired":true},"value":{"type":"number","minimum":0}},"required":["unit"]},"justify":{"description":"Horizontal alignment of this column's own block(s) within the column's width — use \"end\"/\"center\" to right-align or center a lone button (a single-column `columns` block).","type":"string","enum":["start","center","end","between","around","evenly"]},"align":{"type":"string","enum":["start","center","end","baseline"]},"padding":{"type":"object","properties":{"enabled":{"type":"boolean"},"top":{"type":"number"},"bottom":{"type":"number"},"left":{"type":"number"},"right":{"type":"number"}}}},"required":["blocks"]},"description":"One entry per column, laid out left-to-right. Each column is a mini vertical stack of `blocks` (usually one).","isRequired":true},"object":{"default":"block","type":"string","enum":["block"]},"id":{"type":"string"}}},{"type":"object","required":["type"],"properties":{"type":{"type":"string","enum":["unsupported"],"isRequired":true},"object":{"default":"block","type":"string","enum":["block"]},"id":{"type":"string"},"note":{"type":"string"}}}]}},"processedSecurityOptions":[{"schemes":[{"scheme":{"scheme":"bearer","bearerFormat":"utp_... personal API token (opaque)","type":"http","scopes":[],"schemeName":"bearer"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearer","name":"Authorization"}],"title":"bearer"}]},"originalFileLocation":"api-reference-v2/openapi.json"},"subdomain":"usertour","siteName":"Usertour documention","title":"Restore deleted content - Usertour documention","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-10T06:48:43.672Z","originalFileLocation":"api-reference/content/restore-deleted-content.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=\"Restore soft-deleted content (find it via GET /content?deleted=true). It returns as an unpublished draft with versions and history intact — publish again explicitly to go live. Idempotent on content that is not deleted.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Usertour documention\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/usertour/vM2wRfIVfuMnzscJ/_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=\"/mintlify-assets/_mintlify/favicons/usertour/vM2wRfIVfuMnzscJ/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/usertour/vM2wRfIVfuMnzscJ/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/usertour/vM2wRfIVfuMnzscJ/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/usertour/vM2wRfIVfuMnzscJ/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/usertour/vM2wRfIVfuMnzscJ/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/usertour/vM2wRfIVfuMnzscJ/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/usertour/vM2wRfIVfuMnzscJ/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/usertour/vM2wRfIVfuMnzscJ/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Restore deleted content - Usertour documention\">\u003cmeta data-mint-head property=\"og:description\" content=\"Restore soft-deleted content (find it via GET /content?deleted=true). It returns as an unpublished draft with versions and history intact — publish again explicitly to go live. Idempotent on content that is not deleted.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Usertour documention\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.usertour.io/api-reference/content/restore-deleted-content\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://usertour.mintlify.site/_mintlify/api/og/v2?division=Content\u0026amp;title=Restore+deleted+content\u0026amp;description=Restore+soft-deleted+content+%28find+it+via+GET+%2Fcontent%3Fdeleted%3Dtrue%29.+It+returns+as+an+unpublished+draft+with+versions+and+history+intact+%E2%80%94+publish+again+explic\u0026amp;theme=51092ed6781dc62f07a52a12\u0026amp;signature=dc71c901ffdc568947c63943e0d5990023bf694a6dc2aeb1e7551f13aafe4ea8\">\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=\"Restore deleted content - Usertour documention\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Restore soft-deleted content (find it via GET /content?deleted=true). It returns as an unpublished draft with versions and history intact — publish again explicitly to go live. Idempotent on content that is not deleted.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://usertour.mintlify.site/_mintlify/api/og/v2?division=Content\u0026amp;title=Restore+deleted+content\u0026amp;description=Restore+soft-deleted+content+%28find+it+via+GET+%2Fcontent%3Fdeleted%3Dtrue%29.+It+returns+as+an+unpublished+draft+with+versions+and+history+intact+%E2%80%94+publish+again+explic\u0026amp;theme=51092ed6781dc62f07a52a12\u0026amp;signature=dc71c901ffdc568947c63943e0d5990023bf694a6dc2aeb1e7551f13aafe4ea8\">\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=\"/mintlify-assets/_mintlify/favicons/usertour/vM2wRfIVfuMnzscJ/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Usertour documention\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0D9373\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.usertour.io/api-reference/content/restore-deleted-content\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/content/restore-deleted-content.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.usertour.io/#organization\",\"name\":\"Usertour documention\",\"url\":\"https://docs.usertour.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/usertour/fGy2waOqk2YYQ2QK/logo-dark.svg?fit=max\u0026auto=format\u0026n=fGy2waOqk2YYQ2QK\u0026q=85\u0026s=841070ff620cff55401ec69cfc514e27\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.usertour.io#website\",\"name\":\"Usertour documention\",\"url\":\"https://docs.usertour.io\",\"publisher\":{\"@id\":\"https://docs.usertour.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.usertour.io/api-reference/content/restore-deleted-content#webpage\",\"url\":\"https://docs.usertour.io/api-reference/content/restore-deleted-content\",\"name\":\"Restore deleted content\",\"description\":\"Restore soft-deleted content (find it via GET /content?deleted=true). It returns as an unpublished draft with versions and history intact — publish again explicitly to go live. Idempotent on content that is not deleted.\",\"dateModified\":\"2026-11-10T06:48:43.672Z\",\"isPartOf\":{\"@id\":\"https://docs.usertour.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.usertour.io/api-reference/content/restore-deleted-content#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.usertour.io/api-reference/content/restore-deleted-content#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Endpoints\",\"item\":\"https://docs.usertour.io/api-reference/analytics/get-content-analytics\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Content\",\"item\":\"https://docs.usertour.io/api-reference/content/list-content\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Restore deleted content\",\"item\":\"https://docs.usertour.io/api-reference/content/restore-deleted-content\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.usertour.io/api-reference/content/restore-deleted-content#apireference\",\"headline\":\"Restore deleted content\",\"name\":\"Restore deleted content\",\"description\":\"Restore soft-deleted content (find it via GET /content?deleted=true). It returns as an unpublished draft with versions and history intact — publish again explicitly to go live. Idempotent on content that is not deleted.\",\"url\":\"https://docs.usertour.io/api-reference/content/restore-deleted-content\",\"mainEntityOfPage\":{\"@id\":\"https://docs.usertour.io/api-reference/content/restore-deleted-content#webpage\"},\"dateModified\":\"2026-11-10T06:48:43.672Z\",\"publisher\":{\"@id\":\"https://docs.usertour.io/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.usertour.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Usertour documention\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Usertour documention\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/content/restore-deleted-content.md","siteName":"Usertour documention","nav":{"global":null,"anchors":[{"anchor":"Documentation","icon":"book-open","pages":[{"title":"Documentation","href":"/build-onboarding-with-ai"}]},{"anchor":"Usertour.js Reference","icon":"connectdevelop","pages":[{"title":"Usertour.js Reference","href":"/developers/usertourjs-reference/overview"}]},{"anchor":"API Reference","icon":"terminal","groups":[{"group":"Getting started","pages":[{"title":"Introduction","href":"/api-reference-v2/introduction"},{"title":"Authentication","href":"/api-reference-v2/authentication"},{"title":"Errors","href":"/api-reference-v2/errors"},{"title":"MCP server","href":"/api-reference-v2/mcp"}]},{"group":"Conventions","pages":[{"title":"Pagination","href":"/api-reference-v2/pagination"},{"title":"Ordering","href":"/api-reference-v2/ordering"},{"title":"Expanding objects","href":"/api-reference-v2/expanding-objects"},{"title":"Attributes","href":"/api-reference-v2/attributes"}]},{"group":"Concepts","pages":[{"title":"Content representation","href":"/api-reference-v2/content-representation"},{"title":"Blocks","href":"/api-reference-v2/blocks"},{"title":"Conditions \u0026 actions","href":"/api-reference-v2/conditions-and-actions"},{"title":"Start, hide \u0026 trigger rules","href":"/api-reference-v2/rules"},{"title":"Type-specific data","href":"/api-reference-v2/type-data"}]},{"group":"Endpoints","pages":[{"group":"Analytics","pages":[{"title":"Get content analytics","deprecated":null,"version":null,"openapi":"/api-reference-v2/openapi.json get /v2/projects/{projectId}/content/{id}/analytics","href":"/api-reference/analytics/get-content-analytics"},{"title":"Get question analytics","deprecated":null,"version":null,"openapi":"/api-reference-v2/openapi.json get /v2/projects/{projectId}/content/{id}/analytics/questions","href":"/api-reference/analytics/get-question-analytics"}]},{"group":"Content","pages":[{"title":"List content","deprecated":null,"version":null,"openapi":"/api-reference-v2/openapi.json get /v2/projects/{projectId}/content","href":"/api-reference/content/list-content"},{"title":"Create content","deprecated":null,"version":null,"openapi":"/api-reference-v2/openapi.json post /v2/projects/{projectId}/content","href":"/api-reference/content/create-content"},{"title":"Get content","deprecated":null,"version":null,"openapi":"/api-reference-v2/openapi.json get /v2/projects/{projectId}/content/{id}","href":"/api-reference/content/get-content"},{"title":"Delete content","deprecated":null,"version":null,"openapi":"/api-reference-v2/openapi.json delete /v2/projects/{projectId}/content/{id}","href":"/api-reference/content/delete-content"},{"title":"Update content","description":"Update content metadata (name, buildUrl).","deprecated":null,"version":null,"openapi":"/api-reference-v2/openapi.json patch /v2/projects/{projectId}/content/{id}","href":"/api-reference/content/update-content"},{"title":"Restore deleted content","deprecated":null,"version":null,"openapi":"/api-reference-v2/openapi.json post /v2/projects/{projectId}/content/{id}/restore","href":"/api-reference/content/restore-deleted-content"},{"title":"Duplicate content","description":"Duplicate into a new content (copies the edited version's steps / config / data).","deprecated":null,"version":null,"openapi":"/api-reference-v2/openapi.json post /v2/projects/{projectId}/content/{id}/duplicate","href":"/api-reference/content/duplicate-content"},{"title":"Publish a version","deprecated":null,"version":null,"openapi":"/api-reference-v2/openapi.json post /v2/projects/{projectId}/content/{id}/publish","href":"/api-reference/content/publish-a-version"},{"title":"Unpublish a version","deprecated":null,"version":null,"openapi":"/api-reference-v2/openapi.json post /v2/projects/{projectId}/content/{id}/unpublish","href":"/api-reference/content/unpublish-a-version"}]},{"group":"Content versions","pages":[{"title":"List content versions","deprecated":null,"version":null,"openapi":"/api-reference-v2/openapi.json get /v2/projects/{projectId}/content/{contentId}/versions","href":"/api-reference/content-versions/list-content-versions"},{"title":"Create a content version","deprecated":null,"version":null,"openapi":"/api-reference-v2/openapi.json post /v2/projects/{projectId}/content/{contentId}/versions","href":"/api-reference/content-versions/create-a-content-version"},{"title":"Get a content version","deprecated":null,"version":null,"openapi":"/api-reference-v2/openapi.json get /v2/projects/{projectId}/content/{contentId}/versions/{id}","href":"/api-reference/content-versions/get-a-content-version"},{"title":"Update a content version","deprecated":null,"version":null,"openapi":"/api-reference-v2/openapi.json patch /v2/projects/{projectId}/content/{contentId}/versions/{id}","href":"/api-reference/content-versions/update-a-content-version"},{"title":"Validate a content version","deprecated":null,"version":null,"openapi":"/api-reference-v2/openapi.json get /v2/projects/{projectId}/content/{contentId}/versions/{id}/validate","href":"/api-reference/content-versions/validate-a-content-version"},{"title":"Restore a content version","deprecated":null,"version":null,"openapi":"/api-reference-v2/openapi.json post /v2/projects/{projectId}/content/{contentId}/versions/{id}/restore","href":"/api-reference/content-versions/restore-a-content-version"},{"title":"Get a translation","deprecated":null,"version":null,"openapi":"/api-reference-v2/openapi.json get /v2/projects/{projectId}/content/{contentId}/versions/{versionId}/localizations/{code}","href":"/api-reference/content-versions/get-a-translation"},{"title":"Update a translation","deprecated":null,"version":null,"openapi":"/api-reference-v2/openapi.json put /v2/projects/{projectId}/content/{contentId}/versions/{versionId}/localizations/{code}","href":"/api-reference/content-versions/update-a-translation"}]},{"group":"Themes","pages":[{"title":"List themes","deprecated":null,"version":null,"openapi":"/api-reference-v2/openapi.json get /v2/projects/{projectId}/themes","href":"/api-reference/themes/list-themes"},{"title":"Create a theme","deprecated":null,"version":null,"openapi":"/api-reference-v2/openapi.json post /v2/projects/{projectId}/themes","href":"/api-reference/themes/create-a-theme"},{"title":"Get a theme","deprecated":null,"version":null,"openapi":"/api-reference-v2/openapi.json get /v2/projects/{projectId}/themes/{id}","href":"/api-reference/themes/get-a-theme"},{"title":"Delete a theme","deprecated":null,"version":null,"openapi":"/api-reference-v2/openapi.json delete /v2/projects/{projectId}/themes/{id}","href":"/api-reference/themes/delete-a-theme"},{"title":"Update a theme","deprecated":null,"version":null,"openapi":"/api-reference-v2/openapi.json patch /v2/projects/{projectId}/themes/{id}","href":"/api-reference/themes/update-a-theme"},{"title":"Duplicate a theme","deprecated":null,"version":null,"openapi":"/api-reference-v2/openapi.json post /v2/projects/{projectId}/themes/{id}/duplicate","href":"/api-reference/themes/duplicate-a-theme"},{"title":"Restore a deleted theme","deprecated":null,"version":null,"openapi":"/api-reference-v2/openapi.json post /v2/projects/{projectId}/themes/{id}/restore","href":"/api-reference/themes/restore-a-deleted-theme"}]},{"group":"Users","pages":[{"title":"List users","deprecated":null,"version":null,"openapi":"/api-reference-v2/openapi.json get /v2/projects/{projectId}/environments/{environmentId}/users","href":"/api-reference/users/list-users"},{"title":"Get a user","deprecated":null,"version":null,"openapi":"/api-reference-v2/openapi.json get /v2/projects/{projectId}/environments/{environmentId}/users/{id}","href":"/api-reference/users/get-a-user"},{"title":"Create or update a user","deprecated":null,"version":null,"openapi":"/api-reference-v2/openapi.json put /v2/projects/{projectId}/environments/{environmentId}/users/{id}","href":"/api-reference/users/create-or-update-a-user"},{"title":"Delete a user","deprecated":null,"version":null,"openapi":"/api-reference-v2/openapi.json delete /v2/projects/{projectId}/environments/{environmentId}/users/{id}","href":"/api-reference/users/delete-a-user"}]},{"group":"Companies","pages":[{"title":"List companies","deprecated":null,"version":null,"openapi":"/api-reference-v2/openapi.json get /v2/projects/{projectId}/environments/{environmentId}/companies","href":"/api-reference/companies/list-companies"},{"title":"Get a company","deprecated":null,"version":null,"openapi":"/api-reference-v2/openapi.json get /v2/projects/{projectId}/environments/{environmentId}/companies/{id}","href":"/api-reference/companies/get-a-company"},{"title":"Create or update a company","deprecated":null,"version":null,"openapi":"/api-reference-v2/openapi.json put /v2/projects/{projectId}/environments/{environmentId}/companies/{id}","href":"/api-reference/companies/create-or-update-a-company"},{"title":"Delete a company","deprecated":null,"version":null,"openapi":"/api-reference-v2/openapi.json delete /v2/projects/{projectId}/environments/{environmentId}/companies/{id}","href":"/api-reference/companies/delete-a-company"},{"title":"Add a company member","deprecated":null,"version":null,"openapi":"/api-reference-v2/openapi.json put /v2/projects/{projectId}/environments/{environmentId}/companies/{id}/memberships/{userId}","href":"/api-reference/companies/add-a-company-member"},{"title":"Remove a company member","deprecated":null,"version":null,"openapi":"/api-reference-v2/openapi.json delete /v2/projects/{projectId}/environments/{environmentId}/companies/{id}/memberships/{userId}","href":"/api-reference/companies/remove-a-company-member"}]},{"group":"Segments","pages":[{"title":"List segments","deprecated":null,"version":null,"openapi":"/api-reference-v2/openapi.json get /v2/projects/{projectId}/segments","href":"/api-reference/segments/list-segments"},{"title":"Create a segment","deprecated":null,"version":null,"openapi":"/api-reference-v2/openapi.json post /v2/projects/{projectId}/segments","href":"/api-reference/segments/create-a-segment"},{"title":"Get a segment","deprecated":null,"version":null,"openapi":"/api-reference-v2/openapi.json get /v2/projects/{projectId}/segments/{id}","href":"/api-reference/segments/get-a-segment"},{"title":"Delete a segment","deprecated":null,"version":null,"openapi":"/api-reference-v2/openapi.json delete /v2/projects/{projectId}/segments/{id}","href":"/api-reference/segments/delete-a-segment"},{"title":"Update a segment","deprecated":null,"version":null,"openapi":"/api-reference-v2/openapi.json patch /v2/projects/{projectId}/segments/{id}","href":"/api-reference/segments/update-a-segment"},{"title":"Restore a deleted segment","deprecated":null,"version":null,"openapi":"/api-reference-v2/openapi.json post /v2/projects/{projectId}/segments/{id}/restore","href":"/api-reference/segments/restore-a-deleted-segment"},{"title":"Add a segment member","deprecated":null,"version":null,"openapi":"/api-reference-v2/openapi.json put /v2/projects/{projectId}/environments/{environmentId}/segments/{id}/members/{externalId}","href":"/api-reference/segments/add-a-segment-member"},{"title":"Remove a segment member","deprecated":null,"version":null,"openapi":"/api-reference-v2/openapi.json delete /v2/projects/{projectId}/environments/{environmentId}/segments/{id}/members/{externalId}","href":"/api-reference/segments/remove-a-segment-member"}]},{"group":"Sessions","pages":[{"title":"List sessions","deprecated":null,"version":null,"openapi":"/api-reference-v2/openapi.json get /v2/projects/{projectId}/environments/{environmentId}/sessions","href":"/api-reference/sessions/list-sessions"},{"title":"Get a session","deprecated":null,"version":null,"openapi":"/api-reference-v2/openapi.json get /v2/projects/{projectId}/environments/{environmentId}/sessions/{id}","href":"/api-reference/sessions/get-a-session"},{"title":"Delete a session","deprecated":null,"version":null,"openapi":"/api-reference-v2/openapi.json delete /v2/projects/{projectId}/environments/{environmentId}/sessions/{id}","href":"/api-reference/sessions/delete-a-session"},{"title":"End a session","deprecated":null,"version":null,"openapi":"/api-reference-v2/openapi.json post /v2/projects/{projectId}/environments/{environmentId}/sessions/{id}/end","href":"/api-reference/sessions/end-a-session"}]},{"group":"Attribute definitions","pages":[{"title":"List attribute definitions","deprecated":null,"version":null,"openapi":"/api-reference-v2/openapi.json get /v2/projects/{projectId}/attribute-definitions","href":"/api-reference/attribute-definitions/list-attribute-definitions"},{"title":"Create an attribute definition","deprecated":null,"version":null,"openapi":"/api-reference-v2/openapi.json post /v2/projects/{projectId}/attribute-definitions","href":"/api-reference/attribute-definitions/create-an-attribute-definition"},{"title":"Get an attribute definition","deprecated":null,"version":null,"openapi":"/api-reference-v2/openapi.json get /v2/projects/{projectId}/attribute-definitions/{id}","href":"/api-reference/attribute-definitions/get-an-attribute-definition"},{"title":"Delete an attribute definition","deprecated":null,"version":null,"openapi":"/api-reference-v2/openapi.json delete /v2/projects/{projectId}/attribute-definitions/{id}","href":"/api-reference/attribute-definitions/delete-an-attribute-definition"},{"title":"Update an attribute definition","deprecated":null,"version":null,"openapi":"/api-reference-v2/openapi.json patch /v2/projects/{projectId}/attribute-definitions/{id}","href":"/api-reference/attribute-definitions/update-an-attribute-definition"},{"title":"Restore a deleted attribute definition","deprecated":null,"version":null,"openapi":"/api-reference-v2/openapi.json post /v2/projects/{projectId}/attribute-definitions/{id}/restore","href":"/api-reference/attribute-definitions/restore-a-deleted-attribute-definition"}]},{"group":"Event definitions","pages":[{"title":"List event definitions","deprecated":null,"version":null,"openapi":"/api-reference-v2/openapi.json get /v2/projects/{projectId}/event-definitions","href":"/api-reference/event-definitions/list-event-definitions"},{"title":"Create an event definition","deprecated":null,"version":null,"openapi":"/api-reference-v2/openapi.json post /v2/projects/{projectId}/event-definitions","href":"/api-reference/event-definitions/create-an-event-definition"},{"title":"Get an event definition","deprecated":null,"version":null,"openapi":"/api-reference-v2/openapi.json get /v2/projects/{projectId}/event-definitions/{id}","href":"/api-reference/event-definitions/get-an-event-definition"},{"title":"Delete an event definition","deprecated":null,"version":null,"openapi":"/api-reference-v2/openapi.json delete /v2/projects/{projectId}/event-definitions/{id}","href":"/api-reference/event-definitions/delete-an-event-definition"},{"title":"Update an event definition","deprecated":null,"version":null,"openapi":"/api-reference-v2/openapi.json patch /v2/projects/{projectId}/event-definitions/{id}","href":"/api-reference/event-definitions/update-an-event-definition"},{"title":"Restore a deleted event definition","deprecated":null,"version":null,"openapi":"/api-reference-v2/openapi.json post /v2/projects/{projectId}/event-definitions/{id}/restore","href":"/api-reference/event-definitions/restore-a-deleted-event-definition"}]},{"group":"Webhooks","pages":[{"title":"List webhooks","deprecated":null,"version":null,"openapi":"/api-reference-v2/openapi.json get /v2/projects/{projectId}/environments/{environmentId}/webhooks","href":"/api-reference/webhooks/list-webhooks"},{"title":"Create a webhook","deprecated":null,"version":null,"openapi":"/api-reference-v2/openapi.json post /v2/projects/{projectId}/environments/{environmentId}/webhooks","href":"/api-reference/webhooks/create-a-webhook"},{"title":"Get a webhook (includes the signing secret for webhook:manage tokens)","deprecated":null,"version":null,"openapi":"/api-reference-v2/openapi.json get /v2/projects/{projectId}/environments/{environmentId}/webhooks/{id}","href":"/api-reference/webhooks/get-a-webhook-includes-the-signing-secret-for-webhook:manage-tokens"},{"title":"Delete a webhook","deprecated":null,"version":null,"openapi":"/api-reference-v2/openapi.json delete /v2/projects/{projectId}/environments/{environmentId}/webhooks/{id}","href":"/api-reference/webhooks/delete-a-webhook"},{"title":"Update a webhook","deprecated":null,"version":null,"openapi":"/api-reference-v2/openapi.json patch /v2/projects/{projectId}/environments/{environmentId}/webhooks/{id}","href":"/api-reference/webhooks/update-a-webhook"},{"title":"Rotate the signing secret","deprecated":null,"version":null,"openapi":"/api-reference-v2/openapi.json post /v2/projects/{projectId}/environments/{environmentId}/webhooks/{id}/rotate-secret","href":"/api-reference/webhooks/rotate-the-signing-secret"}]},{"group":"Me","pages":[{"title":"Introspect the token","deprecated":null,"version":null,"openapi":"/api-reference-v2/openapi.json get /v2/me","href":"/api-reference/me/introspect-the-token"}]},{"group":"Localizations","pages":[{"title":"List locales","deprecated":null,"version":null,"openapi":"/api-reference-v2/openapi.json get /v2/locales","href":"/api-reference/localizations/list-locales"},{"title":"List localizations","deprecated":null,"version":null,"openapi":"/api-reference-v2/openapi.json get /v2/projects/{projectId}/localizations","href":"/api-reference/localizations/list-localizations"},{"title":"Create a localization","deprecated":null,"version":null,"openapi":"/api-reference-v2/openapi.json post /v2/projects/{projectId}/localizations","href":"/api-reference/localizations/create-a-localization"},{"title":"Delete a localization","deprecated":null,"version":null,"openapi":"/api-reference-v2/openapi.json delete /v2/projects/{projectId}/localizations/{id}","href":"/api-reference/localizations/delete-a-localization"},{"title":"Update a localization","deprecated":null,"version":null,"openapi":"/api-reference-v2/openapi.json patch /v2/projects/{projectId}/localizations/{id}","href":"/api-reference/localizations/update-a-localization"},{"title":"Restore a deleted localization","deprecated":null,"version":null,"openapi":"/api-reference-v2/openapi.json post /v2/projects/{projectId}/localizations/{id}/restore","href":"/api-reference/localizations/restore-a-deleted-localization"}]},{"group":"Events","pages":[{"title":"Track an event","deprecated":null,"version":null,"openapi":"/api-reference-v2/openapi.json post /v2/projects/{projectId}/environments/{environmentId}/events","href":"/api-reference/events/track-an-event"}]},{"group":"Environments","pages":[{"title":"List environments","deprecated":null,"version":null,"openapi":"/api-reference-v2/openapi.json get /v2/projects/{projectId}/environments","href":"/api-reference/environments/list-environments"},{"title":"Create an environment","deprecated":null,"version":null,"openapi":"/api-reference-v2/openapi.json post /v2/projects/{projectId}/environments","href":"/api-reference/environments/create-an-environment"},{"title":"Get an environment","deprecated":null,"version":null,"openapi":"/api-reference-v2/openapi.json get /v2/projects/{projectId}/environments/{id}","href":"/api-reference/environments/get-an-environment"},{"title":"Delete an environment","deprecated":null,"version":null,"openapi":"/api-reference-v2/openapi.json delete /v2/projects/{projectId}/environments/{id}","href":"/api-reference/environments/delete-an-environment"},{"title":"Update an environment","deprecated":null,"version":null,"openapi":"/api-reference-v2/openapi.json patch /v2/projects/{projectId}/environments/{id}","href":"/api-reference/environments/update-an-environment"}]}]}]},{"anchor":"Self-Hosting","icon":"github","pages":[{"title":"Self-Hosting","href":"/open-source/self-hosting"}]},{"anchor":"Use Cases","icon":"route","pages":[{"title":"Use Cases","href":"/use-cases/analyze-onboarding-with-ai"}]},{"anchor":"API Reference (v1)","icon":"terminal","pages":[{"title":"API Reference (v1)","href":"/api-reference/introduction"}]},{"anchor":"Changelog","icon":"clock-rotate-left","pages":[{"title":"Changelog","href":"/changelog/2026"}]}]},"basePath":"","title":"Restore deleted content - Usertour documention","buildId":"dpl_596ePT575z4qnAFksq1biRW97aLY","deploymentId":"dpl_596ePT575z4qnAFksq1biRW97aLY","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-C9Wu0MeN.js","utils-jWgu-6Qf.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DBD8f9qn.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-BGuX1ui5.js","snippetPresets-Evy63nQB.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BQHO1lnV.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-B6C8m-t_.js","shallow-BG4cT0fH.js","getApiPlaygroundDisplay-CgEPrE-D.js","CodeSnippet-CU8JyZ9N.js","CodeSnippets-BnxHU32T.js","Page-D6S0Yh6q.js","getPastedJson-CwiYOonh.js","icon-DYDpWmDf.js","MethodPill-C-J-l7_c.js","DuplicateIcon-B6ARwg9w.js","createIcon-Dsv4MtDq.js","DynamicMarkdown-CtasenyM.js","SectionHeading-YNcgYwjB.js","axios-vUo_bRtp.js","Markdown-CwLx6PAg.js","clsx-C3kuh_dz.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CmKHfscc.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-U3mI6Ljh.js"]}