The API validates the form and file signatures, creates the review, and waits for each media upload to be
accepted before responding. Final Cloudinary webhook processing remains asynchronous, so a successful response
normally starts with mediaStatus: "processing". A later media failure does not roll back the review; the
terminal status is partial or failed.
Body parameters
This endpoint uses multipart/form-data encoding. Send all fields as form values, not JSON.
string
required
Product ID.
string
required
1–5.
string
required
Customer display name.
string
required
Customer email.
file
JPEG, PNG, WebP, GIF, MP4, WebM, or QuickTime media. Repeat the key for up to three files, max 50 MB each.
File signatures are validated; a declared type that does not match the bytes returns 400 INVALID_FILE_TYPE
before the review is created. Generic application/octet-stream uploads are accepted only when the bytes identify
one of these supported formats.
string
Review headline.
string
Review body.
string
Order ID for verified purchase.
string
Incentive claim ID.
string
"true" to confirm FTC disclosure.
string
"true" or "false".
string
Free-text pros.
string
Free-text cons.
string
Custom attributes as a JSON-stringified string, e.g., '{"fit":"true_to_size"}'.
Repeat the field for each file. Maximum 50 MB per file.
Maximum array length: 3
Response
Successful response
success
boolean
required
Example:
true
data
object
Was this page helpful?
{"docsConfig":{"$schema":"https://mintlify.com/docs.json","theme":"mint","name":"ReviewFlow","colors":{"primary":"#2563EB","light":"#93C5FD","dark":"#1D4ED8"},"favicon":"https://mintcdn.com/tailoredintelligence/vZpQe7mViSPIPECC/favicon.svg?fit=max\u0026auto=format\u0026n=vZpQe7mViSPIPECC\u0026q=85\u0026s=42312f99ef24f7da61235e7197ec4a11","logo":{"light":"https://mintcdn.com/tailoredintelligence/9r0uWpWaMe8gjFny/logo/light.svg?fit=max\u0026auto=format\u0026n=9r0uWpWaMe8gjFny\u0026q=85\u0026s=188fca1e3853c84839992261944c997f","dark":"https://mintcdn.com/tailoredintelligence/9r0uWpWaMe8gjFny/logo/dark.svg?fit=max\u0026auto=format\u0026n=9r0uWpWaMe8gjFny\u0026q=85\u0026s=0f3aff05b117e35dd5efa500c4f7448a","href":"https://tailoredd.com"},"api":{"openapi":"openapi.yaml","playground":{"display":"interactive"}},"background":{"decoration":null},"navbar":{"links":[{"label":"tailoredd.com","href":"https://tailoredd.com"}],"primary":{"type":"button","label":"Contact Sales","href":"mailto:contact@tailoredd.com"}},"search":{"prompt":"Search endpoints, payloads, and examples..."},"footer":{"socials":{"website":"https://tailoredd.com"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"tailoredintelligence","hasAudioNarration":false,"actualSubdomain":"tailoredintelligence","customDomains":["docs.tailoredd.com"],"gitSource":{"type":"github","owner":"tailoredd","repo":"tailored","deployBranch":"develop","contentDirectory":"docs/reviewflow-docs","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6ae9556fae8d0278471a2b83:success","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"Documentation","count":48},{"language":"default","tag":"API Reference","count":40},{"language":"default","tag":"Reviews","count":12},{"language":"default","tag":"Questions \u0026 Answers","count":4},{"language":"default","tag":"Getting Started","count":4},{"language":"default","tag":"Merchant Config","count":3},{"language":"default","tag":"CSV Export","count":3},{"language":"default","tag":"Incentives","count":3},{"language":"default","tag":"Media","count":3},{"language":"default","tag":"Analytics","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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/reviews/submit-with-media","slug":"/api-reference/reviews/submit-with-media","pageMetadata":{"title":"Submit review with media","description":"Submit a customer review and attach images or videos in a single multipart request, with media processed asynchronously.","openapi":"openapi.yaml POST /reviews/with-media","href":"/api-reference/reviews/submit-with-media"},"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: \"Submit a customer review and attach images or videos in a single multipart request, with media processed asynchronously.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,..._provideComponents(),...props.components},{CodeBlock,Heading,Note,ParamField}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:_jsx(_components.code,{children:`POST {BASE_URL}/reviews/with-media`})}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`The API validates the form and file signatures, creates the review, and waits for each media upload to be\naccepted before responding. Final Cloudinary webhook processing remains asynchronous, so a successful response\nnormally starts with `,_jsx(_components.code,{children:`mediaStatus: \"processing\"`}),`. A later media failure does `,_jsx(_components.strong,{children:`not`}),` roll back the review; the\nterminal status is `,_jsx(_components.code,{children:`partial`}),` or `,_jsx(_components.code,{children:`failed`}),`.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`body-parameters`,children:`Body parameters`}),`\n`,_jsxs(Note,{children:[`This endpoint uses `,_jsx(_components.code,{children:`multipart/form-data`}),` encoding. Send all fields as form values, not JSON.`]}),`\n`,_jsx(ParamField,{body:`productId`,type:`string`,required:true,id:`param-product-id`,children:`Product ID.`}),`\n`,_jsx(ParamField,{body:`rating`,type:`string`,required:true,id:`param-rating`,children:`1–5.`}),`\n`,_jsx(ParamField,{body:`authorName`,type:`string`,required:true,id:`param-author-name`,children:`Customer display name.`}),`\n`,_jsx(ParamField,{body:`authorEmail`,type:`string`,required:true,id:`param-author-email`,children:`Customer email.`}),`\n`,_jsx(ParamField,{body:`file`,type:`file`,id:`param-file`,children:_jsxs(_components.p,{children:[`JPEG, PNG, WebP, GIF, MP4, WebM, or QuickTime media. Repeat the key for up to three files, max 50 MB each.\nFile signatures are validated; a declared type that does not match the bytes returns `,_jsx(_components.code,{children:`400 INVALID_FILE_TYPE`}),`\nbefore the review is created. Generic `,_jsx(_components.code,{children:`application/octet-stream`}),` uploads are accepted only when the bytes identify\none of these supported formats.`]})}),`\n`,_jsx(ParamField,{body:`title`,type:`string`,id:`param-title`,children:`Review headline.`}),`\n`,_jsx(ParamField,{body:`text`,type:`string`,id:`param-text`,children:`Review body.`}),`\n`,_jsx(ParamField,{body:`orderId`,type:`string`,id:`param-order-id`,children:`Order ID for verified purchase.`}),`\n`,_jsx(ParamField,{body:`incentiveClaimId`,type:`string`,id:`param-incentive-claim-id`,children:`Incentive claim ID.`}),`\n`,_jsxs(ParamField,{body:`incentiveConsent`,type:`string`,id:`param-incentive-consent`,children:[_jsx(_components.code,{children:`\"true\"`}),` to confirm FTC disclosure.`]}),`\n`,_jsxs(ParamField,{body:`wouldRecommend`,type:`string`,id:`param-would-recommend`,children:[_jsx(_components.code,{children:`\"true\"`}),` or `,_jsx(_components.code,{children:`\"false\"`}),`.`]}),`\n`,_jsx(ParamField,{body:`pros`,type:`string`,id:`param-pros`,children:`Free-text pros.`}),`\n`,_jsx(ParamField,{body:`cons`,type:`string`,id:`param-cons`,children:`Free-text cons.`}),`\n`,_jsxs(ParamField,{body:`attributes`,type:`string`,id:`param-attributes`,children:[`Custom attributes as a JSON-stringified string, e.g., `,_jsx(_components.code,{children:`'{\"fit\":\"true_to_size\"}'`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`example`,children:`Example`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`6`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`6`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:' \"${'}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`RF_BASE_URL`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`}/reviews/with-media\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"X-Merchant-Id: YOUR_MERCHANT_ID\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"X-API-Key: YOUR_API_KEY\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -F`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"productId=SKU-001\"`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -F`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"rating=5\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -F`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"authorName=Jane Doe\"`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -F`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"authorEmail=jane@example.com\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -F`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"file=@/path/to/photo.jpg\"`})]}),`\n`]})})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Submit review with media","description":"Submit a customer review and attach images or videos in a single multipart request, with media processed asynchronously.","openapi":"openapi.yaml POST /reviews/with-media","href":"/api-reference/reviews/submit-with-media"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Body parameters","slug":"body-parameters","depth":2,"children":[]},{"title":"Example","slug":"example","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/tailoredintelligence/837c131917e90fd5/fix-openapi-structure.js","/_mintlify/custom/tailoredintelligence/dee5e660d560466e/fix-operationids.js"],"openApiReferenceData":{"operation":{"tags":["Reviews \u0026 Ratings"],"summary":"Submit Review With Media (Merchant, one-call)","operationId":"submitReviewWithMedia","description":"Submit a customer review and attach images or videos in a single multipart request, with media processed asynchronously.","requestBody":"37691712-63ca-4f4b-a0e2-2967869dce07","parameters":["d8c8fc71-a9f1-4fe5-8633-8657364f8d75","fbce5bd3-35ff-4139-951e-4b40b0e49409"],"responses":{"200":"22e01d48-b4c4-446d-846e-2ecfa9ac8ff6","400":"8cd483c9-970d-493c-aabc-f91021ac1112"},"method":"post","type":"path","servers":["8dd24f9b-89e0-42ce-8dab-ad296def58dd"],"security":[],"path":"/reviews/with-media","baseUrlOptions":["https://cdn.tailoredd.com/apiV2"],"title":"Submit Review With Media (Merchant, one-call)","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"d8c8fc71-a9f1-4fe5-8633-8657364f8d75":{"name":"X-Merchant-Id","in":"header","schema":{"type":"string","uniqueKey":"","typeLabel":"string"},"example":"your-merchant-id"},"fbce5bd3-35ff-4139-951e-4b40b0e49409":{"name":"X-API-Key","in":"header","schema":{"type":"string","uniqueKey":"","typeLabel":"string"},"example":"tr_your-api-key"}},"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","required":["productId","rating","title","text","authorName","authorEmail"],"properties":{"productId":{"type":"string","isRequired":true,"uniqueKey":"productId","typeLabel":"string"},"rating":{"type":"string","enum":["1","2","3","4","5"],"isRequired":true,"uniqueKey":"rating","typeLabel":"enum\u003cstring>"},"title":{"type":"string","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"text":{"type":"string","isRequired":true,"uniqueKey":"text","typeLabel":"string"},"authorName":{"type":"string","isRequired":true,"uniqueKey":"authorName","typeLabel":"string"},"authorEmail":{"type":"string","format":"email","isRequired":true,"uniqueKey":"authorEmail","typeLabel":"string\u003cemail>"},"orderId":{"type":"string","uniqueKey":"orderId","typeLabel":"string"},"wouldRecommend":{"type":"string","enum":["true","false"],"uniqueKey":"wouldRecommend","typeLabel":"enum\u003cstring>"},"pros":{"type":"string","uniqueKey":"pros","typeLabel":"string"},"cons":{"type":"string","uniqueKey":"cons","typeLabel":"string"},"attributes":{"type":"string","description":"JSON-stringified custom attributes.","uniqueKey":"attributes","typeLabel":"string"},"file":{"type":"array","maxItems":3,"items":{"type":"string","format":"binary","uniqueKey":"file.items.[INDEX]","typeLabel":"file"},"description":"Repeat the field for each file. Maximum 50 MB per file.","uniqueKey":"file","typeLabel":"file[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"productId":"\u003cstring>","title":"\u003cstring>","text":"\u003cstring>","authorName":"\u003cstring>","authorEmail":"jsmith@example.com","orderId":"\u003cstring>","pros":"\u003cstring>","cons":"\u003cstring>","attributes":"\u003cstring>","file":["\u003cstring>"]}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"22e01d48-b4c4-446d-846e-2ecfa9ac8ff6":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"data":{"type":"object","uniqueKey":"data","typeLabel":"object"}},"required":["success"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":true,"data":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"8cd483c9-970d-493c-aabc-f91021ac1112":{"description":"Bad Request / Validation Error, including INVALID_FILE_TYPE","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"error":{"type":"object","properties":{"code":{"type":"string","example":"VALIDATION_ERROR","uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","example":"Rating must be between 1 and 5","uniqueKey":"error.message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["success","error"],"uniqueKey":"","typeLabel":"object"},"examples":{"invalidFileType":{"title":"invalidFileType","summary":"Unsupported or mismatched media bytes","value":{"success":false,"error":{"code":"INVALID_FILE_TYPE","message":"Supported media types are JPEG, PNG, WebP, GIF, MP4, WebM, and QuickTime"}}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{},"servers":{"8dd24f9b-89e0-42ce-8dab-ad296def58dd":{"url":"https://cdn.tailoredd.com/apiV2","description":"Production Gen 2 API front door"}}},"originalFileLocation":"openapi.yaml"},"subdomain":"tailoredintelligence","siteName":"ReviewFlow","title":"Submit review with media - ReviewFlow","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-07-13T22:30:41.251Z","originalFileLocation":"api-reference/reviews/submit-with-media.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=\"Submit a customer review and attach images or videos in a single multipart request, with media processed asynchronously.\">\u003cmeta data-mint-head name=\"application-name\" content=\"ReviewFlow\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/tailoredintelligence/dAPbzmpJj25iFw8-/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/tailoredintelligence/dAPbzmpJj25iFw8-/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/tailoredintelligence/dAPbzmpJj25iFw8-/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/tailoredintelligence/dAPbzmpJj25iFw8-/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/tailoredintelligence/dAPbzmpJj25iFw8-/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/tailoredintelligence/dAPbzmpJj25iFw8-/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/tailoredintelligence/dAPbzmpJj25iFw8-/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/tailoredintelligence/dAPbzmpJj25iFw8-/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/tailoredintelligence/dAPbzmpJj25iFw8-/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Submit review with media - ReviewFlow\">\u003cmeta data-mint-head property=\"og:description\" content=\"Submit a customer review and attach images or videos in a single multipart request, with media processed asynchronously.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"ReviewFlow\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.tailoredd.com/api-reference/reviews/submit-with-media\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://tailoredintelligence.mintlify.site/_mintlify/api/og/v2?division=Reviews\u0026amp;title=Submit+review+with+media\u0026amp;description=Submit+a+customer+review+and+attach+images+or+videos+in+a+single+multipart+request%2C+with+media+processed+asynchronously.\u0026amp;theme=1fff6a741969b1051c132e13\u0026amp;signature=d77f302228fb870555d4ebd9aeccf60521c430aec82edbc027f4bf112a9ae949\">\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=\"Submit review with media - ReviewFlow\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Submit a customer review and attach images or videos in a single multipart request, with media processed asynchronously.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://tailoredintelligence.mintlify.site/_mintlify/api/og/v2?division=Reviews\u0026amp;title=Submit+review+with+media\u0026amp;description=Submit+a+customer+review+and+attach+images+or+videos+in+a+single+multipart+request%2C+with+media+processed+asynchronously.\u0026amp;theme=1fff6a741969b1051c132e13\u0026amp;signature=d77f302228fb870555d4ebd9aeccf60521c430aec82edbc027f4bf112a9ae949\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/tailoredintelligence/dAPbzmpJj25iFw8-/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"ReviewFlow\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2563EB\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.tailoredd.com/api-reference/reviews/submit-with-media\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/reviews/submit-with-media.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.tailoredd.com/#organization\",\"name\":\"ReviewFlow\",\"url\":\"https://docs.tailoredd.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/tailoredintelligence/9r0uWpWaMe8gjFny/logo/light.svg?fit=max\u0026auto=format\u0026n=9r0uWpWaMe8gjFny\u0026q=85\u0026s=188fca1e3853c84839992261944c997f\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.tailoredd.com#website\",\"name\":\"ReviewFlow\",\"url\":\"https://docs.tailoredd.com\",\"publisher\":{\"@id\":\"https://docs.tailoredd.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.tailoredd.com/api-reference/reviews/submit-with-media#webpage\",\"url\":\"https://docs.tailoredd.com/api-reference/reviews/submit-with-media\",\"name\":\"Submit review with media\",\"description\":\"Submit a customer review and attach images or videos in a single multipart request, with media processed asynchronously.\",\"dateModified\":\"2026-07-13T22:30:41.251Z\",\"isPartOf\":{\"@id\":\"https://docs.tailoredd.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.tailoredd.com/api-reference/reviews/submit-with-media#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.tailoredd.com/api-reference/reviews/submit-with-media#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Reviews\",\"item\":\"https://docs.tailoredd.com/api-reference/reviews/batch\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Submit review with media\",\"item\":\"https://docs.tailoredd.com/api-reference/reviews/submit-with-media\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.tailoredd.com/api-reference/reviews/submit-with-media#apireference\",\"headline\":\"Submit review with media\",\"name\":\"Submit review with media\",\"description\":\"Submit a customer review and attach images or videos in a single multipart request, with media processed asynchronously.\",\"url\":\"https://docs.tailoredd.com/api-reference/reviews/submit-with-media\",\"mainEntityOfPage\":{\"@id\":\"https://docs.tailoredd.com/api-reference/reviews/submit-with-media#webpage\"},\"dateModified\":\"2026-07-13T22:30:41.251Z\",\"publisher\":{\"@id\":\"https://docs.tailoredd.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.tailoredd.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"ReviewFlow\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"ReviewFlow\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/reviews/submit-with-media.md","siteName":"ReviewFlow","nav":{"global":null,"anchors":[{"anchor":"Documentation","icon":"book-open","tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/getting-started/introduction"}]},{"tab":"API Reference","groups":[{"group":"API Reference","pages":[{"title":"ReviewFlow REST API overview","href":"/api-reference/overview"}]},{"group":"Reviews","pages":[{"title":"Batch reviews","openapi":"openapi.yaml GET /batch-reviews","href":"/api-reference/reviews/batch"},{"title":"Get product reviews","openapi":"openapi.yaml GET /products/{productId}/reviews","href":"/api-reference/reviews/get-product-reviews"},{"title":"Ratings summary","openapi":"openapi.yaml GET /products/{productId}/ratings","href":"/api-reference/reviews/ratings-summary"},{"title":"Store reviews","openapi":"openapi.yaml GET /store-reviews","href":"/api-reference/reviews/store-reviews"},{"title":"Check if a review exists","openapi":"openapi.yaml GET /reviews/exists","href":"/api-reference/reviews/review-exists"},{"title":"Submit review","description":"Submit a customer review for a product with rating, title, body, and optional verification metadata.","openapi":"openapi.yaml POST /reviews","href":"/api-reference/reviews/submit"},{"title":"Submit review with media","openapi":"openapi.yaml POST /reviews/with-media","href":"/api-reference/reviews/submit-with-media"},{"title":"Mark as helpful","description":"Increment the helpful-vote counter on a review and record the voter for deduplication.","openapi":"openapi.yaml POST /reviews/{reviewId}/helpful","href":"/api-reference/reviews/mark-helpful"},{"title":"All reviews (admin)","openapi":"openapi.yaml GET /reviews","href":"/api-reference/reviews/admin-list"},{"title":"Update review status","openapi":"openapi.yaml PATCH /reviews/{reviewId}/status","href":"/api-reference/reviews/update-status"},{"title":"Flag review","openapi":"openapi.yaml PATCH /reviews/{reviewId}/flag","href":"/api-reference/reviews/flag"},{"title":"Request review update","openapi":"openapi.yaml POST /admin/reviews/{reviewId}/request-update","href":"/api-reference/reviews/request-update"}]},{"group":"Featured Reviews","pages":[{"title":"Get featured reviews","openapi":"openapi.yaml GET /reviews/featured","href":"/api-reference/featured/get-featured"},{"title":"Toggle featured","openapi":"openapi.yaml POST /reviews/{reviewId}/feature","href":"/api-reference/featured/toggle-featured"}]},{"group":"Questions \u0026 Answers","pages":[{"title":"Get product questions","openapi":"openapi.yaml GET /products/{productId}/questions","href":"/api-reference/questions/get-questions"},{"title":"Submit question","openapi":"openapi.yaml POST /products/{productId}/questions","href":"/api-reference/questions/submit-question"},{"title":"Submit answer","openapi":"openapi.yaml POST /questions/{sampleQuestionId}/answers","href":"/api-reference/questions/submit-answer"},{"title":"Moderate question","openapi":"openapi.yaml PATCH /questions/{sampleQuestionId}/moderate","href":"/api-reference/questions/moderate-question"}]},{"group":"Media","pages":[{"title":"Upload signature","openapi":"openapi.yaml POST /cloudinary/signature","href":"/api-reference/media/upload-signature"},{"title":"Get review media","openapi":"openapi.yaml GET /reviews/{reviewId}/media","href":"/api-reference/media/get-media"},{"title":"Delete review media","openapi":"openapi.yaml DELETE /reviews/{reviewId}/media/{cloudinaryPublicId}","href":"/api-reference/media/delete-media"}]},{"group":"Webhooks","pages":[{"title":"Order complete webhook","openapi":"openapi.yaml POST /webhooks/order-complete","href":"/api-reference/webhooks/order-complete"}]},{"group":"Tokens","pages":[{"title":"Validate token","openapi":"openapi.yaml GET /tokens/{sampleToken}/validate","href":"/api-reference/tokens/validate"},{"title":"Revoke token","openapi":"openapi.yaml POST /admin/tokens/{sampleToken}/revoke","href":"/api-reference/tokens/revoke"}]},{"group":"Merchant Config","pages":[{"title":"Widget config","openapi":"openapi.yaml GET /merchants/{merchantId}/widget-config","href":"/api-reference/config/widget-config"},{"title":"List custom attributes","openapi":"openapi.yaml GET /admin/merchants/{merchantId}/custom-attributes","href":"/api-reference/config/list-attributes"},{"title":"Create custom attribute","openapi":"openapi.yaml POST /admin/merchants/{merchantId}/custom-attributes","href":"/api-reference/config/create-attribute"}]},{"group":"Incentives","pages":[{"title":"List incentive claims","openapi":"openapi.yaml GET /admin/incentive-claims","href":"/api-reference/incentives/list-claims"},{"title":"Fulfill claim","openapi":"openapi.yaml POST /admin/incentive-claims/{incentiveClaimId}/fulfill","href":"/api-reference/incentives/fulfill-claim"},{"title":"Claim by order","openapi":"openapi.yaml GET /admin/incentive-claims/by-order/{sampleOrderId}","href":"/api-reference/incentives/claim-by-order"}]},{"group":"Analytics","pages":[{"title":"Analytics dashboard","openapi":"openapi.yaml GET /analytics/dashboard/{merchantId}","href":"/api-reference/analytics/dashboard"},{"title":"Sentiment filter","href":"/api-reference/analytics/sentiment-filter"}]},{"group":"CSV Export","pages":[{"title":"Create export job","openapi":"openapi.yaml POST /admin/export/reviews","href":"/api-reference/export/create"},{"title":"Export status","openapi":"openapi.yaml GET /admin/export/status/{exportJobId}","href":"/api-reference/export/status"},{"title":"Download export","openapi":"openapi.yaml GET /admin/export/download/{exportJobId}","href":"/api-reference/export/download"}]},{"group":"Google Shopping","pages":[{"title":"Google Shopping feed status","openapi":"openapi.yaml GET /merchants/{merchantId}/feeds/google-reviews/status","href":"/api-reference/google-feed/feed-status"},{"title":"Google Shopping XML feed","openapi":"openapi.yaml GET /merchants/{merchantId}/feeds/google-reviews.xml","href":"/api-reference/google-feed/xml-feed"}]},{"group":"Reference","pages":[{"title":"Health check","openapi":"openapi.yaml GET /health","href":"/api-reference/health"}]}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog"}]}]},{"anchor":"Get Access","href":"mailto:contact@tailoredd.com","icon":"envelope"},{"anchor":"tailoredd.com","href":"https://tailoredd.com","icon":"globe"}]},"basePath":"","title":"Submit review with media - ReviewFlow","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CiUHMMOm.js","snippetPresets-BgfXU7Bw.js","utils-DWvOwgy_.js","style-to-object-BY3JEAdk.js","utils-BN7RXSMJ.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-CFw8bq89.js","conditional-requirements-CFM0id0Q.js","cloneDeep-CAwdfOU2.js","_Uint8Array-BJr8e-ZL.js","isObject-FP1Yky1u.js","ApiExamples-XX0UgMZK.js","usePlaygroundInputsStore-DXDFSa1V.js","shallow-CdX5aREi.js","isEqual-CoOaxexF.js","CodeSnippets-Cg2wpzWm.js","CodeSnippet-D_HwgQO_.js","getApiPlaygroundDisplay-CmCoerhe.js","Page-CVJ-f_k1.js","DynamicMarkdown-CQM9Bhbv.js","SectionHeading-DpbrP8nQ.js","icon-BPCgijHy.js","MethodPill-GQ8DuY0c.js","getPastedJson-Cb5mT31m.js","Check2Icon-a7bUI6e8.js","axios-CsQoIw0U.js","Markdown-CX2QY19L.js","AssistantPageLink-CY3bFglh.js","dist-Dl6_zDnT.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}