Introduced in: 6.1.0.
Action required: if you use encrypted single-use survey links issued before 6.1.0.Back to the 6.1 checklist.
Encrypted single-use survey links must be regenerated (action required if you use them)
Encrypted single-use survey links issued before 6.1 stop working and have to be regenerated.
What to do when upgrading
Regenerate after upgrading, not before. Links minted by the old version are unsigned whichever
day you mint them, so regenerating first produces a second batch that the new version rejects exactly
like the first.
Plan a maintenance window covering the deploy and the redistribution. Outstanding links stop
working the moment the new version serves traffic, and a respondent who opened one before the
deploy and submits after it sees the invitation error and loses their answers.
Deploy 6.1 or later.
Regenerate the links for any survey with single-use enabled and URL encryption of single-use
ID on, from the survey’s share modal or via
GET /api/v1/management/surveys/{surveyId}/singleUseIds. The new version signs them.
Re-send. Formbricks never stores generated links, so there is nothing to migrate and nothing to
back up — the new links simply replace the old ones.
Links with URL encryption off that already have a valid signature are unaffected, including signed custom single-use IDs.
If coming from v4, first account for the v5 signature change. Those have carried
a suToken signature since 5.0 and validate exactly as before, so integrations that mint their own
IDs need no changes.
What you will see if you skip it
Opening an old encrypted link shows “This survey can only be taken by invitation”, and submissions
against it are rejected. Server logs record one warn per rejection carrying the survey id and a
reason of missing_signature.
Why
An encrypted single-use link carried only an encrypted id and no signature, so nothing tied it to the
survey it was issued for and any survey on the same deployment accepted it. Both modes now carry the
same signature, which is what the old links are missing.
If you cannot re-issue in time
SINGLE_USE_LEGACY_UNSIGNED_UNTIL keeps the old links working for a fixed period, so an in-flight
campaign does not die on upgrade day. It takes an ISO 8601 date and is unset by default:Set this on the app service’s environment (Compose) or app Secret/environment bindings (Kubernetes),
then recreate/redeploy the app. Replace YYYY-MM-DD with your chosen deadline:
SINGLE_USE_LEGACY_UNSIGNED_UNTIL=YYYY-MM-DD
Unsigned encrypted links are accepted until 00:00 UTC on that date, and rejected from then on.
Nothing else changes: links with URL encryption off are untouched, a suToken that is present but
wrong is still rejected, and the id must still decrypt under your ENCRYPTION_KEY.
This re-opens the vulnerability the release closed, for as long as it is set. An unsigned encrypted
link is bound to no survey, so a link issued for one survey opens any survey on the same
instance — on a deployment serving more than one organisation, that is across organisations. Set it
only on a single-tenant instance, only for as long as re-issuing takes, and only as a deliberate
decision. It is not a substitute for step 3 above.
Each accepted legacy link is logged at warn with the survey id and the configured expiry, and
counted on formbricks_survey_single_use_link_validations_total with reason="legacy_unsigned".
Watch that series fall to zero, then remove the variable — it tells you when the window has stopped
carrying traffic and re-issuing is complete.
Rollback
Do not downgrade the application to recover links. Regenerate signed links. An older image reintroduces
the vulnerability and may be incompatible with the migrated database.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Documentation - Formbricks","colors":{"primary":"#00C4B8","light":"#00C4B8","dark":"#00C4B8"},"logo":{"light":"https://mintcdn.com/formbricks/wqEbm3FT1QK_6-vL/images/logo-light.svg?fit=max\u0026auto=format\u0026n=wqEbm3FT1QK_6-vL\u0026q=85\u0026s=365e5fb767b72b4fbbb2016860fd92ba","dark":"https://mintcdn.com/formbricks/wqEbm3FT1QK_6-vL/images/logo-dark.svg?fit=max\u0026auto=format\u0026n=wqEbm3FT1QK_6-vL\u0026q=85\u0026s=763690d005584ee5f4b4014615c3b98c"},"favicon":"https://mintcdn.com/formbricks/wqEbm3FT1QK_6-vL/images/favicon.svg?fit=max\u0026auto=format\u0026n=wqEbm3FT1QK_6-vL\u0026q=85\u0026s=01910ab43e3a3acc0aca5471235b90c5","navbar":{"links":[{"href":"/platform/changelog","label":"Release notes"},{"href":"https://github.com/formbricks/formbricks/discussions","label":"Support"}],"primary":{"type":"button","label":"Go to app","href":"https://app.formbricks.com"}},"footer":{"socials":{"github":"https://github.com/formbricks/formbricks","linkedin":"https://linkedin.com/company/formbricks","x":"https://x.com/formbricks"}},"integrations":{"posthog":{"apiKey":"phc_zJO1n3rjHlhqKiJ0gqLDwT4qvfWF1wzHDq2gfl0moQm","apiHost":"https://eu.i.posthog.com"}},"errors":{"404":{"redirect":true}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"formbricks","hasAudioNarration":false,"actualSubdomain":"formbricks","customDomains":["formbricks.com"],"gitSource":{"type":"github","owner":"formbricks","repo":"formbricks","deployBranch":"release/6.2","contentDirectory":"docs","isPrivate":false,"mountPath":"","label":"","_id":"6af9b4d1e79e0e5d7035333b"},"feedback":{"thumbs":true,"issues":true,"edits":true,"agentFeedback":false},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6af9b4d1e79e0e5d70353341","clientVersion":"0.0.4143","searchFilterCounts":[{"language":"default","tag":"Surveys (Ask)","count":99},{"language":"default","tag":"Self Hosting","count":86},{"language":"default","tag":"Surveys","count":76},{"language":"default","tag":"API v2 Reference (Beta)","count":41},{"language":"default","tag":"Upgrade","count":40},{"language":"default","tag":"API v1 Reference","count":36},{"language":"default","tag":"Upgrade by version","count":29},{"language":"default","tag":"Configure","count":28},{"language":"default","tag":"Platform","count":27},{"language":"default","tag":"Development","count":26}]},"assistantConfig":{},"basePath":"/docs","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"self-hosting/upgrade/versions/6.1-single-use-links","slug":"/self-hosting/upgrade/versions/6.1-single-use-links","pageMetadata":{"title":"6.1.0: Single-use links","description":"Detailed actions for the 6.1 upgrade.","icon":"arrow-up-right-dots","href":"/self-hosting/upgrade/versions/6.1-single-use-links"},"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: \"Detailed actions for the 6.1 upgrade.\"\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,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,em:`em`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,..._provideComponents(),...props.components},{CodeBlock,Heading,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Introduced in:`}),` 6.1.0.\n`,_jsx(_components.strong,{children:`Action required:`}),` if you use encrypted single-use survey links issued before 6.1.0.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.a,{href:`/self-hosting/upgrade/versions/6.1`,children:`Back to the 6.1 checklist`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`encrypted-single-use-survey-links-must-be-regenerated-action-required-if-you-use-them`,children:`Encrypted single-use survey links must be regenerated (action required if you use them)`}),`\n`,_jsx(_components.p,{children:`Encrypted single-use survey links issued before 6.1 stop working and have to be regenerated.`}),`\n`,_jsx(Heading,{level:`4`,id:`what-to-do-when-upgrading`,children:`What to do when upgrading`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Regenerate after upgrading, not before.`}),` Links minted by the old version are unsigned whichever\nday you mint them, so regenerating first produces a second batch that the new version rejects exactly\nlike the first.`]}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsx(_components.li,{children:`Plan a maintenance window covering the deploy and the redistribution. Outstanding links stop\nworking the moment the new version serves traffic, and a respondent who opened one before the\ndeploy and submits after it sees the invitation error and loses their answers.`}),`\n`,_jsx(_components.li,{children:`Deploy 6.1 or later.`}),`\n`,_jsxs(_components.li,{children:[`Regenerate the links for any survey with single-use enabled and `,_jsx(_components.strong,{children:`URL encryption of single-use\nID`}),` on, from the survey’s share modal or via\n`,_jsx(_components.code,{children:`GET /api/v1/management/surveys/{surveyId}/singleUseIds`}),`. The new version signs them.`]}),`\n`,_jsx(_components.li,{children:`Re-send. Formbricks never stores generated links, so there is nothing to migrate and nothing to\nback up — the new links simply replace the old ones.`}),`\n`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Links with URL encryption off that already have a valid signature are unaffected`}),`, including signed custom single-use IDs.\nIf coming from v4, first account for the `,_jsx(_components.a,{href:`/self-hosting/upgrade/versions/5.0#single-use-links-and-custom-clients`,children:`v5 signature change`}),`. Those have carried\na `,_jsx(_components.code,{children:`suToken`}),` signature since 5.0 and validate exactly as before, so integrations that mint their own\nIDs need no changes.`]}),`\n`,_jsx(Heading,{level:`4`,id:`what-you-will-see-if-you-skip-it`,children:`What you will see if you skip it`}),`\n`,_jsxs(_components.p,{children:[`Opening an old encrypted link shows `,_jsx(_components.em,{children:`“This survey can only be taken by invitation”`}),`, and submissions\nagainst it are rejected. Server logs record one `,_jsx(_components.code,{children:`warn`}),` per rejection carrying the survey id and a\n`,_jsx(_components.code,{children:`reason`}),` of `,_jsx(_components.code,{children:`missing_signature`}),`.`]}),`\n`,_jsx(Heading,{level:`4`,id:`why`,children:`Why`}),`\n`,_jsx(_components.p,{children:`An encrypted single-use link carried only an encrypted id and no signature, so nothing tied it to the\nsurvey it was issued for and any survey on the same deployment accepted it. Both modes now carry the\nsame signature, which is what the old links are missing.`}),`\n`,_jsx(Heading,{level:`4`,id:`if-you-cannot-re-issue-in-time`,children:`If you cannot re-issue in time`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`SINGLE_USE_LEGACY_UNSIGNED_UNTIL`}),` keeps the old links working for a fixed period, so an in-flight\ncampaign does not die on upgrade day. It takes an ISO 8601 date and is unset by default:`]}),`\n`,_jsxs(_components.p,{children:[`Set this on the app service’s environment (Compose) or app Secret/environment bindings (Kubernetes),\nthen recreate/redeploy the app. Replace `,_jsx(_components.code,{children:`YYYY-MM-DD`}),` with your chosen deadline:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`dotenv`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`dotenv`,children:_jsxs(_components.code,{language:`dotenv`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:`SINGLE_USE_LEGACY_UNSIGNED_UNTIL`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`YYYY-MM-DD`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Unsigned `,_jsx(_components.strong,{children:`encrypted`}),` links are accepted until 00:00 UTC on that date, and rejected from then on.\nNothing else changes: links with URL encryption off are untouched, a `,_jsx(_components.code,{children:`suToken`}),` that is present but\nwrong is still rejected, and the id must still decrypt under your `,_jsx(_components.code,{children:`ENCRYPTION_KEY`}),`.`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`This re-opens the vulnerability the release closed, for as long as it is set. An unsigned encrypted\nlink is bound to no survey, so a link issued for one survey opens `,_jsx(_components.strong,{children:`any`}),` survey on the same\ninstance — on a deployment serving more than one organisation, that is across organisations. Set it\nonly on a single-tenant instance, only for as long as re-issuing takes, and only as a deliberate\ndecision. It is not a substitute for step 3 above.`]})}),`\n`,_jsxs(_components.p,{children:[`Each accepted legacy link is logged at `,_jsx(_components.code,{children:`warn`}),` with the survey id and the configured expiry, and\ncounted on `,_jsx(_components.code,{children:`formbricks_survey_single_use_link_validations_total`}),` with `,_jsx(_components.code,{children:`reason=\"legacy_unsigned\"`}),`.\nWatch that series fall to zero, then remove the variable — it tells you when the window has stopped\ncarrying traffic and re-issuing is complete.`]}),`\n`,_jsx(Heading,{level:`4`,id:`rollback`,children:`Rollback`}),`\n`,_jsx(_components.p,{children:`Do not downgrade the application to recover links. Regenerate signed links. An older image reintroduces\nthe vulnerability and may be incompatible with the migrated database.`})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"6.1.0: Single-use links","description":"Detailed actions for the 6.1 upgrade.","icon":"arrow-up-right-dots","href":"/self-hosting/upgrade/versions/6.1-single-use-links"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Encrypted single-use survey links must be regenerated (action required if you use them)","slug":"encrypted-single-use-survey-links-must-be-regenerated-action-required-if-you-use-them","depth":2,"children":[{"title":"What to do when upgrading","slug":"what-to-do-when-upgrading","depth":4,"children":[]},{"title":"What you will see if you skip it","slug":"what-you-will-see-if-you-skip-it","depth":4,"children":[]},{"title":"Why","slug":"why","depth":4,"children":[]},{"title":"If you cannot re-issue in time","slug":"if-you-cannot-re-issue-in-time","depth":4,"children":[]},{"title":"Rollback","slug":"rollback","depth":4,"children":[]}]}],"codeExamples":{}},"jsLinks":["/docs/_mintlify/custom/formbricks/7af300e0bdc69f45/formbricks.js"],"subdomain":"formbricks","siteName":"Documentation - Formbricks","title":"6.1.0: Single-use links - Documentation - Formbricks","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-15T13:34:29.423Z","originalFileLocation":"self-hosting/upgrade/versions/6.1-single-use-links.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=\"Detailed actions for the 6.1 upgrade.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Documentation - Formbricks\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/formbricks/GlZ4IqkvkQlhFmAc/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/docs/mintlify-assets/_mintlify/favicons/formbricks/GlZ4IqkvkQlhFmAc/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/formbricks/GlZ4IqkvkQlhFmAc/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/formbricks/GlZ4IqkvkQlhFmAc/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/formbricks/GlZ4IqkvkQlhFmAc/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/formbricks/GlZ4IqkvkQlhFmAc/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/formbricks/GlZ4IqkvkQlhFmAc/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/formbricks/GlZ4IqkvkQlhFmAc/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/formbricks/GlZ4IqkvkQlhFmAc/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"6.1.0: Single-use links - Documentation - Formbricks\">\u003cmeta data-mint-head property=\"og:description\" content=\"Detailed actions for the 6.1 upgrade.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Documentation - Formbricks\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://formbricks.com/docs/self-hosting/upgrade/versions/6.1-single-use-links\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://formbricks.mintlify.site/docs/_mintlify/api/og/v2?division=6.x\u0026amp;title=6.1.0%3A+Single-use+links\u0026amp;description=Detailed+actions+for+the+6.1+upgrade.\u0026amp;theme=ad31bfbf4dbc0f4212be5b08\u0026amp;signature=bee0527ace9b66504ed70e912cd817233e2d2ed16d2358255c023f3ffe76c0c2\">\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=\"6.1.0: Single-use links - Documentation - Formbricks\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Detailed actions for the 6.1 upgrade.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://formbricks.mintlify.site/docs/_mintlify/api/og/v2?division=6.x\u0026amp;title=6.1.0%3A+Single-use+links\u0026amp;description=Detailed+actions+for+the+6.1+upgrade.\u0026amp;theme=ad31bfbf4dbc0f4212be5b08\u0026amp;signature=bee0527ace9b66504ed70e912cd817233e2d2ed16d2358255c023f3ffe76c0c2\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/docs/mintlify-assets/_mintlify/favicons/formbricks/GlZ4IqkvkQlhFmAc/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Documentation - Formbricks\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#00C4B8\">\u003clink data-mint-head rel=\"canonical\" href=\"https://formbricks.com/docs/self-hosting/upgrade/versions/6.1-single-use-links\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/self-hosting/upgrade/versions/6.1-single-use-links.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://formbricks.com/#organization\",\"name\":\"Documentation - Formbricks\",\"url\":\"https://formbricks.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/formbricks/wqEbm3FT1QK_6-vL/images/logo-light.svg?fit=max\u0026auto=format\u0026n=wqEbm3FT1QK_6-vL\u0026q=85\u0026s=365e5fb767b72b4fbbb2016860fd92ba\"}},{\"@type\":\"WebSite\",\"@id\":\"https://formbricks.com/docs#website\",\"name\":\"Documentation - Formbricks\",\"url\":\"https://formbricks.com/docs\",\"publisher\":{\"@id\":\"https://formbricks.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://formbricks.com/docs/self-hosting/upgrade/versions/6.1-single-use-links#webpage\",\"url\":\"https://formbricks.com/docs/self-hosting/upgrade/versions/6.1-single-use-links\",\"name\":\"6.1.0: Single-use links\",\"description\":\"Detailed actions for the 6.1 upgrade.\",\"dateModified\":\"2026-11-15T13:34:29.423Z\",\"isPartOf\":{\"@id\":\"https://formbricks.com/docs#website\"},\"breadcrumb\":{\"@id\":\"https://formbricks.com/docs/self-hosting/upgrade/versions/6.1-single-use-links#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://formbricks.com/docs/self-hosting/upgrade/versions/6.1-single-use-links#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Upgrade\",\"item\":\"https://formbricks.com/docs/self-hosting/advanced/upgrade\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Upgrade by version\",\"item\":\"https://formbricks.com/docs/self-hosting/advanced/migration\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"6.x\",\"item\":\"https://formbricks.com/docs/self-hosting/upgrade/versions/6.0\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"6.1.0: Single-use links\",\"item\":\"https://formbricks.com/docs/self-hosting/upgrade/versions/6.1-single-use-links\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://formbricks.com/docs/self-hosting/upgrade/versions/6.1-single-use-links#article\",\"headline\":\"6.1.0: Single-use links\",\"name\":\"6.1.0: Single-use links\",\"description\":\"Detailed actions for the 6.1 upgrade.\",\"url\":\"https://formbricks.com/docs/self-hosting/upgrade/versions/6.1-single-use-links\",\"mainEntityOfPage\":{\"@id\":\"https://formbricks.com/docs/self-hosting/upgrade/versions/6.1-single-use-links#webpage\"},\"dateModified\":\"2026-11-15T13:34:29.423Z\",\"publisher\":{\"@id\":\"https://formbricks.com/#organization\"},\"isPartOf\":{\"@id\":\"https://formbricks.com/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Documentation - Formbricks\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Documentation - Formbricks\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/self-hosting/upgrade/versions/6.1-single-use-links.md","siteName":"Documentation - Formbricks","nav":{"global":null,"tabs":[{"tab":"Platform","pages":[{"title":"Platform","href":"/platform/introduction"}]},{"tab":"Surveys (Ask)","pages":[{"title":"Surveys (Ask)","href":"/surveys/overview"}]},{"tab":"Unify Feedback (Analyze)","pages":[{"title":"Unify Feedback (Analyze)","href":"/unify-feedback/overview"}]},{"tab":"Workflows (Act)","pages":[{"title":"Workflows (Act)","href":"/workflows/overview"}]},{"tab":"Self Hosting","groups":[{"group":"Overview","pages":[{"title":"Self-Hosting","icon":"server","href":"/self-hosting/overview"},{"title":"Deployment components","icon":"cubes","href":"/self-hosting/deployment-components"}]},{"group":"Install","pages":[{"title":"Kubernetes Deployment","icon":"circle-nodes","href":"/self-hosting/setup/kubernetes"},{"title":"One-Click Setup","icon":"rocket","href":"/self-hosting/setup/one-click"},{"title":"Docker Setup","icon":"docker","href":"/self-hosting/setup/docker"}]},{"group":"Upgrade","pages":[{"title":"Upgrade Formbricks","icon":"arrow-up-right-dots","href":"/self-hosting/advanced/upgrade"},{"title":"Upgrade paths","icon":"arrow-up-right-dots","href":"/self-hosting/upgrade/paths"},{"group":"Runbooks","pages":[{"title":"Upgrade Kubernetes","icon":"dharmachakra","href":"/self-hosting/upgrade/kubernetes"},{"title":"Upgrade Docker Compose","icon":"docker","href":"/self-hosting/upgrade/docker"},{"title":"Upgrade one-click","icon":"rocket","href":"/self-hosting/upgrade/one-click"},{"title":"Upgrade within 4.x or to 5.x","icon":"arrow-up-right-dots","href":"/self-hosting/upgrade/legacy"}]},{"group":"Upgrade by version","pages":[{"title":"All versions","icon":"arrow-up-right-dots","href":"/self-hosting/advanced/migration"},{"group":"6.x","pages":[{"title":"6.0: Upgrade guide","icon":"arrow-up-right-dots","href":"/self-hosting/upgrade/versions/6.0"},{"title":"6.1: Upgrade guide","icon":"arrow-up-right-dots","href":"/self-hosting/upgrade/versions/6.1"},{"title":"6.1: Runtime changes","description":"Add the Docker Hub worker, refresh Cube models and review Helm changes.","icon":"arrow-up-right-dots","href":"/self-hosting/upgrade/versions/6.1-runtime"},{"title":"6.1.0: Single-use links","icon":"arrow-up-right-dots","href":"/self-hosting/upgrade/versions/6.1-single-use-links"},{"title":"6.1.0: Survey visibility","description":"Run permission commands inside the upgraded app and enable restricted surveys.","icon":"arrow-up-right-dots","href":"/self-hosting/upgrade/versions/6.1-visibility"},{"title":"6.2: Upgrade guide","icon":"arrow-up-right-dots","href":"/self-hosting/upgrade/versions/6.2"},{"title":"6.2: Dashboard viewer role","icon":"chart-line","href":"/self-hosting/upgrade/versions/dashboard-viewer"},{"title":"6.2: Charts and dashboards API","icon":"chart-column","href":"/self-hosting/upgrade/versions/charts-dashboards"},{"title":"6.2: Question codes and the published lock","icon":"lock","href":"/self-hosting/upgrade/versions/question-codes"},{"title":"6.2: Attachment exports and new job queues","icon":"file-zipper","href":"/self-hosting/upgrade/versions/attachment-exports"},{"title":"6.2: Valkey 9 upgrade","icon":"database","href":"/self-hosting/upgrade/versions/valkey-9"},{"title":"6.2: Cube memory and PostgreSQL shared memory","icon":"memory","href":"/self-hosting/upgrade/versions/cube-memory"},{"title":"6.2: Helm connects Cube and the SpiceDB bootstrap to the bundled database","icon":"database","href":"/self-hosting/upgrade/versions/helm-bundled-database"}]},{"group":"5.x","pages":[{"title":"5.0: Upgrade guide","icon":"arrow-up-right-dots","href":"/self-hosting/upgrade/versions/5.0"},{"title":"5.1: Upgrade guide","icon":"arrow-up-right-dots","href":"/self-hosting/upgrade/versions/5.1"},{"title":"5.2: Upgrade guide","icon":"arrow-up-right-dots","href":"/self-hosting/upgrade/versions/5.2"},{"title":"5.3: Upgrade guide","icon":"arrow-up-right-dots","href":"/self-hosting/upgrade/versions/5.3"},{"title":"5.4: Upgrade guide","icon":"arrow-up-right-dots","href":"/self-hosting/upgrade/versions/5.4"},{"title":"5.4.0: Database preparation","icon":"arrow-up-right-dots","href":"/self-hosting/upgrade/versions/5.4-database"},{"title":"5.4: Authentication changes","icon":"arrow-up-right-dots","href":"/self-hosting/upgrade/versions/5.4-authentication"},{"title":"5.4.0: Feedback API permissions","icon":"arrow-up-right-dots","href":"/self-hosting/upgrade/versions/5.4-api-permissions"},{"title":"5.4: Dependency changes","icon":"arrow-up-right-dots","href":"/self-hosting/upgrade/versions/5.4-runtime"}]},{"group":"4.x","pages":[{"title":"4.x: Other upgrade notes","icon":"arrow-up-right-dots","href":"/self-hosting/upgrade/versions/4.x"},{"title":"4.0: Upgrade guide","icon":"arrow-up-right-dots","href":"/self-hosting/upgrade/versions/4.0"},{"title":"4.7: Upgrade guide","icon":"arrow-up-right-dots","href":"/self-hosting/upgrade/versions/4.7"}]},{"group":"Patch releases","pages":[{"title":"5.4.8 / 6.0.5 / 6.1.2: Security updates","icon":"shield-halved","href":"/self-hosting/upgrade/versions/2026-10-27-patches"},{"title":"5.4.7 / 6.0.4 / 6.1.1: Security updates","icon":"shield-halved","href":"/self-hosting/upgrade/versions/2026-10-security-patches"},{"title":"5.4.5 / 6.0.2: Cube image migration","icon":"arrow-up-right-dots","href":"/self-hosting/upgrade/versions/cube"}]}]},{"group":"Reference","pages":[{"title":"Prepare the target configuration","icon":"arrow-up-right-dots","href":"/self-hosting/upgrade/configuration"},{"title":"Prepare permissions","icon":"arrow-up-right-dots","href":"/self-hosting/upgrade/prepare"},{"title":"Rehearse an upgrade","icon":"arrow-up-right-dots","href":"/self-hosting/upgrade/rehearse"},{"title":"One-click updater behavior","icon":"terminal","href":"/self-hosting/upgrade/one-click-details"},{"title":"Troubleshoot an upgrade","icon":"life-ring","href":"/self-hosting/upgrade/troubleshooting"}]}]},{"group":"Configure","pages":[{"title":"Configuration","sidebarTitle":"Overview","icon":"sliders","href":"/self-hosting/configuration"},{"title":"Custom SSL Certificate","icon":"lock","href":"/self-hosting/configuration/custom-ssl"},{"title":"Environment Variables","icon":"code","href":"/self-hosting/configuration/environment-variables"},{"title":"SMTP Configuration","icon":"envelope","href":"/self-hosting/configuration/smtp"},{"title":"File Uploads Configuration","icon":"upload","href":"/self-hosting/configuration/file-uploads"},{"title":"Domain Configuration","icon":"globe","href":"/self-hosting/configuration/domain-configuration"},{"title":"CDN","icon":"globe","href":"/self-hosting/configuration/cdn"},{"title":"Custom Subpath","icon":"link","href":"/self-hosting/configuration/custom-subpath"},{"title":"AI Features","icon":"sparkles","sidebarTitle":"AI Features","href":"/self-hosting/configuration/ai-features"},{"title":"AI timeouts","icon":"clock","href":"/self-hosting/configuration/ai-timeouts"},{"title":"Rate Limiting","icon":"timer","href":"/self-hosting/configuration/rate-limiting"},{"title":"Envoy Gateway","icon":"route","href":"/self-hosting/configuration/envoy"},{"group":"Auth \u0026 SSO","icon":"lock","pages":[{"title":"Authentication Behavior","icon":"user","href":"/self-hosting/auth-behavior"},{"title":"Open ID Connect","icon":"key","href":"/self-hosting/configuration/auth-sso/open-id-connect"},{"title":"Keycloak OIDC","icon":"key-skeleton-left-right","href":"/self-hosting/configuration/auth-sso/keycloak-oidc"},{"title":"Okta OIDC","icon":"fingerprint","href":"/self-hosting/configuration/auth-sso/okta-oidc"},{"title":"Azure AD OAuth","icon":"microsoft","href":"/self-hosting/configuration/auth-sso/azure-ad-oauth"},{"title":"Google OAuth","icon":"google","href":"/self-hosting/configuration/auth-sso/google-oauth"},{"title":"SAML SSO","icon":"user-shield","href":"/self-hosting/configuration/auth-sso/saml-sso"},{"title":"SAML with Identity Providers","icon":"building-lock","href":"/self-hosting/configuration/auth-sso/setup-saml-with-identity-providers"}]},{"group":"Integrations","icon":"bridge","pages":[{"title":"Third-party Integrations (On Premise)","sidebarTitle":"Overview","icon":"bridge","href":"/self-hosting/configuration/integrations"},{"title":"Airtable (On Premise)","icon":"table","href":"/self-hosting/configuration/integrations/airtable"},{"title":"Google Sheets (On Premise)","icon":"file-spreadsheet","href":"/self-hosting/configuration/integrations/google-sheets"},{"title":"Notion (On Premise)","icon":"book","href":"/self-hosting/configuration/integrations/notion"},{"title":"Slack (On Premise)","icon":"slack","href":"/self-hosting/configuration/integrations/slack"}]},{"title":"Deploy optional AI services","icon":"sparkles","href":"/self-hosting/configuration/ai-deployment"},{"title":"Run RustFS with Docker","icon":"database","href":"/self-hosting/configuration/docker-storage"},{"title":"External PostgreSQL for SpiceDB","icon":"database","href":"/self-hosting/configuration/spicedb-external-postgres"}]},{"group":"Operate","pages":[{"title":"Components and ownership","icon":"boxes-stacked","href":"/self-hosting/operate/components"},{"title":"Deployment check","icon":"clipboard-check","href":"/self-hosting/setup/deployment-check"},{"title":"Architecture and scaling","icon":"circle-nodes","href":"/self-hosting/setup/cluster-setup"},{"title":"Monitoring","icon":"magnifying-glass-chart","href":"/self-hosting/setup/monitoring"},{"title":"Job Runner","icon":"gears","href":"/self-hosting/configuration/job-runner"},{"title":"SpiceDB Authorization Operations","icon":"shield-halved","href":"/self-hosting/configuration/authzed-operations"},{"title":"Backup and restore","icon":"database","href":"/self-hosting/operate/backup-restore"},{"title":"Migrating Surveys","icon":"right-left","href":"/self-hosting/advanced/migrating-surveys"},{"title":"Migrating Survey Responses","icon":"database","href":"/self-hosting/advanced/migrating-survey-responses"}]},{"group":"Licensing and support","pages":[{"title":"License","icon":"file-certificate","href":"/self-hosting/advanced/license"},{"title":"License Activation","icon":"key","href":"/self-hosting/advanced/license-activation"},{"title":"Audit Logging","sidebarTitle":"Audit Logging","icon":"file-shield","href":"/self-hosting/advanced/enterprise-features/audit-logging"},{"title":"Release and Maintenance Policy","icon":"calendar-check","href":"/self-hosting/advanced/release-maintenance-policy"}]}]},{"tab":"Development","pages":[{"title":"Development","href":"/development/overview"}]},{"tab":"Integrate","pages":[{"title":"Integrate","href":"/integrate/overview"}]},{"tab":"API v1 Reference","pages":[{"title":"API v1 Reference","href":"/api-reference/rest-api"}]},{"tab":"API v2 Reference (Beta)","pages":[{"title":"API v2 Reference (Beta)","href":"/api-v2-reference/introduction"}]},{"tab":"API v3 Reference (Private Beta)","hidden":true,"pages":[{"title":"API v3 Reference (Private Beta)","href":"/api-v3-reference/introduction"}]}]},"basePath":"","title":"6.1.0: Single-use links - Documentation - Formbricks","buildId":"dpl_Aw98ji4XvBsgtZwL1VrkUF9ehFqz","deploymentId":"dpl_Aw98ji4XvBsgtZwL1VrkUF9ehFqz","dynamics":[],"chunks":[]}