Start a flow over many input sets and return one task_id. Poll GET /v1/tasks/{task_id}. Results are aligned to inputs: one element per input, in the same order, with null for misses — same contract as POST /v1/enrichments/{id}/bulk-run.
This endpoint is asynchronous. It returns a task_id — poll Get task status to retrieve your results. Task data expires after 24 hours.
Results are aligned to your inputs: the data array has one element per
input, in the same order you submitted them, with null for inputs that
returned no data. So len(data) equals the number of inputs and data[i] is
the result for input i — join results back to inputs by position.
{"docsConfig":{"theme":"aspen","$schema":"https://mintlify.com/docs.json","name":"Databar Docs","colors":{"primary":"#6C5CE7","light":"#A29BFE","dark":"#5A4BD1"},"logo":{"light":"https://mintcdn.com/databar/kfr17W_tEfbrs1P4/logo/light.svg?fit=max\u0026auto=format\u0026n=kfr17W_tEfbrs1P4\u0026q=85\u0026s=38c5d5f2f9c35e46668722b2401d0cc8","dark":"https://mintcdn.com/databar/kfr17W_tEfbrs1P4/logo/dark.svg?fit=max\u0026auto=format\u0026n=kfr17W_tEfbrs1P4\u0026q=85\u0026s=b7015cfb3c09945ab840af1700aa7a49"},"favicon":{"light":"https://mintcdn.com/databar/QEpagu1P8NAlDFi0/favicon.svg?fit=max\u0026auto=format\u0026n=QEpagu1P8NAlDFi0\u0026q=85\u0026s=3ae622ccad8727568a8220e4ffd52805","dark":"https://mintcdn.com/databar/QEpagu1P8NAlDFi0/favicon-dark.svg?fit=max\u0026auto=format\u0026n=QEpagu1P8NAlDFi0\u0026q=85\u0026s=f524b7b27a8f663d25009c2d9fdcc6f6"},"appearance":{"default":"system"},"background":{"decoration":"windows"},"navbar":{"links":[{"href":"mailto:info@databar.ai","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://databar.ai/tables"}},"footer":{"socials":{"x":"https://x.com/databar_ai","linkedin":"https://linkedin.com/company/databar-ai","youtube":"https://www.youtube.com/@databar_ai"}},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Databar.ai","icon":"globe","href":"https://databar.ai"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"databar","hasAudioNarration":false,"actualSubdomain":"databar","customDomains":["docs.databar.ai"],"gitSource":{"type":"github","owner":"databar-ai","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6acfc696f47325ebaa01948f","collectionId":"03ad6e18-5494-425a-b5bb-95f335782981","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6acfc696f47325ebaa01948f"},"entitlements":{},"buildId":"6acfc696f47325ebaa01948f","clientVersion":"0.0.3965","searchFilterCounts":[{"language":"default","tag":"API Reference","count":85},{"language":"default","tag":"Tables","count":41},{"language":"default","tag":"Product Guide","count":33},{"language":"default","tag":"Headless","count":27},{"language":"default","tag":"Core concepts","count":22},{"language":"default","tag":"Flows","count":14},{"language":"default","tag":"Workspace","count":13},{"language":"default","tag":"Enrichments","count":13},{"language":"default","tag":"Workbooks","count":11},{"language":"default","tag":"MCP Server","count":8}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[],"isAtlas":false,"googleFontsInlined":false},"customCss":[{"filePath":"custom.css","content":"[class*=CardGroup] img,[class*=card-group] img{aspect-ratio:16/10;object-fit:contain;width:100%;border-radius:12px 12px 0 0;padding:24px;background-color:#fafafa;background-image:linear-gradient(rgba(108,92,231,.06) 1px,transparent 1px),linear-gradient(90deg,rgba(108,92,231,.06) 1px,transparent 1px);background-size:20px 20px;border:1px solid rgba(108,92,231,.08)}.dark img[src*=\"icon-chrome.svg\"],.dark img[src*=\"icon-n8n.svg\"],.dark img[src*=\"mcp.svg\"]{filter:brightness(0) invert(1)}.card a,[class*=Card] a{transition:transform 300ms cubic-bezier(0,0,.2,1),box-shadow 300ms ease}.card a:hover,[class*=Card] a:hover{transform:translateY(-4px);box-shadow:0 8px 24px rgba(0,0,0,.08)}"}],"page":{"pagePath":"api-reference/endpoint/flows-bulk-run","slug":"/api-reference/endpoint/flows-bulk-run","pageMetadata":{"title":"Run a flow in bulk","openapi":"POST /v1/flows/{flow_id}/bulk-run","description":"Start a flow over many input sets and return one `task_id`. Poll `GET /v1/tasks/{task_id}`. Results are aligned to `inputs`: one element per input, in the same order, with `null` for misses — same contract as `POST /v1/enrichments/{id}/bulk-run`.","href":"/api-reference/endpoint/flows-bulk-run"},"description":{"compiledSource":"\"use strict\";\nconst {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(_components.p, {\n children: [\"Start a flow over many input sets and return one \", _jsx(_components.code, {\n children: \"task_id\"\n }), \". Poll \", _jsx(_components.code, {\n children: \"GET /v1/tasks/{task_id}\"\n }), \". Results are aligned to \", _jsx(_components.code, {\n children: \"inputs\"\n }), \": one element per input, in the same order, with \", _jsx(_components.code, {\n children: \"null\"\n }), \" for misses — same contract as \", _jsx(_components.code, {\n children: \"POST /v1/enrichments/{id}/bulk-run\"\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,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,strong:`strong`,..._provideComponents(),...props.components},{Info,Warning}=_components;if(!Info)_missingMdxReference(`Info`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Warning,{children:_jsxs(_components.p,{children:[`This endpoint is `,_jsx(_components.strong,{children:`asynchronous`}),`. It returns a `,_jsx(_components.code,{children:`task_id`}),` — poll `,_jsx(_components.a,{href:`/api-reference/endpoint/tasks-get-status`,children:`Get task status`}),` to retrieve your results. Task data expires after `,_jsx(_components.strong,{children:`24 hours`}),`.`]})}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[`Results are `,_jsx(_components.strong,{children:`aligned to your inputs`}),`: the `,_jsx(_components.code,{children:`data`}),` array has one element per\ninput, in the same order you submitted them, with `,_jsx(_components.code,{children:`null`}),` for inputs that\nreturned no data. So `,_jsx(_components.code,{children:`len(data)`}),` equals the number of inputs and `,_jsx(_components.code,{children:`data[i]`}),` is\nthe result for input `,_jsx(_components.code,{children:`i`}),` — join results back to inputs by position.`]})})]})}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":"Run a flow in bulk","openapi":"POST /v1/flows/{flow_id}/bulk-run","description":"Start a flow over many input sets and return one `task_id`. Poll `GET /v1/tasks/{task_id}`. Results are aligned to `inputs`: one element per input, in the same order, with `null` for misses — same contract as `POST /v1/enrichments/{id}/bulk-run`.","href":"/api-reference/endpoint/flows-bulk-run"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Flows"],"summary":"Bulk run a flow","description":"Start a flow over many input sets and return one `task_id`. Poll `GET /v1/tasks/{task_id}`. Results are aligned to `inputs`: one element per input, in the same order, with `null` for misses — same contract as `POST /v1/enrichments/{id}/bulk-run`.","operationId":"bulk_run_flow_v1_flows__flow_id__bulk_run_post","parameters":["22ea0dc1-cfe5-42c0-8a95-2968e3ddea17","b396d157-b635-431f-a212-87145e596b86"],"requestBody":"cb618f43-1792-4ab1-9f57-cb26b5c4eff7","responses":{"200":"74a1f3ef-94da-406f-850c-7f82144c3763","403":"5a9ba209-7249-49c1-9100-971dbc1f0061","404":"829144f5-984f-4185-b206-675dcd614ba9","422":"af0644bf-e30f-4c08-b971-6da069462ac3"},"method":"post","type":"path","servers":["86469929-6288-4c31-b970-e55a9b519145"],"security":[],"path":"/v1/flows/{flow_id}/bulk-run","baseUrlOptions":["https://api.databar.ai"],"title":"Bulk run a flow","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"22ea0dc1-cfe5-42c0-8a95-2968e3ddea17":{"name":"flow_id","in":"path","required":true,"schema":{"type":"string","title":"Flow ID","isRequired":true,"description":"Flow identifier, e.g. `fl_ab12cd34`","uniqueKey":"","typeLabel":"string"},"description":"Flow identifier, e.g. `fl_ab12cd34`"},"b396d157-b635-431f-a212-87145e596b86":{"name":"x-apikey","in":"header","required":true,"schema":{"type":"string","title":"API Key","description":"API Key for authentication","isRequired":true,"uniqueKey":"","typeLabel":"string"},"description":"API Key for authentication"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"inputs":{"type":"array","items":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"inputs.items.[INDEX].additionalProperties","typeLabel":"string"},"uniqueKey":"inputs.items.[INDEX]","typeLabel":"object"},"minItems":1,"title":"Inputs","description":"One input set per record, in the order you want results back. Each object maps flow input id → value string, same shape as `POST /flows/{id}/run`.","isRequired":true,"uniqueKey":"inputs","typeLabel":"Inputs · object[]"}},"type":"object","required":["inputs"],"title":"BulkRunFlowIn","uniqueKey":"","typeLabel":"BulkRunFlowIn · object"},"example":{"inputs":[{"domain":"stripe.com"},{"domain":"databar.ai"}]},"examples":{"Example":{"title":"Example","value":{"inputs":[{"domain":"stripe.com"},{"domain":"databar.ai"}]}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"74a1f3ef-94da-406f-850c-7f82144c3763":{"description":"Task created — poll GET /v1/tasks/{task_id} for results","content":{"application/json":{"schema":{"properties":{"task_id":{"type":"string","title":"Task Id","isRequired":true,"uniqueKey":"task_id","typeLabel":"string"},"status":{"type":"string","title":"Status","isRequired":true,"uniqueKey":"status","typeLabel":"string"}},"type":"object","required":["task_id","status"],"title":"Task","uniqueKey":"","typeLabel":"Task · object"},"example":{"task_id":"a1b2c3d4-e5f6-7890-abcd-ef1234567890","status":"processing"},"examples":{"Example":{"title":"Example","value":{"task_id":"a1b2c3d4-e5f6-7890-abcd-ef1234567890","status":"processing"}}},"exampleType":"examples"}},"exampleType":"examples"},"5a9ba209-7249-49c1-9100-971dbc1f0061":{"description":"Forbidden","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"829144f5-984f-4185-b206-675dcd614ba9":{"description":"Flow not found","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"af0644bf-e30f-4c08-b971-6da069462ac3":{"description":"Validation Error","content":{"application/json":{"schema":{"properties":{"error":{"type":"string","title":"Error","description":"VALIDATION_ERROR","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"detail":{"type":"string","title":"Detail","description":"Human-readable summary, one problem per field joined by '; '.","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"fields":{"type":"array","title":"Fields","items":{"type":"object","properties":{"loc":{"items":{"type":"string","uniqueKey":"fields.items.[INDEX].loc.items.[INDEX]","typeLabel":"string"},"type":"array","isRequired":true,"uniqueKey":"fields.items.[INDEX].loc","typeLabel":"string[]"},"msg":{"type":"string","isRequired":true,"uniqueKey":"fields.items.[INDEX].msg","typeLabel":"string"}},"required":["loc","msg"],"uniqueKey":"fields.items.[INDEX]","typeLabel":"object"},"uniqueKey":"fields","typeLabel":"Fields · object[]"}},"type":"object","required":["error","detail"],"title":"HTTPValidationError","uniqueKey":"","typeLabel":"HTTPValidationError · object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","detail":"\u003cstring>","fields":[{"loc":["\u003cstring>"],"msg":"\u003cstring>"}]}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{},"servers":{"86469929-6288-4c31-b970-e55a9b519145":{"url":"https://api.databar.ai","description":"Production"}}},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"databar","siteName":"Databar Docs","title":"Run a flow in bulk - Databar Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-14T11:51:37.430Z","originalFileLocation":"api-reference/endpoint/flows-bulk-run.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=\"Start a flow over many input sets and return one task_id. Poll GET /v1/tasks/{task_id}. Results are aligned to inputs: one element per input, in the same order, with null for misses — same contract as POST /v1/enrichments/{id}/bulk-run.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Databar Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/databar/UayxQWR1b87G5-jl/_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/databar/UayxQWR1b87G5-jl/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/databar/UayxQWR1b87G5-jl/_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/databar/UayxQWR1b87G5-jl/_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/databar/UayxQWR1b87G5-jl/_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/databar/UayxQWR1b87G5-jl/_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/databar/UayxQWR1b87G5-jl/_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/databar/UayxQWR1b87G5-jl/_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/databar/UayxQWR1b87G5-jl/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Run a flow in bulk - Databar Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Start a flow over many input sets and return one task_id. Poll GET /v1/tasks/{task_id}. Results are aligned to inputs: one element per input, in the same order, with null for misses — same contract as POST /v1/enrichments/{id}/bulk-run.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Databar Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.databar.ai/api-reference/endpoint/flows-bulk-run\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://databar.mintlify.app/_mintlify/api/og/v2?division=Flows\u0026amp;title=Run+a+flow+in+bulk\u0026amp;description=Start+a+flow+over+many+input+sets+and+return+one+%60task_id%60.+Poll+%60GET+%2Fv1%2Ftasks%2F%7Btask_id%7D%60.+Results+are+aligned+to+%60inputs%60%3A+one+element+per+input%2C+in+the+same+\u0026amp;theme=2468acd354f0bec92c22e75f\u0026amp;signature=e0aad7f99dddd72b020194778f3e45f4b4b00627a7d73d2ea899d6134e55cbae\">\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=\"Run a flow in bulk - Databar Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Start a flow over many input sets and return one task_id. Poll GET /v1/tasks/{task_id}. Results are aligned to inputs: one element per input, in the same order, with null for misses — same contract as POST /v1/enrichments/{id}/bulk-run.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://databar.mintlify.app/_mintlify/api/og/v2?division=Flows\u0026amp;title=Run+a+flow+in+bulk\u0026amp;description=Start+a+flow+over+many+input+sets+and+return+one+%60task_id%60.+Poll+%60GET+%2Fv1%2Ftasks%2F%7Btask_id%7D%60.+Results+are+aligned+to+%60inputs%60%3A+one+element+per+input%2C+in+the+same+\u0026amp;theme=2468acd354f0bec92c22e75f\u0026amp;signature=e0aad7f99dddd72b020194778f3e45f4b4b00627a7d73d2ea899d6134e55cbae\">\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/databar/UayxQWR1b87G5-jl/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Databar Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#6C5CE7\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.databar.ai/api-reference/endpoint/flows-bulk-run\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/endpoint/flows-bulk-run.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.databar.ai/#organization\",\"name\":\"Databar Docs\",\"url\":\"https://docs.databar.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/databar/kfr17W_tEfbrs1P4/logo/light.svg?fit=max\u0026auto=format\u0026n=kfr17W_tEfbrs1P4\u0026q=85\u0026s=38c5d5f2f9c35e46668722b2401d0cc8\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.databar.ai#website\",\"name\":\"Databar Docs\",\"url\":\"https://docs.databar.ai\",\"publisher\":{\"@id\":\"https://docs.databar.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.databar.ai/api-reference/endpoint/flows-bulk-run#webpage\",\"url\":\"https://docs.databar.ai/api-reference/endpoint/flows-bulk-run\",\"name\":\"Run a flow in bulk\",\"description\":\"Start a flow over many input sets and return one task_id. Poll GET /v1/tasks/{task_id}. Results are aligned to inputs: one element per input, in the same order, with null for misses — same contract as POST /v1/enrichments/{id}/bulk-run.\",\"dateModified\":\"2026-09-14T11:51:37.430Z\",\"isPartOf\":{\"@id\":\"https://docs.databar.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.databar.ai/api-reference/endpoint/flows-bulk-run#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.databar.ai/api-reference/endpoint/flows-bulk-run#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Headless\",\"item\":\"https://docs.databar.ai/api-reference/endpoint/enrichments-list\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Flows\",\"item\":\"https://docs.databar.ai/api-reference/endpoint/flows-list\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Run a flow in bulk\",\"item\":\"https://docs.databar.ai/api-reference/endpoint/flows-bulk-run\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.databar.ai/api-reference/endpoint/flows-bulk-run#apireference\",\"headline\":\"Run a flow in bulk\",\"name\":\"Run a flow in bulk\",\"description\":\"Start a flow over many input sets and return one task_id. Poll GET /v1/tasks/{task_id}. Results are aligned to inputs: one element per input, in the same order, with null for misses — same contract as POST /v1/enrichments/{id}/bulk-run.\",\"url\":\"https://docs.databar.ai/api-reference/endpoint/flows-bulk-run\",\"mainEntityOfPage\":{\"@id\":\"https://docs.databar.ai/api-reference/endpoint/flows-bulk-run#webpage\"},\"dateModified\":\"2026-09-14T11:51:37.430Z\",\"publisher\":{\"@id\":\"https://docs.databar.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.databar.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Databar Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Databar Docs","nav":{"global":{"anchors":[{"anchor":"Databar.ai","icon":"globe","href":"https://databar.ai"}]},"tabs":[{"tab":"Product Guide","icon":"book-open","pages":[{"title":"Product Guide","href":"/product-guide/what-is-databar"}]},{"tab":"API Reference","icon":"square-terminal","groups":[{"group":"Getting Started","icon":"rocket","pages":[{"title":"Build with Databar","href":"/developer-guides"},{"title":"REST API Quickstart","href":"/quickstart-rest"},{"group":"Use Cases","icon":"lightbulb","pages":[{"title":"Enrich a list of leads","href":"/guides/enrich-leads"},{"title":"Waterfall email finder","href":"/guides/waterfall-email-finder"},{"title":"Table enrichment pipeline","href":"/guides/table-enrichment-pipeline"}]}]},{"group":"Overview","pages":[{"title":"Introduction","href":"/api-reference/introduction"}]},{"group":"SDKs","icon":"terminal","pages":[{"title":"Python SDK","href":"/python-sdk"},{"title":"CLI Reference","href":"/cli"}]},{"group":"Workspace","icon":"folder","pages":[{"group":"Folders","pages":[{"title":"List all folders","openapi":"GET /v1/folders","href":"/api-reference/endpoint/folders-list"},{"title":"Create a folder","openapi":"POST /v1/folders","href":"/api-reference/endpoint/folders-create"},{"title":"Rename a folder","openapi":"PATCH /v1/folders/{folder_id}","href":"/api-reference/endpoint/folders-rename"},{"title":"Delete a folder","openapi":"DELETE /v1/folders/{folder_id}","href":"/api-reference/endpoint/folders-delete"},{"title":"Move a table into or out of a folder","openapi":"POST /v1/folders/move-table","href":"/api-reference/endpoint/folders-move-table"}]},{"group":"Connectors","pages":[{"title":"List custom API connectors","openapi":"GET /v1/connectors/","href":"/api-reference/endpoint/connectors-list"},{"title":"Create a custom API connector","openapi":"POST /v1/connectors/","href":"/api-reference/endpoint/connectors-create"},{"title":"Get custom connector info","openapi":"GET /v1/connectors/{connector_id}","href":"/api-reference/endpoint/connectors-get"},{"title":"Update custom connector","openapi":"PUT /v1/connectors/{connector_id}","href":"/api-reference/endpoint/connectors-update"},{"title":"Delete custom connector","openapi":"DELETE /v1/connectors/{connector_id}","href":"/api-reference/endpoint/connectors-delete"}]}]},{"group":"Workbooks","icon":"files","pages":[{"title":"List workbooks","openapi":"GET /v1/workbooks","href":"/api-reference/endpoint/workbooks-list"},{"title":"Get a workbook","openapi":"GET /v1/workbooks/{workbook_id}","href":"/api-reference/endpoint/workbooks-get"},{"title":"Rename a workbook","openapi":"PATCH /v1/workbooks/{workbook_id}","href":"/api-reference/endpoint/workbooks-rename"},{"title":"Duplicate a workbook","openapi":"POST /v1/workbooks/{workbook_id}/duplicate","href":"/api-reference/endpoint/workbooks-duplicate"},{"title":"Merge workbooks","openapi":"POST /v1/workbooks/merge","href":"/api-reference/endpoint/workbooks-merge"},{"title":"Add a sheet","openapi":"POST /v1/workbooks/{workbook_id}/tables","href":"/api-reference/endpoint/workbooks-add-table"},{"title":"Reorder sheets","openapi":"POST /v1/workbooks/{workbook_id}/tables/reorder","href":"/api-reference/endpoint/workbooks-reorder"},{"title":"Delete a workbook","openapi":"DELETE /v1/workbooks/{workbook_id}","href":"/api-reference/endpoint/workbooks-delete"},{"group":"Trash","pages":[{"title":"List trash","openapi":"GET /v1/trash","href":"/api-reference/endpoint/trash-list"},{"title":"Restore from trash","openapi":"POST /v1/trash/restore","href":"/api-reference/endpoint/trash-restore"},{"title":"Permanently delete from trash","openapi":"POST /v1/trash/delete-forever","href":"/api-reference/endpoint/trash-purge"}]}]},{"group":"Tables","icon":"table","pages":[{"group":"Tables","pages":[{"title":"Create a table","openapi":"POST /v1/table/create","href":"/api-reference/endpoint/tables-create"},{"title":"Get all workspace tables","openapi":"GET /v1/table/","href":"/api-reference/endpoint/tables-list"},{"title":"Rename a table","openapi":"PATCH /v1/table/{table_uuid}","href":"/api-reference/endpoint/tables-rename"},{"title":"Duplicate a table","openapi":"POST /v1/table/duplicate","href":"/api-reference/endpoint/tables-duplicate"},{"title":"Move a table to a workbook","openapi":"POST /v1/table/{table_uuid}/move","href":"/api-reference/endpoint/tables-move"},{"title":"Clear a table","openapi":"POST /v1/table/{table_uuid}/clear","href":"/api-reference/endpoint/tables-clear"},{"title":"Start a table export","openapi":"POST /v1/table/{table_uuid}/export","href":"/api-reference/endpoint/tables-export"},{"title":"Get table export status","openapi":"GET /v1/table/{table_uuid}/export","href":"/api-reference/endpoint/tables-get-export"},{"title":"Delete a table","openapi":"DELETE /v1/table/{table_uuid}","href":"/api-reference/endpoint/tables-delete"}]},{"group":"Columns","pages":[{"title":"Get table columns","openapi":"GET /v1/table/{table_uuid}/columns","href":"/api-reference/endpoint/tables-get-columns"},{"title":"Add a column to a table","openapi":"POST /v1/table/{table_uuid}/columns","href":"/api-reference/endpoint/columns-create"},{"title":"Rename a column","openapi":"PATCH /v1/table/{table_uuid}/columns/{column_id}","href":"/api-reference/endpoint/columns-rename"},{"title":"Reorder a column","openapi":"POST /v1/table/{table_uuid}/columns/{column_id}/reorder","href":"/api-reference/endpoint/columns-reorder"},{"title":"Delete a column from a table","openapi":"DELETE /v1/table/{table_uuid}/columns/{column_id}","href":"/api-reference/endpoint/columns-delete"}]},{"group":"Rows","pages":[{"title":"Get table rows","openapi":"GET /v1/table/{table_uuid}/rows","href":"/api-reference/endpoint/rows-get"},{"title":"Add rows to table","openapi":"api-reference/openapi.json POST /v1/table/{table_uuid}/rows","href":"/api-reference/endpoint/rows-insert"},{"title":"Update rows in table by ID","openapi":"api-reference/openapi.json PATCH /v1/table/{table_uuid}/rows","href":"/api-reference/endpoint/rows-update"},{"title":"Upsert rows by key values","openapi":"api-reference/openapi.json POST /v1/table/{table_uuid}/rows/upsert","href":"/api-reference/endpoint/rows-upsert"},{"title":"Delete duplicate rows","openapi":"POST /v1/table/{table_uuid}/rows/dedupe","href":"/api-reference/endpoint/rows-dedupe"},{"title":"Delete rows from table","openapi":"POST /v1/table/{table_uuid}/rows/delete","href":"/api-reference/endpoint/rows-delete"}]},{"group":"Enrichments","pages":[{"title":"Get enrichments in table","openapi":"GET /v1/table/{table_uuid}/enrichments","href":"/api-reference/endpoint/tables-get-enrichments"},{"title":"Add enrichment to table","openapi":"POST /v1/table/{table_uuid}/add-enrichment","href":"/api-reference/endpoint/tables-add-enrichment"},{"title":"Update an attached enrichment","openapi":"PATCH /v1/table/{table_uuid}/enrichments/{enrichment_id}","href":"/api-reference/endpoint/tables-update-enrichment"},{"title":"Run enrichment in table","openapi":"api-reference/openapi.json POST /v1/table/{table_uuid}/run-enrichment/{enrichment_id}","href":"/api-reference/endpoint/tables-run-enrichment"}]},{"group":"Waterfalls","pages":[{"title":"Get waterfalls in table","openapi":"GET /v1/table/{table_uuid}/waterfalls","href":"/api-reference/endpoint/tables-get-waterfalls"},{"title":"Add waterfall to table","openapi":"POST /v1/table/{table_uuid}/add-waterfall","href":"/api-reference/endpoint/tables-add-waterfall"}]},{"group":"Exporters","pages":[{"title":"Get exporters in table","openapi":"GET /v1/table/{table_uuid}/exporters","href":"/api-reference/endpoint/tables-get-exporters"},{"title":"Add exporter to table","openapi":"POST /v1/table/{table_uuid}/add-exporter","href":"/api-reference/endpoint/tables-add-exporter"}]}]},{"group":"Headless","icon":"bolt","pages":[{"group":"Enrichments","pages":[{"title":"Get available enrichments","openapi":"GET /v1/enrichments/","href":"/api-reference/endpoint/enrichments-list"},{"title":"Get a specific enrichment","openapi":"GET /v1/enrichments/{enrichment_id}","href":"/api-reference/endpoint/enrichments-get"},{"title":"Get choices for a parameter","openapi":"GET /v1/enrichments/{enrichment_id}/params/{param_slug}/choices","href":"/api-reference/endpoint/enrichments-param-choices"},{"title":"Run single enrichment","openapi":"POST /v1/enrichments/{enrichment_id}/run","href":"/api-reference/endpoint/enrichments-run"},{"title":"Run bulk enrichment","openapi":"POST /v1/enrichments/{enrichment_id}/bulk-run","href":"/api-reference/endpoint/enrichments-bulk-run"}]},{"group":"Waterfalls","pages":[{"title":"Get available waterfalls","openapi":"GET /v1/waterfalls/","href":"/api-reference/endpoint/waterfalls-list"},{"title":"Get a specific waterfall","openapi":"GET /v1/waterfalls/{waterfall_identifier}","href":"/api-reference/endpoint/waterfalls-get"},{"title":"Run a waterfall task","openapi":"POST /v1/waterfalls/{waterfall_identifier}/run","href":"/api-reference/endpoint/waterfalls-run"},{"title":"Run bulk waterfall","openapi":"POST /v1/waterfalls/{waterfall_identifier}/bulk-run","href":"/api-reference/endpoint/waterfalls-bulk-run"}]},{"group":"Flows","pages":[{"title":"List workspace flows","openapi":"GET /v1/flows/","href":"/api-reference/endpoint/flows-list"},{"title":"Get a workspace flow","openapi":"GET /v1/flows/{flow_id}","href":"/api-reference/endpoint/flows-get"},{"title":"Create a flow","openapi":"POST /v1/flows/","href":"/api-reference/endpoint/flows-create"},{"title":"Replace a flow","openapi":"PUT /v1/flows/{flow_id}","href":"/api-reference/endpoint/flows-replace"},{"title":"Update flow fields","openapi":"PATCH /v1/flows/{flow_id}","href":"/api-reference/endpoint/flows-update"},{"title":"Apply targeted edits to a flow config","openapi":"PATCH /v1/flows/{flow_id}/config","href":"/api-reference/endpoint/flows-patch-config"},{"title":"Validate a flow config","openapi":"POST /v1/flows/validate-config","href":"/api-reference/endpoint/flows-validate-config"},{"title":"Estimate flow run cost","openapi":"POST /v1/flows/cost-estimate","href":"/api-reference/endpoint/flows-cost-estimate"},{"title":"Delete a flow","openapi":"DELETE /v1/flows/{flow_id}","href":"/api-reference/endpoint/flows-delete"},{"title":"Run a flow","openapi":"POST /v1/flows/{flow_id}/run","description":"Start a flow execution and return a `task_id`. Poll `GET /v1/tasks/{task_id}` to check status and retrieve outputs. Inputs are passed as `{input_id: value}` — use `GET /v1/flows/{flow_id}` to discover the declared inputs.","href":"/api-reference/endpoint/flows-run"},{"title":"Run a flow in bulk","openapi":"POST /v1/flows/{flow_id}/bulk-run","href":"/api-reference/endpoint/flows-bulk-run"},{"title":"List a flow's edit history","openapi":"GET /v1/flows/{flow_id}/versions","description":"Every save of this flow, newest first: what changed, who changed it and from which surface. The first entry is the version the flow is currently on.","href":"/api-reference/endpoint/flows-versions-list"},{"title":"Get one flow version","openapi":"GET /v1/flows/{flow_id}/versions/{number}","href":"/api-reference/endpoint/flows-versions-get"},{"title":"Roll a flow back to an earlier version","openapi":"POST /v1/flows/{flow_id}/versions/{number}/restore","href":"/api-reference/endpoint/flows-versions-restore"}]},{"group":"Tasks","pages":[{"title":"Get task data or status","openapi":"GET /v1/tasks/{task_id}","href":"/api-reference/endpoint/tasks-get-status"},{"title":"Cancel a task","openapi":"POST /v1/tasks/{task_id}/cancel","href":"/api-reference/endpoint/tasks-cancel"}]},{"group":"Exporters","pages":[{"title":"Get available exporters","openapi":"GET /v1/exporters/","href":"/api-reference/endpoint/exporters-list"},{"title":"Get a specific exporter","openapi":"GET /v1/exporters/{exporter_id}","href":"/api-reference/endpoint/exporters-get"}]}]},{"group":"User","icon":"user","pages":[{"title":"Get user info","openapi":"GET /v1/user/me","href":"/api-reference/endpoint/user-me"}]}]},{"tab":"MCP Server","icon":"https://mintlify.s3.us-west-1.amazonaws.com/databar/logo/mcp.svg","pages":[{"title":"MCP Server","href":"/mcp-server"}]}]},"title":"Run a flow in bulk - Databar Docs","buildId":"dpl_849ArpqvBiCczQiT1Y1stNGpbqHT","deploymentId":"dpl_849ArpqvBiCczQiT1Y1stNGpbqHT","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-Bbp7I60D.js","utils-C3RIvJha.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DqD-vLt8.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-B31Loprg.js","snippetPresets-DKpk-b8t.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-Cj65AhOR.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BXtn5gcC.js","shallow-RY2b03Cp.js","getApiPlaygroundDisplay-B0jeiPk3.js","CodeSnippet-CYgBjjwn.js","CodeSnippets-DOngDrYB.js","Page-n7I5XbKb.js","getPastedJson-DRQbJx-T.js","icon-CQiQCicY.js","MethodPill-BKTLdNtu.js","DuplicateIcon-B9jpAdat.js","createIcon-DCddRrXv.js","DynamicMarkdown-a8hUKrw6.js","SectionHeading-eECVV2eH.js","axios-vUo_bRtp.js","Markdown--GF7ZIpf.js","clsx-DZLdJUrt.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-2LoAhjKH.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-Zwc0ZncM.js"]}