Moves a form into (or out of) a folder for the current user’s own view. Folder
placement is per-user: any direct collaborator on the form (including a
data_viewer) may move it into a folder they manage, independent of their role
on the form itself.
Personal Access Token prefixed with fh_. Sent as Authorization: Bearer fh_xxx.
The scope required by each endpoint is listed in that endpoint's description.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"FormHug","description":"Build smart, beautiful forms for you and your audience.","colors":{"primary":"#6366F1","light":"#818CF8","dark":"#4F46E5"},"logo":{"light":"https://mintcdn.com/formhug-8bc4ebd1/QkuMZ3dKhwrJ6Thy/logo/light.svg?fit=max\u0026auto=format\u0026n=QkuMZ3dKhwrJ6Thy\u0026q=85\u0026s=88284690f11209ca0abb5239bc7f1179","dark":"https://mintcdn.com/formhug-8bc4ebd1/QkuMZ3dKhwrJ6Thy/logo/dark.svg?fit=max\u0026auto=format\u0026n=QkuMZ3dKhwrJ6Thy\u0026q=85\u0026s=18b178b7a4ba46472029621b10203014","href":"https://formhug.ai"},"favicon":{"light":"https://mintcdn.com/formhug-8bc4ebd1/QkuMZ3dKhwrJ6Thy/favicon.svg?fit=max\u0026auto=format\u0026n=QkuMZ3dKhwrJ6Thy\u0026q=85\u0026s=5f2ad4abbddc4fcd7fefb3230c9fb236","dark":"https://mintcdn.com/formhug-8bc4ebd1/QkuMZ3dKhwrJ6Thy/images/favicon-dark.svg?fit=max\u0026auto=format\u0026n=QkuMZ3dKhwrJ6Thy\u0026q=85\u0026s=1c1c281ed3ac1524d0543dd2dfcddb68"},"appearance":{"default":"system"},"background":{"decoration":"gradient"},"navbar":{"links":[{"href":"mailto:support@formhug.ai","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://formhug.ai/?ref=docs"}},"footer":{"socials":{"x":"https://x.com/FormHug","youtube":"https://www.youtube.com/@formhug","instagram":"https://www.instagram.com/formhug","facebook":"https://www.facebook.com/profile.php?id=61586802254413"},"links":[{"header":"General","items":[{"label":"Pricing","href":"https://formhug.ai/pricing"},{"label":"Docs","href":"https://formhug.ai/docs"},{"label":"Blog","href":"https://formhug.ai/blog"},{"label":"Templates","href":"https://formhug.ai/templates"},{"label":"Integrations","href":"https://formhug.ai/integrations"},{"label":"Quizzes","href":"https://formhug.ai/quizzes"}]},{"header":"Product","items":[{"label":"AI Quiz Maker","href":"https://formhug.ai/quiz-maker"},{"label":"MCP for Agents","href":"https://formhug.ai/mcp-for-agents"},{"label":"AI Form Builder","href":"https://formhug.ai/ai-form-builder"},{"label":"AI Survey Maker","href":"https://formhug.ai/survey-maker"},{"label":"ChatGPT Form Builder","href":"https://formhug.ai/chatgpt-form-builder"},{"label":"Claude Form Builder","href":"https://formhug.ai/claude-form-builder"}]},{"header":"Compare","items":[{"label":"Compare All","href":"https://formhug.ai/vs"},{"label":"Jotform Alternative","href":"https://formhug.ai/vs/jotform-alternative"},{"label":"Typeform Alternative","href":"https://formhug.ai/vs/typeform-alternative"},{"label":"Google Forms Alternative","href":"https://formhug.ai/vs/google-forms-alternative"},{"label":"Tally Alternative","href":"https://formhug.ai/vs/tally-alternative"},{"label":"Fillout Alternative","href":"https://formhug.ai/vs/fillout-alternative"}]},{"header":"Resources","items":[{"label":"About","href":"https://formhug.ai/about"},{"label":"Privacy","href":"https://formhug.ai/privacy-policy"},{"label":"Terms","href":"https://formhug.ai/terms-of-service"}]}]},"search":{"prompt":"Search FormHug docs..."},"seo":{"metatags":{"canonical":"https://formhug.ai/docs"},"indexing":"all"},"fonts":{"family":"Inter"},"icons":{"library":"fontawesome"},"integrations":{"ga4":{"measurementId":"G-ZVVSLQ785E"}},"thumbnails":{"appearance":"light"},"interaction":{"drilldown":true},"metadata":{"timestamp":true},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"formhug-8bc4ebd1","hasAudioNarration":false,"actualSubdomain":"formhug-8bc4ebd1","customDomains":["formhug.ai"],"gitSource":{"type":"github","owner":"formhug","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true,"agentFeedback":true},"entitlements":{},"buildId":"6ad6e449807fa967a0983e6d","clientVersion":"0.0.4088","searchFilterCounts":[{"language":"default","tag":"API Reference","count":51},{"language":"default","tag":"Features","count":34},{"language":"default","tag":"Integrations","count":16},{"language":"default","tag":"Builder","count":13},{"language":"default","tag":"Form Settings","count":10},{"language":"default","tag":"Guides","count":10},{"language":"default","tag":"Field Types","count":9},{"language":"default","tag":"Use Cases","count":9},{"language":"default","tag":"Apps \u0026 Automation","count":9},{"language":"default","tag":"Entries","count":9}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"/docs","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","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},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/form-folder/move-a-form-between-folders","slug":"/api-reference/form-folder/move-a-form-between-folders","pageMetadata":{"title":"Move a form between folders","description":"Moves a form into (or out of) a folder for the current user's own view. Folder\nplacement is per-user: any direct collaborator on the form (including a\n`data_viewer`) may move it into a folder they manage, independent of their role\non the form itself.\n\n**Required scope:** `form:write`.\n","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml put /api/v1/forms/{form_token}/folder","href":"/api-reference/form-folder/move-a-form-between-folders","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n strong: \"strong\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsxs(_components.p, {\n children: [\"Moves a form into (or out of) a folder for the current user’s own view. Folder\\nplacement is per-user: any direct collaborator on the form (including a\\n\", _jsx(_components.code, {\n children: \"data_viewer\"\n }), \") may move it into a folder they manage, independent of their role\\non the form itself.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"Required scope:\"\n }), \" \", _jsx(_components.code, {\n children: \"form:write\"\n }), \".\"]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Move a form between folders","description":"Moves a form into (or out of) a folder for the current user's own view. Folder\nplacement is per-user: any direct collaborator on the form (including a\n`data_viewer`) may move it into a folder they manage, independent of their role\non the form itself.\n\n**Required scope:** `form:write`.\n","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml put /api/v1/forms/{form_token}/folder","href":"/api-reference/form-folder/move-a-form-between-folders","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/docs/_mintlify/custom/formhug-8bc4ebd1/4e6b7b0101f2c4d1/external-links.js"],"openApiReferenceData":{"operation":{"summary":"Move a form between folders","tags":["Form Folder"],"description":"Moves a form into (or out of) a folder for the current user's own view. Folder\nplacement is per-user: any direct collaborator on the form (including a\n`data_viewer`) may move it into a folder they manage, independent of their role\non the form itself.\n\n**Required scope:** `form:write`.\n","security":["74ad07f5-db3c-4735-b6d1-e5c1556529e6"],"parameters":[],"responses":{"200":"7103ed39-89eb-4fa3-9503-a7bb8642ce45","403":"305b3ff6-8d22-4800-8597-edb55746018d","404":"0453f2bc-a819-480d-ac74-d7c0a68ed472"},"requestBody":"a563a295-0a6f-42fa-b688-309d2bd4a53a","method":"put","type":"path","servers":["8e8bfda0-f1ef-4ae4-afa9-25e9767fdcdc"],"path":"/api/v1/forms/{form_token}/folder","baseUrlOptions":["https://formhug.ai"],"title":"Move a form between folders","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"5e387bdc-2ff7-461c-ab82-4b31f714d37d":{"name":"form_token","in":"path","description":"Form token","required":true,"schema":{"type":"string","isRequired":true,"description":"Form token","uniqueKey":"","typeLabel":"string"}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","description":"Moves a form into (or out of) a folder for the current user's view. All attributes optional.","properties":{"folder_token":{"type":"string","description":"Target folder token; omit or pass an empty string to move the form to the desktop (root).","uniqueKey":"folder_token","typeLabel":"string"},"original_folder_token":{"type":"string","description":"Original folder token; required to authorize a cross-folder move when the current folder is not managed by the current user.","uniqueKey":"original_folder_token","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"folder_token":"\u003cstring>","original_folder_token":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"7103ed39-89eb-4fa3-9503-a7bb8642ce45":{"description":"Moved to the desktop (folder_token omitted)","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","required":["token","folder"],"properties":{"token":{"type":"string","example":"Wabc12","isRequired":true,"uniqueKey":"data.token","typeLabel":"string"},"folder":{"oneOf":[{"type":"object","required":["token","name"],"properties":{"token":{"type":"string","example":"KaB2c1","isRequired":true,"uniqueKey":"data.folder.oneOf.0.token","typeLabel":"string"},"name":{"type":"string","example":"Work","isRequired":true,"uniqueKey":"data.folder.oneOf.0.name","typeLabel":"string"}},"isRequired":true,"uniqueKey":"data.folder.oneOf.0","typeLabel":"object"},{"type":"null","required":["token","name"],"properties":{"token":{"type":"string","example":"KaB2c1"},"name":{"type":"string","example":"Work"}},"isRequired":true,"uniqueKey":"data.folder.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.folder","typeLabel":"object | null"}},"isRequired":true,"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"data":{"token":"Wabc12","folder":{"token":"KaB2c1","name":"Work"}}}}},"exampleType":"generated"}},"exampleType":"generated"},"305b3ff6-8d22-4800-8597-edb55746018d":{"description":"Current user cannot manage the target folder","content":{"application/json":{"examples":{"forbidden":{"title":"forbidden","value":{"error":"Forbidden"}}},"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Error message","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"exampleType":"examples"}},"exampleType":"examples"},"0453f2bc-a819-480d-ac74-d7c0a68ed472":{"description":"Non-collaborator gets a 404, not 403","content":{"application/json":{"examples":{"not_found":{"title":"not_found","value":{"error":"Form not found"}}},"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Error message","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"74ad07f5-db3c-4735-b6d1-e5c1556529e6":{"PersonalAccessToken":{"type":"http","scheme":"bearer","bearerFormat":"PAT","description":"Personal Access Token prefixed with `fh_`. Sent as `Authorization: Bearer fh_xxx`.\nThe scope required by each endpoint is listed in that endpoint's description.\n","scopes":["form:write"],"schemeName":"PersonalAccessToken"}}},"servers":{"8e8bfda0-f1ef-4ae4-afa9-25e9767fdcdc":{"url":"https://formhug.ai"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"PAT","description":"Personal Access Token prefixed with `fh_`. Sent as `Authorization: Bearer fh_xxx`.\nThe scope required by each endpoint is listed in that endpoint's description.\n","scopes":["form:write"],"schemeName":"PersonalAccessToken"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Personal Access Token prefixed with `fh_`. Sent as `Authorization: Bearer fh_xxx`.\nThe scope required by each endpoint is listed in that endpoint's description.\n","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"PersonalAccessToken","name":"Authorization"}],"title":"PersonalAccessToken"}]},"originalFileLocation":"api-reference/openapi.yaml"},"subdomain":"formhug-8bc4ebd1","siteName":"FormHug","title":"Move a form between folders - FormHug","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"originalFileLocation":"api-reference/form-folder/move-a-form-between-folders.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=\"Moves a form into (or out of) a folder for the current user\u0026#x27;s own view. Folder placement is per-user: any direct collaborator on the form (including a data_viewer) may move it into a folder they manage, independent of their role on the form itself. Required scope: form:write.\">\u003cmeta data-mint-head name=\"application-name\" content=\"FormHug\">\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/formhug-8bc4ebd1/jD1CdRXGDAEeP28F/_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/formhug-8bc4ebd1/jD1CdRXGDAEeP28F/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/formhug-8bc4ebd1/jD1CdRXGDAEeP28F/_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/formhug-8bc4ebd1/jD1CdRXGDAEeP28F/_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/formhug-8bc4ebd1/jD1CdRXGDAEeP28F/_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/formhug-8bc4ebd1/jD1CdRXGDAEeP28F/_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/formhug-8bc4ebd1/jD1CdRXGDAEeP28F/_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/formhug-8bc4ebd1/jD1CdRXGDAEeP28F/_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/formhug-8bc4ebd1/jD1CdRXGDAEeP28F/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Move a form between folders - FormHug\">\u003cmeta data-mint-head property=\"og:description\" content=\"Moves a form into (or out of) a folder for the current user\u0026#x27;s own view. Folder placement is per-user: any direct collaborator on the form (including a data_viewer) may move it into a folder they manage, independent of their role on the form itself. Required scope: form:write.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"FormHug\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://formhug.ai/docs/api-reference/form-folder/move-a-form-between-folders\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://formhug-8bc4ebd1.mintlify.site/docs/_mintlify/api/og/v2?division=Forms\u0026amp;title=Move+a+form+between+folders\u0026amp;description=Moves+a+form+into+%28or+out+of%29+a+folder+for+the+current+user%27s+own+view.+Folder%0Aplacement+is+per-user%3A+any+direct+collaborator+on+the+form+%28including+a%0A%60data_vie\u0026amp;theme=f65d2e66686ae10fbc4af29c\u0026amp;signature=8e0f9dc85ca31f07ebf8222a7d458882ec1ab885f8016e40ab80ab3abba5a7d9\">\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=\"Move a form between folders - FormHug\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Moves a form into (or out of) a folder for the current user\u0026#x27;s own view. Folder placement is per-user: any direct collaborator on the form (including a data_viewer) may move it into a folder they manage, independent of their role on the form itself. Required scope: form:write.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://formhug-8bc4ebd1.mintlify.site/docs/_mintlify/api/og/v2?division=Forms\u0026amp;title=Move+a+form+between+folders\u0026amp;description=Moves+a+form+into+%28or+out+of%29+a+folder+for+the+current+user%27s+own+view.+Folder%0Aplacement+is+per-user%3A+any+direct+collaborator+on+the+form+%28including+a%0A%60data_vie\u0026amp;theme=f65d2e66686ae10fbc4af29c\u0026amp;signature=8e0f9dc85ca31f07ebf8222a7d458882ec1ab885f8016e40ab80ab3abba5a7d9\">\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/formhug-8bc4ebd1/jD1CdRXGDAEeP28F/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"FormHug\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#6366F1\">\u003clink data-mint-head rel=\"canonical\" href=\"https://formhug.ai/docs/api-reference/form-folder/move-a-form-between-folders\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/api-reference/form-folder/move-a-form-between-folders.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://formhug.ai/#organization\",\"name\":\"FormHug\",\"url\":\"https://formhug.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/formhug-8bc4ebd1/QkuMZ3dKhwrJ6Thy/logo/light.svg?fit=max\u0026auto=format\u0026n=QkuMZ3dKhwrJ6Thy\u0026q=85\u0026s=88284690f11209ca0abb5239bc7f1179\"}},{\"@type\":\"WebSite\",\"@id\":\"https://formhug.ai/docs#website\",\"name\":\"FormHug\",\"url\":\"https://formhug.ai/docs\",\"publisher\":{\"@id\":\"https://formhug.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://formhug.ai/docs/api-reference/form-folder/move-a-form-between-folders#webpage\",\"url\":\"https://formhug.ai/docs/api-reference/form-folder/move-a-form-between-folders\",\"name\":\"Move a form between folders\",\"description\":\"Moves a form into (or out of) a folder for the current user's own view. Folder placement is per-user: any direct collaborator on the form (including a data_viewer) may move it into a folder they manage, independent of their role on the form itself. Required scope: form:write.\",\"isPartOf\":{\"@id\":\"https://formhug.ai/docs#website\"},\"breadcrumb\":{\"@id\":\"https://formhug.ai/docs/api-reference/form-folder/move-a-form-between-folders#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://formhug.ai/docs/api-reference/form-folder/move-a-form-between-folders#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Forms\",\"item\":\"https://formhug.ai/docs/api-reference/forms/list-the-current-user-forms\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Move a form between folders\",\"item\":\"https://formhug.ai/docs/api-reference/form-folder/move-a-form-between-folders\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://formhug.ai/docs/api-reference/form-folder/move-a-form-between-folders#apireference\",\"headline\":\"Move a form between folders\",\"name\":\"Move a form between folders\",\"description\":\"Moves a form into (or out of) a folder for the current user's own view. Folder placement is per-user: any direct collaborator on the form (including a data_viewer) may move it into a folder they manage, independent of their role on the form itself. Required scope: form:write.\",\"url\":\"https://formhug.ai/docs/api-reference/form-folder/move-a-form-between-folders\",\"mainEntityOfPage\":{\"@id\":\"https://formhug.ai/docs/api-reference/form-folder/move-a-form-between-folders#webpage\"},\"publisher\":{\"@id\":\"https://formhug.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://formhug.ai/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"FormHug\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"FormHug","nav":{"global":null,"tabs":[{"tab":"Introduction","icon":"book-open","pages":[{"title":"Introduction","href":"/introduction/welcome"}]},{"tab":"Features","icon":"sparkles","pages":[{"title":"Features","href":"/features/building/overview"}]},{"tab":"Integrations","icon":"plug","pages":[{"title":"Integrations","href":"/integrations/overview"}]},{"tab":"Guides","icon":"graduation-cap","pages":[{"title":"Guides","href":"/guides/use-cases/registration-form"}]},{"tab":"API Reference","icon":"code","groups":[{"group":"Overview","pages":[{"title":"API Reference","href":"/api-reference/introduction"},{"title":"Authentication","href":"/api-reference/authentication"},{"group":"Models","expanded":false,"pages":[{"title":"Form Field","href":"/api-reference/models/form-field"}]}]},{"group":"Forms","pages":[{"title":"List the current user forms","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /api/v1/forms","href":"/api-reference/forms/list-the-current-user-forms"},{"title":"Create a form","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /api/v1/forms","href":"/api-reference/forms/create-a-form"},{"title":"Get a form","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /api/v1/forms/{token}","href":"/api-reference/forms/get-a-form"},{"title":"Update a form","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml put /api/v1/forms/{token}","href":"/api-reference/forms/update-a-form"},{"title":"Delete a form","description":"**Required scope:** `form:delete`.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml delete /api/v1/forms/{token}","href":"/api-reference/forms/delete-a-form"},{"title":"Move a form between folders","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml put /api/v1/forms/{form_token}/folder","href":"/api-reference/form-folder/move-a-form-between-folders"}]},{"group":"Form Themes","pages":[{"title":"Get the form theme","description":"**Required scope:** `form:read`.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /api/v1/forms/{form_token}/theme","href":"/api-reference/form-themes/get-the-form-theme"},{"title":"Update the form theme","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml put /api/v1/forms/{form_token}/theme","href":"/api-reference/form-themes/update-the-form-theme"}]},{"group":"Field Rules","pages":[{"title":"Get field rules","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /api/v1/forms/{form_token}/rules","href":"/api-reference/field-rules/get-field-rules"},{"title":"Replace field rules","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml put /api/v1/forms/{form_token}/rules","href":"/api-reference/field-rules/replace-field-rules"}]},{"group":"Form Settings","pages":[{"title":"Get form settings","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /api/v1/forms/{form_token}/settings","href":"/api-reference/form-settings/get-form-settings"},{"title":"Update form settings","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml patch /api/v1/forms/{form_token}/settings","href":"/api-reference/form-settings/update-form-settings"}]},{"group":"Attachments","pages":[{"title":"Prepare a form-element attachment upload","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /api/v1/attachments","href":"/api-reference/attachments/prepare-a-form-element-attachment-upload"},{"title":"Finalize prepared rich-text image uploads","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /api/v1/attachment_commitments","href":"/api-reference/attachments/finalize-prepared-rich-text-image-uploads"},{"title":"Prepare an entry-attachment upload","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /api/v1/f/{form_token}/entry_attachments","href":"/api-reference/entry-attachments/prepare-an-entry-attachment-upload"}]},{"group":"Entries","pages":[{"title":"List entries of a form","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /api/v1/forms/{form_token}/entries","href":"/api-reference/entries/list-entries-of-a-form"},{"title":"Submit an entry","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /api/v1/forms/{form_token}/entries","href":"/api-reference/entries/submit-an-entry"},{"title":"Get an entry","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /api/v1/forms/{form_token}/entries/{serial_number}","href":"/api-reference/entries/get-an-entry"},{"title":"Update an entry","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml patch /api/v1/forms/{form_token}/entries/{serial_number}","href":"/api-reference/entries/update-an-entry"},{"title":"Delete an entry","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml delete /api/v1/forms/{form_token}/entries/{serial_number}","href":"/api-reference/entries/delete-an-entry"},{"title":"Create entries in batch","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /api/v1/forms/{form_token}/entries/batch","href":"/api-reference/entries/create-entries-in-batch"},{"title":"Update entries in batch","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml patch /api/v1/forms/{form_token}/entries/batch","href":"/api-reference/entries/update-entries-in-batch"},{"title":"Delete entries in batch","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml delete /api/v1/forms/{form_token}/entries/batch","href":"/api-reference/entries/delete-entries-in-batch"},{"title":"Get the JSON Schema for writing an entry","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /api/v1/forms/{form_token}/entry_schema","href":"/api-reference/entry-schemas/get-the-json-schema-for-writing-an-entry"}]},{"group":"Folders","pages":[{"title":"List the current user folders","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /api/v1/folders","href":"/api-reference/folders/list-the-current-user-folders"},{"title":"Create a folder","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /api/v1/folders","href":"/api-reference/folders/create-a-folder"},{"title":"Update a folder","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml patch /api/v1/folders/{token}","href":"/api-reference/folders/update-a-folder"},{"title":"Delete a folder","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml delete /api/v1/folders/{token}","href":"/api-reference/folders/delete-a-folder"}]},{"group":"Published Forms","pages":[{"title":"Get a published form's public structure","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /api/v1/f/{form_token}","href":"/api-reference/published-forms/get-a-published-forms-public-structure"}]},{"group":"Published Form Entries","pages":[{"title":"List your entries on a published form","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /api/v1/f/{form_token}/entries","href":"/api-reference/published-form-entries/list-your-entries-on-a-published-form"},{"title":"Submit an entry to a published form","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /api/v1/f/{form_token}/entries","href":"/api-reference/published-form-entries/submit-an-entry-to-a-published-form"},{"title":"Get the JSON Schema for submitting to a published form","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /api/v1/f/{form_token}/entry_schema","href":"/api-reference/entry-schemas/get-the-json-schema-for-submitting-to-a-published-form"},{"title":"Discover candidate entries for a linked_form field","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /api/v1/f/{form_token}/associated_entry_options","href":"/api-reference/linked-form-options/discover-candidate-entries-for-a-linked_form-field"}]},{"group":"Participated Forms","pages":[{"title":"List forms you have participated in","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /api/v1/participated_forms","href":"/api-reference/participated-forms/list-forms-you-have-participated-in"}]},{"group":"Public Queries","pages":[{"title":"List your public queries","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /api/v1/opensearch/queries","href":"/api-reference/public-queries/list-your-public-queries"},{"title":"Create a public query","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /api/v1/opensearch/queries","href":"/api-reference/public-queries/create-a-public-query"},{"title":"Get a public query","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /api/v1/opensearch/queries/{token}","href":"/api-reference/public-queries/get-a-public-query"},{"title":"Update a public query","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml patch /api/v1/opensearch/queries/{token}","href":"/api-reference/public-queries/update-a-public-query"},{"title":"Delete a public query","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml delete /api/v1/opensearch/queries/{token}","href":"/api-reference/public-queries/delete-a-public-query"}]},{"group":"Me","pages":[{"title":"Get current user info","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /api/v1/me","href":"/api-reference/me/get-current-user-info"}]},{"group":"Webhooks","pages":[{"title":"List webhook integrations of a form","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /api/v1/forms/{form_token}/integrations/webhooks","href":"/api-reference/webhooks/list-webhook-integrations-of-a-form"},{"title":"Create a webhook integration","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /api/v1/forms/{form_token}/integrations/webhooks","href":"/api-reference/webhooks/create-a-webhook-integration"},{"title":"Update a webhook integration","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml patch /api/v1/forms/{form_token}/integrations/webhooks/{id}","href":"/api-reference/webhooks/update-a-webhook-integration"},{"title":"Delete a webhook integration","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml delete /api/v1/forms/{form_token}/integrations/webhooks/{id}","href":"/api-reference/webhooks/delete-a-webhook-integration"},{"title":"Get a sample payload","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /api/v1/forms/{form_token}/integrations/webhooks/sample_payload","href":"/api-reference/webhooks/get-a-sample-payload"}]},{"group":"OAuth","pages":[{"title":"Start an OAuth authorization request (PKCE)","openapi":"GET /api/v1/oauth/authorize","playground":"none","href":"/api-reference/oauth/authorize"},{"title":"Exchange for access_token","openapi":"POST /api/v1/oauth/token","playground":"none","href":"/api-reference/oauth/token"},{"title":"Revoke an access_token or refresh_token","openapi":"POST /api/v1/oauth/revoke","playground":"none","href":"/api-reference/oauth/revoke"}]}]},{"tab":"Resources","icon":"folder-open","pages":[{"title":"Resources","href":"/resources/help/faq"}]}]},"basePath":"","title":"Move a form between folders - FormHug","buildId":"dpl_6dVqRXFR2Go5vF5RLvAdHuv189oT","deploymentId":"dpl_6dVqRXFR2Go5vF5RLvAdHuv189oT","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-D_7my4bd.js","utils-Cq_itTNA.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-B5KPEvGz.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DBX-JepP.js","snippetPresets-Bsspz-Ge.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-jcs-2nGf.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-Dp53in7F.js","shallow-Dv9eUdUd.js","getApiPlaygroundDisplay-D8cDwNhi.js","CodeSnippet-DkwXLQor.js","CodeSnippets-DcSgKqs5.js","Page-t8ynOKTD.js","getPastedJson-I2RjoApV.js","icon-BIj57rZC.js","MethodPill-CTwLPWXC.js","DuplicateIcon-BJpFwygY.js","createIcon-C7PorfAe.js","DynamicMarkdown-BBht_uEs.js","SectionHeading-YIBwxbzj.js","axios-vUo_bRtp.js","Markdown--YCeFtOs.js","clsx-CrPa459s.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BWxsj3I0.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-fBzVvq7k.js"]}