Prepare an upload for an attachment field. Returns a one-time upload_id
and an upload_url.
Send the file to upload_url with an HTTP PUT: the raw file bytes as the
request body and the Content-Type header set to the value you declared in
content_type (it must match). Use the upload_url exactly as returned.
Then submit the returned upload_id under the attachment field in
field_values when creating the entry — the entry-create endpoint registers
the attachment. No PAT scope required.
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.
Path Parameters
form_token
string
required
Form token
Body
application/json
field_api_code
string
required
api_code of the target attachment field on this form.
Example:
"field_3"
file_name
string
required
Original file name (with extension).
Example:
"design.pdf"
content_type
string
required
MIME type. Must satisfy the field's media_type configuration and not be in the global blacklist (text/html, text/css, text/javascript, application/x-httpd-php).
Example:
"application/pdf"
file_size
integer
required
File size in bytes. Must be ≤ field.max_size * 1MB.
Example:
5242880
dimension_api_code
string
api_code of the matrix/table dimension when the target field is tabular (e.g. file column inside a table field). Omit for non-tabular attachment fields.
Example:
"col_a"
Response
Init for an attachment field inside a table field (tabular)
data
object
required
Prepare-step response for the 2-step entry-attachment upload. Send the file to upload_url with an HTTP PUT: the raw file bytes as the request body and the Content-Type header set to the value you declared in content_type (it must match). Use upload_url exactly as returned. Then submit the upload_id under the matching attachment field in field_values when creating the entry — the entry-create endpoint registers the attachment. upload_id is a self-describing handle (<form_token>.<field_api_code>[.<dimension_api_code>].<random>).
Show child attributes
Was this page helpful?
{"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.4270","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":"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":"site-roles","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":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"api-reference/entry-attachments/prepare-an-entry-attachment-upload","slug":"/api-reference/entry-attachments/prepare-an-entry-attachment-upload","pageMetadata":{"title":"Prepare an entry-attachment upload","description":"Prepare an upload for an `attachment` field. Returns a one-time `upload_id`\nand an `upload_url`.\n\nSend the file to `upload_url` with an HTTP `PUT`: the raw file bytes as the\nrequest body and the `Content-Type` header set to the value you declared in\n`content_type` (it must match). Use the `upload_url` exactly as returned.\n\nThen submit the returned `upload_id` under the attachment field in\n`field_values` when creating the entry — the entry-create endpoint registers\nthe attachment. No PAT scope required.\n","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","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 ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsxs(_components.p, {\n children: [\"Prepare an upload for an \", _jsx(_components.code, {\n children: \"attachment\"\n }), \" field. Returns a one-time \", _jsx(_components.code, {\n children: \"upload_id\"\n }), \"\\nand an \", _jsx(_components.code, {\n children: \"upload_url\"\n }), \".\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Send the file to \", _jsx(_components.code, {\n children: \"upload_url\"\n }), \" with an HTTP \", _jsx(_components.code, {\n children: \"PUT\"\n }), \": the raw file bytes as the\\nrequest body and the \", _jsx(_components.code, {\n children: \"Content-Type\"\n }), \" header set to the value you declared in\\n\", _jsx(_components.code, {\n children: \"content_type\"\n }), \" (it must match). Use the \", _jsx(_components.code, {\n children: \"upload_url\"\n }), \" exactly as returned.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Then submit the returned \", _jsx(_components.code, {\n children: \"upload_id\"\n }), \" under the attachment field in\\n\", _jsx(_components.code, {\n children: \"field_values\"\n }), \" when creating the entry — the entry-create endpoint registers\\nthe attachment. No PAT scope required.\"]\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":"Prepare an entry-attachment upload","description":"Prepare an upload for an `attachment` field. Returns a one-time `upload_id`\nand an `upload_url`.\n\nSend the file to `upload_url` with an HTTP `PUT`: the raw file bytes as the\nrequest body and the `Content-Type` header set to the value you declared in\n`content_type` (it must match). Use the `upload_url` exactly as returned.\n\nThen submit the returned `upload_id` under the attachment field in\n`field_values` when creating the entry — the entry-create endpoint registers\nthe attachment. No PAT scope required.\n","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","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/docs/_mintlify/custom/formhug-8bc4ebd1/4e6b7b0101f2c4d1/external-links.js"],"openApiReferenceData":{"operation":{"summary":"Prepare an entry-attachment upload","tags":["Entry Attachments"],"description":"Prepare an upload for an `attachment` field. Returns a one-time `upload_id`\nand an `upload_url`.\n\nSend the file to `upload_url` with an HTTP `PUT`: the raw file bytes as the\nrequest body and the `Content-Type` header set to the value you declared in\n`content_type` (it must match). Use the `upload_url` exactly as returned.\n\nThen submit the returned `upload_id` under the attachment field in\n`field_values` when creating the entry — the entry-create endpoint registers\nthe attachment. No PAT scope required.\n","security":["c3600f21-4c8a-46c9-9aa4-0ae3880965a9"],"parameters":[],"responses":{"200":"bff85d2e-e616-4377-846c-e502b0382dd5","400":"1afaa8eb-3fbb-413b-ab69-5a33517f7bce","404":"635d8623-f9b7-4e3d-adad-8008ca919026","413":"e91099fe-851c-49ab-a683-d84b3799469c","503":"66c9a981-80c9-4573-89bd-fd3b16b26785"},"requestBody":"e8a03e8f-d3a0-405c-9cb0-50a34d2f492e","method":"post","type":"path","servers":["8e8bfda0-f1ef-4ae4-afa9-25e9767fdcdc"],"path":"/api/v1/f/{form_token}/entry_attachments","baseUrlOptions":["https://formhug.ai"],"title":"Prepare an entry-attachment upload","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"e7c541ed-c7b6-4889-8ca9-aa3b5f8c4083":{"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","required":["field_api_code","file_name","content_type","file_size"],"additionalProperties":false,"properties":{"field_api_code":{"type":"string","description":"api_code of the target `attachment` field on this form.","example":"field_3","isRequired":true,"uniqueKey":"field_api_code","typeLabel":"string"},"file_name":{"type":"string","description":"Original file name (with extension).","example":"design.pdf","isRequired":true,"uniqueKey":"file_name","typeLabel":"string"},"content_type":{"type":"string","description":"MIME type. Must satisfy the field's `media_type` configuration and not be in the global blacklist (text/html, text/css, text/javascript, application/x-httpd-php).","example":"application/pdf","isRequired":true,"uniqueKey":"content_type","typeLabel":"string"},"file_size":{"type":"integer","description":"File size in bytes. Must be ≤ `field.max_size * 1MB`.","example":5242880,"isRequired":true,"uniqueKey":"file_size","typeLabel":"integer"},"dimension_api_code":{"type":"string","description":"api_code of the matrix/table dimension when the target field is tabular (e.g. file column inside a table field). Omit for non-tabular `attachment` fields.","example":"col_a","uniqueKey":"dimension_api_code","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"field_api_code":"field_3","file_name":"design.pdf","content_type":"application/pdf","file_size":5242880,"dimension_api_code":"col_a"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"bff85d2e-e616-4377-846c-e502b0382dd5":{"description":"Init for an `attachment` field inside a `table` field (tabular)","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","required":["upload_id","upload_url","expires_at","field_api_code"],"description":"Prepare-step response for the 2-step entry-attachment upload. Send the file to `upload_url` with an HTTP PUT: the raw file bytes as the request body and the `Content-Type` header set to the value you declared in `content_type` (it must match). Use `upload_url` exactly as returned. Then submit the `upload_id` under the matching attachment field in `field_values` when creating the entry — the entry-create endpoint registers the attachment. `upload_id` is a self-describing handle (`\u003cform_token>.\u003cfield_api_code>[.\u003cdimension_api_code>].\u003crandom>`).","properties":{"upload_id":{"type":"string","description":"One-time id. Submit unchanged under field_values[field_api_code].","isRequired":true,"uniqueKey":"data.upload_id","typeLabel":"string"},"upload_url":{"type":"string","format":"uri","description":"URL to upload the file to with an HTTP PUT (raw file bytes as the body, `Content-Type` matching the declared value). Use it exactly as returned.","isRequired":true,"uniqueKey":"data.upload_url","typeLabel":"string\u003curi>"},"expires_at":{"type":"string","format":"date-time","description":"When the upload credential expires (UTC, ISO 8601).","isRequired":true,"uniqueKey":"data.expires_at","typeLabel":"string\u003cdate-time>"},"field_api_code":{"type":"string","description":"Echo of the target attachment field api_code.","isRequired":true,"uniqueKey":"data.field_api_code","typeLabel":"string"},"dimension_api_code":{"oneOf":[{"type":"string","description":"Echo of the matrix/table dimension api_code (null for non-tabular fields).","uniqueKey":"data.dimension_api_code.oneOf.0","typeLabel":"string"},{"type":"null","description":"Echo of the matrix/table dimension api_code (null for non-tabular fields).","uniqueKey":"data.dimension_api_code.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.dimension_api_code","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"data":{"upload_id":"\u003cstring>","upload_url":"\u003cstring>","expires_at":"2023-11-07T05:31:56Z","field_api_code":"\u003cstring>","dimension_api_code":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"1afaa8eb-3fbb-413b-ab69-5a33517f7bce":{"description":"Content type not allowed by the field's `media_type` configuration","content":{"application/json":{"examples":{"invalid_field_type":{"title":"invalid_field_type","value":{"error":"Field is not an attachment field"}},"bad_mime":{"title":"bad_mime","value":{"error":"Disallowed content type"}},"media_type_mismatch":{"title":"media_type_mismatch","value":{"error":"Content type \"application/pdf\" is not allowed by the field's `media_type` configuration"}}},"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"},"635d8623-f9b7-4e3d-adad-8008ca919026":{"description":"Tabular field but dimension_api_code does not match any dimension","content":{"application/json":{"examples":{"field_not_found":{"title":"field_not_found","value":{"error":"Field 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"},"e91099fe-851c-49ab-a683-d84b3799469c":{"description":"File exceeds field.max_size","content":{"application/json":{"examples":{"too_large":{"title":"too_large","value":{"error":"File too large (field max_size: 20 MB)"}}},"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"},"66c9a981-80c9-4573-89bd-fd3b16b26785":{"description":"Storage backend is not S3/R2 (Qiniu-only deployment)","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Error message","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"c3600f21-4c8a-46c9-9aa4-0ae3880965a9":{"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":[],"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":[],"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":"Prepare an entry-attachment upload - FormHug","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"originalFileLocation":"api-reference/entry-attachments/prepare-an-entry-attachment-upload.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=\"Prepare an upload for an attachment field. Returns a one-time upload_id and an upload_url. Send the file to upload_url with an HTTP PUT: the raw file bytes as the request body and the Content-Type header set to the value you declared in content_type (it must match). Use the upload_url exactly as returned. Then submit the returned upload_id under the attachment field in field_values when creating the entry — the entry-create endpoint registers the attachment. No PAT scope required.\">\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=\"Prepare an entry-attachment upload - FormHug\">\u003cmeta data-mint-head property=\"og:description\" content=\"Prepare an upload for an attachment field. Returns a one-time upload_id and an upload_url. Send the file to upload_url with an HTTP PUT: the raw file bytes as the request body and the Content-Type header set to the value you declared in content_type (it must match). Use the upload_url exactly as returned. Then submit the returned upload_id under the attachment field in field_values when creating the entry — the entry-create endpoint registers the attachment. No PAT scope required.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"FormHug\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://formhug.ai/docs/api-reference/entry-attachments/prepare-an-entry-attachment-upload\">\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=Attachments\u0026amp;title=Prepare+an+entry-attachment+upload\u0026amp;description=Prepare+an+upload+for+an+%60attachment%60+field.+Returns+a+one-time+%60upload_id%60%0Aand+an+%60upload_url%60.%0A%0ASend+the+file+to+%60upload_url%60+with+an+HTTP+%60PUT%60%3A+the+raw+file\u0026amp;theme=b198728a958a76812071320e\u0026amp;signature=7fd044058b8cfc0c25c4b3ba8a13de14f6b26a47ac6e109afd601bce2fb060d6\">\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=\"Prepare an entry-attachment upload - FormHug\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Prepare an upload for an attachment field. Returns a one-time upload_id and an upload_url. Send the file to upload_url with an HTTP PUT: the raw file bytes as the request body and the Content-Type header set to the value you declared in content_type (it must match). Use the upload_url exactly as returned. Then submit the returned upload_id under the attachment field in field_values when creating the entry — the entry-create endpoint registers the attachment. No PAT scope required.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://formhug-8bc4ebd1.mintlify.site/docs/_mintlify/api/og/v2?division=Attachments\u0026amp;title=Prepare+an+entry-attachment+upload\u0026amp;description=Prepare+an+upload+for+an+%60attachment%60+field.+Returns+a+one-time+%60upload_id%60%0Aand+an+%60upload_url%60.%0A%0ASend+the+file+to+%60upload_url%60+with+an+HTTP+%60PUT%60%3A+the+raw+file\u0026amp;theme=b198728a958a76812071320e\u0026amp;signature=7fd044058b8cfc0c25c4b3ba8a13de14f6b26a47ac6e109afd601bce2fb060d6\">\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/entry-attachments/prepare-an-entry-attachment-upload\">\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/entry-attachments/prepare-an-entry-attachment-upload.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/entry-attachments/prepare-an-entry-attachment-upload#webpage\",\"url\":\"https://formhug.ai/docs/api-reference/entry-attachments/prepare-an-entry-attachment-upload\",\"name\":\"Prepare an entry-attachment upload\",\"description\":\"Prepare an upload for an attachment field. Returns a one-time upload_id and an upload_url. Send the file to upload_url with an HTTP PUT: the raw file bytes as the request body and the Content-Type header set to the value you declared in content_type (it must match). Use the upload_url exactly as returned. Then submit the returned upload_id under the attachment field in field_values when creating the entry — the entry-create endpoint registers the attachment. No PAT scope required.\",\"isPartOf\":{\"@id\":\"https://formhug.ai/docs#website\"},\"breadcrumb\":{\"@id\":\"https://formhug.ai/docs/api-reference/entry-attachments/prepare-an-entry-attachment-upload#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://formhug.ai/docs/api-reference/entry-attachments/prepare-an-entry-attachment-upload#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Attachments\",\"item\":\"https://formhug.ai/docs/api-reference/attachments/prepare-a-form-element-attachment-upload\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Prepare an entry-attachment upload\",\"item\":\"https://formhug.ai/docs/api-reference/entry-attachments/prepare-an-entry-attachment-upload\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://formhug.ai/docs/api-reference/entry-attachments/prepare-an-entry-attachment-upload#apireference\",\"headline\":\"Prepare an entry-attachment upload\",\"name\":\"Prepare an entry-attachment upload\",\"description\":\"Prepare an upload for an attachment field. Returns a one-time upload_id and an upload_url. Send the file to upload_url with an HTTP PUT: the raw file bytes as the request body and the Content-Type header set to the value you declared in content_type (it must match). Use the upload_url exactly as returned. Then submit the returned upload_id under the attachment field in field_values when creating the entry — the entry-create endpoint registers the attachment. No PAT scope required.\",\"url\":\"https://formhug.ai/docs/api-reference/entry-attachments/prepare-an-entry-attachment-upload\",\"mainEntityOfPage\":{\"@id\":\"https://formhug.ai/docs/api-reference/entry-attachments/prepare-an-entry-attachment-upload#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\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"FormHug\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/api-reference/entry-attachments/prepare-an-entry-attachment-upload.md","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","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","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","description":"Turn prepared `rich_text_image` uploads into stored images and get back their\npublic `image_url`s, in request order. Call this after PUTting each file to\nits `upload_url` from POST /api/v1/attachments (purpose `rich_text_image`).\n\nAll-or-nothing: if any entry is invalid the whole request fails (422) with a\nper-entry error under `error_details`, and nothing is consumed. Entries that\nwere already processed are remembered, so retrying with the same `upload_ids`\ndoes not create duplicates. Embed the returned `image_url`s into your\nrich-text HTML. No PAT scope required.\n","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","description":"Returns entries of a form owned by the current user, paginated by cursor.\n\nOrder by `serial_number` ascending by default, or pass `sort`. Every form field\nappears as a top-level key on each entry under its `api_code`; the JSON value type\nfollows the field's `type` (see the **Entry** schema).\n\nOptionally filter with `filter`: a URL-encoded JSON array of conditions, all ANDed\ntogether (see the **FilterCondition** schema). `pagination.total` reflects the\nfiltered count.\n\n**Required scope:** `entry:read`.\n","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":"Prepare an entry-attachment upload - FormHug","deploymentId":"dpl_53YqbBPsHdrqSGqXiWPGU7csRVod","buildId":"dpl_53YqbBPsHdrqSGqXiWPGU7csRVod","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-Ku9dSkH0.js","snippetPresets-Cjez4eet.js","utils-BqNa-fnS.js","style-to-object-BY3JEAdk.js","utils-DiE92JCe.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-Bi0DpqVf.js","conditional-requirements-CFM0id0Q.js","cloneDeep-C6xnxscF.js","_Uint8Array-B7g0OYAt.js","isObject-FP1Yky1u.js","ApiExamples-Bf8Ecb5t.js","usePlaygroundInputsStore-BA942cq6.js","shallow-D0sePNkF.js","isEqual-CnnQO8sL.js","CodeSnippets-BTANoy1T.js","CodeSnippet-CTZvgJfu.js","getApiPlaygroundDisplay-BK2o1XYu.js","Page--B9YZ09u.js","DynamicMarkdown-CsgNpZb1.js","SectionHeading-C3K437Dy.js","icon-DlxjjqnB.js","MethodPill-Cr7Ib9nN.js","getPastedJson-DXo3wtHt.js","Check2Icon-ChEI-f_B.js","axios-CsQoIw0U.js","Markdown-CH4mv0N8.js","AssistantPageLink-BHjmqccN.js","dist-DYCPzQwJ.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}