{
"error": "User does not have access to environment env123"
}
Management API - Storage
Upload Public File
API endpoint for uploading public files. Uploaded files are public and accessible by anyone. This endpoint requires authentication and enforces a hard limit of 5 MB for all uploads. It accepts a JSON body with fileName, fileType, workspaceId, and optionally allowedFileExtensions to restrict file types. On success, it returns a signed URL for uploading the file to S3.
{"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":"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.1","contentDirectory":"docs","isPrivate":false,"mountPath":"","label":""},"feedback":{"thumbs":true,"issues":true,"edits":true,"agentFeedback":false},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6aec6ba8981b8170d4f1db3c","clientVersion":"0.0.4087","searchFilterCounts":[{"language":"default","tag":"Surveys (Ask)","count":87},{"language":"default","tag":"Survey Features","count":71},{"language":"default","tag":"Self Hosting","count":53},{"language":"default","tag":"API v2 Reference (Beta)","count":41},{"language":"default","tag":"API v1 Reference","count":35},{"language":"default","tag":"Platform","count":28},{"language":"default","tag":"Configuration","count":28},{"language":"default","tag":"Platform Features","count":23},{"language":"default","tag":"Integrations","count":22},{"language":"default","tag":"Development","count":21}]},"assistantConfig":{},"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/management-api--storage/upload-public-file","slug":"/api-reference/management-api--storage/upload-public-file","pageMetadata":{"title":"Upload Public File","description":"API endpoint for uploading public files. Uploaded files are public and accessible by anyone. This endpoint requires authentication and enforces a hard limit of 5 MB for all uploads. It accepts a JSON body with fileName, fileType, workspaceId, and optionally allowedFileExtensions to restrict file types. On success, it returns a signed URL for uploading the file to S3.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/management/storage","href":"/api-reference/management-api--storage/upload-public-file","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: \"API endpoint for uploading public files. Uploaded files are public and accessible by anyone. This endpoint requires authentication and enforces a hard limit of 5 MB for all uploads. It accepts a JSON body with fileName, fileType, workspaceId, and optionally allowedFileExtensions to restrict file types. On success, it returns a signed URL for uploading the file to S3.\"\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":"Upload Public File","description":"API endpoint for uploading public files. Uploaded files are public and accessible by anyone. This endpoint requires authentication and enforces a hard limit of 5 MB for all uploads. It accepts a JSON body with fileName, fileType, workspaceId, and optionally allowedFileExtensions to restrict file types. On success, it returns a signed URL for uploading the file to S3.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/management/storage","href":"/api-reference/management-api--storage/upload-public-file","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/docs/_mintlify/custom/formbricks/fd84136b00b6b9ed/formbricks.js"],"openApiReferenceData":{"operation":{"description":"API endpoint for uploading public files. Uploaded files are public and accessible by anyone. This endpoint requires authentication and enforces a hard limit of 5 MB for all uploads. It accepts a JSON body with fileName, fileType, workspaceId, and optionally allowedFileExtensions to restrict file types. On success, it returns a signed URL for uploading the file to S3.","parameters":["4efeaa6d-2e80-4e8d-aa8a-aacf7f3e87e6"],"requestBody":"5e6bcf05-35f7-43d6-b90e-0e0a41759c16","responses":{"200":"6e0d4564-2520-4b77-ae36-ef55f90948cc","400":"9801583d-e515-4b82-97b7-9618ceaa1f78","401":"f3307e21-3579-488b-b0a4-d67bd7fe7890","403":"02467927-f212-4d4c-b2ce-8461c1628b5f"},"summary":"Upload Public File","tags":["Management API - Storage"],"method":"post","type":"path","servers":["20d74082-57a3-4ac6-b8d2-183fa90842cc"],"security":[],"path":"/api/v1/management/storage","baseUrlOptions":["https://{baseurl}"],"title":"Upload Public File","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"4efeaa6d-2e80-4e8d-aa8a-aacf7f3e87e6":{"example":"{{apiKey}}","in":"header","name":"x-api-key","required":true,"schema":{"type":"string","isRequired":true,"uniqueKey":"","typeLabel":"string"}}},"requestBody":{"content":{"application/json":{"example":{"allowedFileExtensions":["png","jpg","jpeg"],"fileName":"profile.png","fileType":"image/png","workspaceId":"env123"},"schema":{"properties":{"fileName":{"description":"The name of the file to be uploaded.","type":"string","isRequired":true,"uniqueKey":"fileName","typeLabel":"string"},"fileType":{"description":"The MIME type of the file.","type":"string","isRequired":true,"uniqueKey":"fileType","typeLabel":"string"},"workspaceId":{"description":"The ID of the workspace.","type":"string","isRequired":true,"uniqueKey":"workspaceId","typeLabel":"string"},"allowedFileExtensions":{"description":"Optional. List of allowed file extensions.","items":{"enum":["heic","png","jpeg","jpg","webp","ico","pdf","eml","doc","docx","xls","xlsx","ppt","pptx","txt","csv","mp4","mov","avi","mkv","webm","mp3","zip","rar","7z","tar"],"type":"string","uniqueKey":"allowedFileExtensions.items.[INDEX]","typeLabel":"enum\u003cstring>"},"type":"array","uniqueKey":"allowedFileExtensions","typeLabel":"enum\u003cstring>[]"}},"required":["fileName","fileType","workspaceId"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"allowedFileExtensions":["png","jpg","jpeg"],"fileName":"profile.png","fileType":"image/png","workspaceId":"env123"}}},"exampleType":"examples"}},"required":true,"exampleType":"examples"},"responses":{"6e0d4564-2520-4b77-ae36-ef55f90948cc":{"content":{"application/json":{"example":{"data":{"fileUrl":"http://localhost:3000/storage/cm1ubebtj000614kqe4hs3c67/public/profile--fid--abc123.png","presignedFields":{"Policy":"base64EncodedPolicy","X-Amz-Algorithm":"AWS4-HMAC-SHA256","X-Amz-Credential":"your-credential","X-Amz-Date":"20250312T000000Z","X-Amz-Signature":"your-signature","key":"uploads/public/profile--fid--abc123.png"},"signedUrl":"https://s3.example.com/your-bucket","updatedFileName":"profile--fid--abc123.png"}},"schema":{"properties":{"data":{"properties":{"fileUrl":{"description":"URL where the uploaded file can be accessed.","type":"string","uniqueKey":"data.fileUrl","typeLabel":"string"},"presignedFields":{"additionalProperties":{"type":"string","uniqueKey":"data.presignedFields.additionalProperties","typeLabel":"string"},"description":"Form fields to include in the multipart/form-data POST to S3.","type":"object","uniqueKey":"data.presignedFields","typeLabel":"object"},"signedUrl":{"description":"Signed URL for uploading the file to S3.","type":"string","uniqueKey":"data.signedUrl","typeLabel":"string"},"updatedFileName":{"description":"The updated file name after processing.","type":"string","uniqueKey":"data.updatedFileName","typeLabel":"string"}},"type":"object","uniqueKey":"data","typeLabel":"object"}},"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"data":{"fileUrl":"http://localhost:3000/storage/cm1ubebtj000614kqe4hs3c67/public/profile--fid--abc123.png","presignedFields":{"Policy":"base64EncodedPolicy","X-Amz-Algorithm":"AWS4-HMAC-SHA256","X-Amz-Credential":"your-credential","X-Amz-Date":"20250312T000000Z","X-Amz-Signature":"your-signature","key":"uploads/public/profile--fid--abc123.png"},"signedUrl":"https://s3.example.com/your-bucket","updatedFileName":"profile--fid--abc123.png"}}}},"exampleType":"examples"}},"description":"OK - Returns the signed URL, presigned fields, updated file name, and file URL.","exampleType":"examples"},"9801583d-e515-4b82-97b7-9618ceaa1f78":{"content":{"application/json":{"example":{"error":"fileName is required"},"schema":{"properties":{"error":{"description":"Detailed error message.","type":"string","uniqueKey":"error","typeLabel":"string"}},"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"fileName is required"}}},"exampleType":"examples"}},"description":"Bad Request - Missing required fields or invalid file extension.","exampleType":"examples"},"f3307e21-3579-488b-b0a4-d67bd7fe7890":{"content":{"application/json":{"example":{"error":"Not authenticated"},"schema":{"properties":{"error":{"description":"Detailed error message.","type":"string","uniqueKey":"error","typeLabel":"string"}},"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"Not authenticated"}}},"exampleType":"examples"}},"description":"Unauthorized - Authentication failed or user not logged in.","exampleType":"examples"},"02467927-f212-4d4c-b2ce-8461c1628b5f":{"content":{"application/json":{"example":{"error":"User does not have access to environment env123"},"schema":{"properties":{"error":{"description":"Detailed error message.","type":"string","uniqueKey":"error","typeLabel":"string"}},"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"User does not have access to environment env123"}}},"exampleType":"examples"}},"description":"Forbidden - User does not have access to the specified workspace.","exampleType":"examples"}},"security":{},"servers":{"20d74082-57a3-4ac6-b8d2-183fa90842cc":{"url":"https://{baseurl}","variables":{"baseurl":{"default":"app.formbricks.com"}}}}},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"formbricks","siteName":"Documentation - Formbricks","title":"Upload Public File - Documentation - Formbricks","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-20T07:04:40.871Z","originalFileLocation":"api-reference/management-api--storage/upload-public-file.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=\"API endpoint for uploading public files. Uploaded files are public and accessible by anyone. This endpoint requires authentication and enforces a hard limit of 5 MB for all uploads. It accepts a JSON body with fileName, fileType, workspaceId, and optionally allowedFileExtensions to restrict file types. On success, it returns a signed URL for uploading the file to S3.\">\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=\"Upload Public File - Documentation - Formbricks\">\u003cmeta data-mint-head property=\"og:description\" content=\"API endpoint for uploading public files. Uploaded files are public and accessible by anyone. This endpoint requires authentication and enforces a hard limit of 5 MB for all uploads. It accepts a JSON body with fileName, fileType, workspaceId, and optionally allowedFileExtensions to restrict file types. On success, it returns a signed URL for uploading the file to S3.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Documentation - Formbricks\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://formbricks.com/docs/api-reference/management-api--storage/upload-public-file\">\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=Management+API+-+Storage\u0026amp;title=Upload+Public+File\u0026amp;description=API+endpoint+for+uploading+public+files.+Uploaded+files+are+public+and+accessible+by+anyone.+This+endpoint+requires+authentication+and+enforces+a+hard+limit+of+\u0026amp;theme=5f66c2cdb60ad4d135e6b4e5\u0026amp;signature=d45c9497dc03b80f88d28c4c2e17a0c897752771c78acc58f194959838e39881\">\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=\"Upload Public File - Documentation - Formbricks\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"API endpoint for uploading public files. Uploaded files are public and accessible by anyone. This endpoint requires authentication and enforces a hard limit of 5 MB for all uploads. It accepts a JSON body with fileName, fileType, workspaceId, and optionally allowedFileExtensions to restrict file types. On success, it returns a signed URL for uploading the file to S3.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://formbricks.mintlify.site/docs/_mintlify/api/og/v2?division=Management+API+-+Storage\u0026amp;title=Upload+Public+File\u0026amp;description=API+endpoint+for+uploading+public+files.+Uploaded+files+are+public+and+accessible+by+anyone.+This+endpoint+requires+authentication+and+enforces+a+hard+limit+of+\u0026amp;theme=5f66c2cdb60ad4d135e6b4e5\u0026amp;signature=d45c9497dc03b80f88d28c4c2e17a0c897752771c78acc58f194959838e39881\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/docs/mintlify-assets/_mintlify/favicons/formbricks/GlZ4IqkvkQlhFmAc/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Documentation - Formbricks\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#00C4B8\">\u003clink data-mint-head rel=\"canonical\" href=\"https://formbricks.com/docs/api-reference/management-api--storage/upload-public-file\">\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/management-api--storage/upload-public-file.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://formbricks.com/#organization\",\"name\":\"Documentation - Formbricks\",\"url\":\"https://formbricks.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/formbricks/wqEbm3FT1QK_6-vL/images/logo-light.svg?fit=max\u0026auto=format\u0026n=wqEbm3FT1QK_6-vL\u0026q=85\u0026s=365e5fb767b72b4fbbb2016860fd92ba\"}},{\"@type\":\"WebSite\",\"@id\":\"https://formbricks.com/docs#website\",\"name\":\"Documentation - Formbricks\",\"url\":\"https://formbricks.com/docs\",\"publisher\":{\"@id\":\"https://formbricks.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://formbricks.com/docs/api-reference/management-api--storage/upload-public-file#webpage\",\"url\":\"https://formbricks.com/docs/api-reference/management-api--storage/upload-public-file\",\"name\":\"Upload Public File\",\"description\":\"API endpoint for uploading public files. Uploaded files are public and accessible by anyone. This endpoint requires authentication and enforces a hard limit of 5 MB for all uploads. It accepts a JSON body with fileName, fileType, workspaceId, and optionally allowedFileExtensions to restrict file types. On success, it returns a signed URL for uploading the file to S3.\",\"dateModified\":\"2026-10-20T07:04:40.871Z\",\"isPartOf\":{\"@id\":\"https://formbricks.com/docs#website\"},\"breadcrumb\":{\"@id\":\"https://formbricks.com/docs/api-reference/management-api--storage/upload-public-file#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://formbricks.com/docs/api-reference/management-api--storage/upload-public-file#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Documentation - Formbricks\",\"item\":\"https://formbricks.com/docs\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Upload Public File\",\"item\":\"https://formbricks.com/docs/api-reference/management-api--storage/upload-public-file\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://formbricks.com/docs/api-reference/management-api--storage/upload-public-file#apireference\",\"headline\":\"Upload Public File\",\"name\":\"Upload Public File\",\"description\":\"API endpoint for uploading public files. Uploaded files are public and accessible by anyone. This endpoint requires authentication and enforces a hard limit of 5 MB for all uploads. It accepts a JSON body with fileName, fileType, workspaceId, and optionally allowedFileExtensions to restrict file types. On success, it returns a signed URL for uploading the file to S3.\",\"url\":\"https://formbricks.com/docs/api-reference/management-api--storage/upload-public-file\",\"mainEntityOfPage\":{\"@id\":\"https://formbricks.com/docs/api-reference/management-api--storage/upload-public-file#webpage\"},\"dateModified\":\"2026-10-20T07:04:40.871Z\",\"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\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Documentation - Formbricks","nav":{"global":null,"tabs":[{"tab":"Platform","pages":[{"title":"Platform","href":"/platform/introduction"}]},{"tab":"Surveys (Ask)","pages":[{"title":"Surveys (Ask)","href":"/surveys/overview"}]},{"tab":"Unify Feedback (Analyze)","pages":[{"title":"Unify Feedback (Analyze)","href":"/unify-feedback/overview"}]},{"tab":"Workflows (Act)","pages":[{"title":"Workflows (Act)","href":"/workflows/overview"}]},{"tab":"Self Hosting","pages":[{"title":"Self Hosting","href":"/self-hosting/overview"}]},{"tab":"Development","pages":[{"title":"Development","href":"/development/overview"}]},{"tab":"MCP","pages":[{"title":"MCP","href":"/platform/mcp/overview"}]},{"tab":"API v1 Reference","groups":[{"group":"API v1 Documentation","pages":[{"title":"REST API","icon":"code","href":"/api-reference/rest-api"},{"title":"Generate API Key","icon":"key","href":"/api-reference/generate-key"},{"title":"Test API Key","icon":"message-check","href":"/api-reference/test-key"}]},{"group":"Client API - Display","pages":[{"title":"Create Display","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/client/{workspaceId}/displays","href":"/api-reference/client-api--display/create-display"}]},{"group":"Client API - Environment","pages":[{"title":"Get Workspace State","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/client/{workspaceId}/environment","href":"/api-reference/client-api--environment/get-workspace-state"}]},{"group":"Client API - Response","pages":[{"title":"Create Response","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/client/{workspaceId}/responses","href":"/api-reference/client-api--response/create-response"},{"title":"Update Response","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /api/v1/client/{workspaceId}/responses/{responseId}","href":"/api-reference/client-api--response/update-response"}]},{"group":"Client API - User","pages":[{"title":"Create or Identify User","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/client/{workspaceId}/user","href":"/api-reference/client-api--user/create-or-identify-user"}]},{"group":"Management API - Action Class","pages":[{"title":"Get All Action Classes","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/management/action-classes","href":"/api-reference/management-api--action-class/get-all-action-classes"},{"title":"Create Action Class","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/management/action-classes","href":"/api-reference/management-api--action-class/create-action-class"},{"title":"Get Action Class by ID","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/management/action-classes/{actionClassId}","href":"/api-reference/management-api--action-class/get-action-class-by-id"},{"title":"Delete Action Class","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/v1/management/action-classes/{actionClassId}","href":"/api-reference/management-api--action-class/delete-action-class"}]},{"group":"Management API - Contact Attribute Keys","pages":[{"title":"Get All Contact Attribute Keys","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/management/contact-attribute-keys","href":"/api-reference/management-api--contact-attribute-keys/get-all-contact-attribute-keys"},{"title":"Get Contact Attribute Key by ID","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/management/contact-attribute-keys/{contactAttributeKeyId}","href":"/api-reference/management-api--contact-attribute-keys/get-contact-attribute-key-by-id"}]},{"group":"Management API - Contact Attributes","pages":[{"title":"Get All Contact Attributes","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/management/contact-attributes","href":"/api-reference/management-api--contact-attributes/get-all-contact-attributes"}]},{"group":"Management API - Contacts","pages":[{"title":"Get All Contacts","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/management/contacts","href":"/api-reference/management-api--contacts/get-all-contacts"},{"title":"Get Contact by ID","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/management/contacts/{contactId}","href":"/api-reference/management-api--contacts/get-contact-by-id"}]},{"group":"Management API - Me","pages":[{"title":"Me","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/management/me","href":"/api-reference/management-api--me/me"}]},{"group":"Management API - Response","pages":[{"title":"Get Survey Responses","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/management/responses","href":"/api-reference/management-api--response/get-survey-responses"},{"title":"Create Response","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/management/responses","href":"/api-reference/management-api--response/create-response"},{"title":"Get Response by ID","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/management/responses/{responseId}","href":"/api-reference/management-api--response/get-response-by-id"},{"title":"Update Response","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /api/v1/management/responses/{responseId}","href":"/api-reference/management-api--response/update-response"},{"title":"Delete Response","description":"Delete a response with its ID","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/v1/management/responses/{responseId}","href":"/api-reference/management-api--response/delete-response"}]},{"group":"Management API - Storage","pages":[{"title":"Upload Public File","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/management/storage","href":"/api-reference/management-api--storage/upload-public-file"}]},{"group":"Management API - Survey","pages":[{"title":"Get All Surveys","description":"Fetches all existing surveys. Each survey includes both `questions` (the legacy structure) and `blocks` (the newer structure). `questions` is always derived from `blocks` for backwards compatibility, so integrations may read either field.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/management/surveys","href":"/api-reference/management-api--survey/get-all-surveys"},{"title":"Create Survey","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/management/surveys","href":"/api-reference/management-api--survey/create-survey"},{"title":"Get Survey by ID","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/management/surveys/{surveyId}","href":"/api-reference/management-api--survey/get-survey-by-id"},{"title":"Update Survey","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /api/v1/management/surveys/{surveyId}","href":"/api-reference/management-api--survey/update-survey"},{"title":"Delete Survey","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/v1/management/surveys/{surveyId}","href":"/api-reference/management-api--survey/delete-survey"},{"title":"Get SingleUse Links","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/management/surveys/{surveyId}/singleUseIds","href":"/api-reference/management-api--survey/get-singleuse-links"}]},{"group":"Management API - Webhook","pages":[{"title":"Get All Webhooks","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/webhooks","href":"/api-reference/management-api--webhook/get-all-webhooks"},{"title":"Create Webhook","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/webhooks","href":"/api-reference/management-api--webhook/create-webhook"},{"title":"Get Webhook","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/webhooks/{webhookId}","href":"/api-reference/management-api--webhook/get-webhook"},{"title":"Delete Webhook","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/v1/webhooks/{webhookId}","href":"/api-reference/management-api--webhook/delete-webhook"}]},{"group":"Health","pages":[{"title":"Health Check","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /health","href":"/api-reference/health/health-check"}]}]},{"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":"Upload Public File - Documentation - Formbricks","buildId":"dpl_BSPUBxEoKhhK7HzXVDPxdPvWx4xc","deploymentId":"dpl_BSPUBxEoKhhK7HzXVDPxdPvWx4xc","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-Do6EtGSl.js","utils-id4tQ6My.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-Byrixac4.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-nakYa3Zl.js","snippetPresets-Bq-pUS7h.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-CujTC_9K.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-FneVUsVu.js","shallow-DY9WpUCz.js","getApiPlaygroundDisplay-Bz8WpPfA.js","CodeSnippet-DgCuJg4G.js","CodeSnippets-Dub9c4T0.js","Page-CePXnjd1.js","getPastedJson-xdI8y2XB.js","icon--yVw5vkr.js","MethodPill-C47t7MdS.js","DuplicateIcon-BzwJ2LeC.js","createIcon-BzggGy84.js","DynamicMarkdown-AlxJK8VR.js","SectionHeading-CMlwFxdK.js","axios-vUo_bRtp.js","Markdown-BNgNrPsi.js","clsx-apD-Q0Oo.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-qmLwQyWY.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-Dc4qTkWx.js"]}