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.
{"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.3964","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":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","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":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","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":"per-site-search-delta","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":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","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":"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":"byok-sep-25","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":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","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}],"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-run","slug":"/api-reference/endpoint/flows-run","pageMetadata":{"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"},"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 execution and return a \", _jsx(_components.code, {\n children: \"task_id\"\n }), \". Poll \", _jsx(_components.code, {\n children: \"GET /v1/tasks/{task_id}\"\n }), \" to check status and retrieve outputs. Inputs are passed as \", _jsx(_components.code, {\n children: \"{input_id: value}\"\n }), \" — use \", _jsx(_components.code, {\n children: \"GET /v1/flows/{flow_id}\"\n }), \" to discover the declared inputs.\"]\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{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},{Warning}=_components;if(!Warning)_missingMdxReference(`Warning`,true);return _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`}),`.`]})})}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","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"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Flows"],"summary":"Run a flow","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.","operationId":"run_flow_v1_flows__flow_id__run_post","parameters":["85fb475f-e126-441d-9508-3c73361b067f","10366d12-c769-423d-bd50-6e19f72a449a"],"requestBody":"79c5246a-ed91-4aa0-a9e3-01ec6ed2d243","responses":{"200":"7273537b-5202-4a3d-bef2-580bddda58b7","403":"0cee2c65-c057-4eac-b251-c538969f905e","404":"1ac6393f-d43c-44db-94a1-789baaa8aa0c","422":"fbb06571-6e07-47d7-8539-54ef49705eec"},"method":"post","type":"path","servers":["86469929-6288-4c31-b970-e55a9b519145"],"security":[],"path":"/v1/flows/{flow_id}/run","baseUrlOptions":["https://api.databar.ai"],"title":"Run a flow","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"85fb475f-e126-441d-9508-3c73361b067f":{"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`"},"10366d12-c769-423d-bd50-6e19f72a449a":{"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":"object","additionalProperties":{"type":"string","uniqueKey":"inputs.additionalProperties","typeLabel":"string"},"title":"Inputs","description":"Maps flow input id → value string. Use `GET /v1/flows/{flow_id}` to discover the required input ids.","default":{},"uniqueKey":"inputs","typeLabel":"Inputs · object"}},"type":"object","title":"RunFlowIn","uniqueKey":"","typeLabel":"RunFlowIn · object"},"example":{"inputs":{"domain":"stripe.com"}},"examples":{"Example":{"title":"Example","value":{"inputs":{"domain":"stripe.com"}}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"7273537b-5202-4a3d-bef2-580bddda58b7":{"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"},"0cee2c65-c057-4eac-b251-c538969f905e":{"description":"Forbidden","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"1ac6393f-d43c-44db-94a1-789baaa8aa0c":{"description":"Flow not found","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"fbb06571-6e07-47d7-8539-54ef49705eec":{"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 - Databar Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-05-13T10:48:25.114Z","originalFileLocation":"api-reference/endpoint/flows-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 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.\">\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 - Databar Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"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.\">\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-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\u0026amp;description=Start+a+flow+execution+and+return+a+%60task_id%60.+Poll+%60GET+%2Fv1%2Ftasks%2F%7Btask_id%7D%60+to+check+status+and+retrieve+outputs.+Inputs+are+passed+as+%60%7Binput_id%3A+value%7D%60+%E2%80%94+u\u0026amp;theme=2468acd354f0bec92c22e75f\u0026amp;signature=499b81d296f6b52d23f2f9f01d427b5e4cc9370189147bec965133a3b4e69766\">\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 - Databar Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"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.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://databar.mintlify.app/_mintlify/api/og/v2?division=Flows\u0026amp;title=Run+a+flow\u0026amp;description=Start+a+flow+execution+and+return+a+%60task_id%60.+Poll+%60GET+%2Fv1%2Ftasks%2F%7Btask_id%7D%60+to+check+status+and+retrieve+outputs.+Inputs+are+passed+as+%60%7Binput_id%3A+value%7D%60+%E2%80%94+u\u0026amp;theme=2468acd354f0bec92c22e75f\u0026amp;signature=499b81d296f6b52d23f2f9f01d427b5e4cc9370189147bec965133a3b4e69766\">\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-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-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-run#webpage\",\"url\":\"https://docs.databar.ai/api-reference/endpoint/flows-run\",\"name\":\"Run a flow\",\"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.\",\"dateModified\":\"2026-05-13T10:48:25.114Z\",\"isPartOf\":{\"@id\":\"https://docs.databar.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.databar.ai/api-reference/endpoint/flows-run#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.databar.ai/api-reference/endpoint/flows-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\",\"item\":\"https://docs.databar.ai/api-reference/endpoint/flows-run\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.databar.ai/api-reference/endpoint/flows-run#apireference\",\"headline\":\"Run a flow\",\"name\":\"Run a flow\",\"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.\",\"url\":\"https://docs.databar.ai/api-reference/endpoint/flows-run\",\"mainEntityOfPage\":{\"@id\":\"https://docs.databar.ai/api-reference/endpoint/flows-run#webpage\"},\"dateModified\":\"2026-05-13T10:48:25.114Z\",\"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}","description":"Delete a flow. Refused while table columns still run it — the column would survive with nothing behind it and fail on every row. Delete those columns first.","href":"/api-reference/endpoint/flows-delete"},{"title":"Run a flow","openapi":"POST /v1/flows/{flow_id}/run","href":"/api-reference/endpoint/flows-run"},{"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"},{"title":"List a flow's edit history","openapi":"GET /v1/flows/{flow_id}/versions","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 - Databar Docs","buildId":"dpl_HcHmUS6i3UwswnTHJUEdcTtwfdTQ","deploymentId":"dpl_HcHmUS6i3UwswnTHJUEdcTtwfdTQ","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-BRm_l__d.js","utils-f1l1Oc-G.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-BlhqDhJO.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DHCB7rsC.js","snippetPresets-CYXLx6Hv.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-B78P2dEq.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C4YLPVAh.js","shallow-vlLnTDkQ.js","getApiPlaygroundDisplay-D_98hhvf.js","CodeSnippet-DtnZHGqq.js","CodeSnippets-CLFb8KJt.js","Page-kQh739Uz.js","getPastedJson-Cq-zlbnU.js","icon-sN3t983t.js","MethodPill-P_YQ2s09.js","DuplicateIcon-BVzyNsGJ.js","createIcon-B3jqgqC6.js","DynamicMarkdown-Crwq6WG_.js","SectionHeading-C7pGS2Bb.js","axios-vUo_bRtp.js","Markdown-BuPH8yuW.js","clsx-CCOYKgaU.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BnkC_6oA.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BM4S31-f.js"]}