Prepare, validate, estimate, and submit loomloom workflows from Excel.
Workbooks are the recommended input experience for loomloom. They keep the expected fields, input rows, row-level results, and errors in a format that users can inspect before and after execution.
Download the workbook from the exact template or Listing you plan to use. Keep its headers and structure unchanged, and add one AI Workload per input row.
loomloom run watch <run-id>loomloom run result-workbook <run-id> --output-file ./result.xlsx
The result workbook is generated from the server-side input snapshot and aligns outputs with the submitted rows. Prefer it over the legacy local backfill command.
Workbook contents are transferred to the configured loomloom server. Do not print complete encoded request payloads or store temporary signed result URLs in long-lived logs.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"CogFoundry Docs","colors":{"primary":"#111111"},"logo":{"light":"https://mintcdn.com/cogfoundry-8a54217b/LHTJQzou6DrszVLD/assets/logo-mark-on-light.svg?fit=max\u0026auto=format\u0026n=LHTJQzou6DrszVLD\u0026q=85\u0026s=f1c465afd64386705c8970aa5276a3fd","dark":"https://mintcdn.com/cogfoundry-8a54217b/LHTJQzou6DrszVLD/assets/logo-mark-on-dark.svg?fit=max\u0026auto=format\u0026n=LHTJQzou6DrszVLD\u0026q=85\u0026s=0faa17caa4ef842fc317a73828b00ee7","href":"https://cogfoundry.ai/"},"favicon":{"light":"https://mintcdn.com/cogfoundry-8a54217b/LHTJQzou6DrszVLD/assets/logo-mark-on-light.svg?fit=max\u0026auto=format\u0026n=LHTJQzou6DrszVLD\u0026q=85\u0026s=f1c465afd64386705c8970aa5276a3fd","dark":"https://mintcdn.com/cogfoundry-8a54217b/LHTJQzou6DrszVLD/assets/logo-mark-on-dark.svg?fit=max\u0026auto=format\u0026n=LHTJQzou6DrszVLD\u0026q=85\u0026s=0faa17caa4ef842fc317a73828b00ee7"},"appearance":{"default":"light","strict":true},"navbar":{"primary":{"type":"button","label":"CogFoundry","href":"https://console.cogfoundry.ai/"}},"footer":{"socials":{"github":"https://github.com/cogfoundry-labs"},"links":[{"header":"Source","items":[{"label":"loomloom","href":"https://github.com/cogfoundry-labs/loomloom"},{"label":"Documentation","href":"https://github.com/cogfoundry-labs/cogfoundry-docs"}]}]},"fonts":{"family":"Inter"},"icons":{"library":"lucide"},"styling":{"eyebrows":"breadcrumbs","latex":false},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"cogfoundry-8a54217b","hasAudioNarration":false,"actualSubdomain":"cogfoundry-8a54217b","customDomains":["docs.cogfoundry.ai"],"gitSource":{"type":"github","owner":"cogfoundry-labs","repo":"cogfoundry-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"collectionId":"c86648b7-a765-4818-ad74-d0d6b542eef8","liveDeploymentHistoryId":"6a7f5eea528b90f3bd4ad479","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6a7f5eea528b90f3bd4ad479"},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6a7f5eea528b90f3bd4ad479:success","clientVersion":"0.0.4044","searchFilterCounts":[{"language":"default","tag":"Developer Reference","count":77},{"language":"default","tag":"loomloom API endpoints","count":53},{"language":"default","tag":"Documentation","count":26},{"language":"default","tag":"loomloom CLI","count":20},{"language":"default","tag":"User Templates","count":11},{"language":"default","tag":"Official Templates","count":9},{"language":"default","tag":"Operate loomloom","count":7},{"language":"default","tag":"Market Listings","count":6},{"language":"default","tag":"Market Runs","count":6},{"language":"default","tag":"Overview","count":5}]},"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":"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":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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":"billing-updated-9-15","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":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":":root{--cogfoundry-border:#e5e5e5;--cogfoundry-sidebar:#ffffff;--cogfoundry-text:#111111;--cogfoundry-muted:#525252;--cogfoundry-accent:#09e4a7}#navbar{border-bottom:1px solid var(--cogfoundry-border)}#navbar nav a[href=\"https://console.cogfoundry.ai/\"]{color:var(--cogfoundry-text)!important;background:var(--cogfoundry-accent)!important;border-radius:10px}#navbar nav a[href=\"https://console.cogfoundry.ai/\"] span,#navbar nav a[href=\"https://console.cogfoundry.ai/\"] svg{color:var(--cogfoundry-text)!important}#navbar nav a[href=\"https://console.cogfoundry.ai/\"]>span:first-child{background:var(--cogfoundry-accent)!important}#assistant-entry,#assistant-entry-mobile{display:none!important}nav-logo img{width:30px;height:30px;object-fit:contain}nav-tabs{gap:24px}nav-tabs-item{color:var(--cogfoundry-muted);font-weight:500}nav-tabs-item[data-active]{color:var(--cogfoundry-text);font-weight:600}#sidebar{background:var(--cogfoundry-sidebar);border-right:1px solid var(--cogfoundry-border)}#sidebar-content li[data-active]{font-weight:600}#content{max-width:880px}#page-title{letter-spacing:-.03em}mdx-content p{line-height:1.75}callout,card,code-block{border-radius:12px}"}],"page":{"pagePath":"documentation/loomloom/excel-workbook-workflows","slug":"/documentation/loomloom/excel-workbook-workflows","pageMetadata":{"title":"Excel workbook workflows","description":"Prepare, validate, estimate, and submit loomloom workflows from Excel.","icon":"sheet","href":"/documentation/loomloom/excel-workbook-workflows"},"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: \"Prepare, validate, estimate, and submit loomloom workflows from Excel.\"\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`,li:`li`,p:`p`,pre:`pre`,span:`span`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Table,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Workbooks are the recommended input experience for loomloom. They keep the expected fields, input rows, row-level results, and errors in a format that users can inspect before and after execution.`}),`\n`,_jsx(Heading,{level:`2`,id:`one-row-one-ai-workload`,children:`One row, one AI Workload`}),`\n`,_jsx(_components.p,{children:`Download the workbook from the exact template or Listing you plan to use. Keep its headers and structure unchanged, and add one AI Workload per input row.`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Workflow source`}),_jsx(_components.th,{children:`Download`}),_jsx(_components.th,{children:`Validate`}),_jsx(_components.th,{children:`Estimate`}),_jsx(_components.th,{children:`Submit after confirmation`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Official template`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`template download`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`template validate-file`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`template precheck-file`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`template submit-file`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Private template version`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`template-spec download-workbook`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`template-spec validate-workbook`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`template-spec precheck-workbook`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`template-spec submit-workbook`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Market SkillBot`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`market workbook download`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`market workbook validate`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`market workbook quote`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`market workbook run`})})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`official-template-example`,children:`Official template example`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`7`,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:`7`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`loomloom`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` template`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` download`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` \u003c`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`template-i`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`d`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`>`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --output-file`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` ./input.xlsx`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# Fill the workbook.`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`loomloom`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` template`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` validate-file`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` \u003c`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`template-i`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`d`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`>`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` ./input.xlsx`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`loomloom`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` template`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` precheck-file`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` \u003c`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`template-i`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`d`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`>`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` ./input.xlsx`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# Review the estimate and explicitly confirm before continuing.`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`loomloom`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` template`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` submit-file`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` \u003c`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`template-i`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`d`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`>`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` ./input.xlsx`}),_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:` --client-request-id`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` \u003c`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`stable-i`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`d`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`>`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`before-submitting`,children:`Before submitting`}),`\n`,_jsx(_components.p,{children:`Confirm all of the following:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`the template or Listing ID is correct;`}),`\n`,_jsx(_components.li,{children:`a private workflow uses the intended fixed version ID;`}),`\n`,_jsx(_components.li,{children:`validation passes;`}),`\n`,_jsx(_components.li,{children:`the row count and input file are correct;`}),`\n`,_jsx(_components.li,{children:`the estimate includes a known currency and sufficient balance;`}),`\n`,_jsx(_components.li,{children:`you understand that submission creates a hosted run and may create billable model/API usage.`}),`\n`]}),`\n`,_jsx(_components.p,{children:`An AI agent must ask for a new explicit confirmation for every changed template, version, Listing, or input file.`}),`\n`,_jsx(Heading,{level:`2`,id:`retrieve-the-result-workbook`,children:`Retrieve the result workbook`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,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:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`loomloom`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` run`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` watch`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` \u003c`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`run-i`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`d`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`>`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`loomloom`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` run`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` result-workbook`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` \u003c`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`run-i`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`d`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`>`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --output-file`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` ./result.xlsx`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`The result workbook is generated from the server-side input snapshot and aligns outputs with the submitted rows. Prefer it over the legacy local backfill command.`}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`Workbook contents are transferred to the configured loomloom server. Do not print complete encoded request payloads or store temporary signed result URLs in long-lived logs.`})})]})}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":"Excel workbook workflows","description":"Prepare, validate, estimate, and submit loomloom workflows from Excel.","icon":"sheet","href":"/documentation/loomloom/excel-workbook-workflows"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"One row, one AI Workload","slug":"one-row-one-ai-workload","depth":2,"children":[]},{"title":"Official template example","slug":"official-template-example","depth":2,"children":[]},{"title":"Before submitting","slug":"before-submitting","depth":2,"children":[]},{"title":"Retrieve the result workbook","slug":"retrieve-the-result-workbook","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"cogfoundry-8a54217b","siteName":"CogFoundry Docs","title":"Excel workbook workflows - CogFoundry Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-08-12T04:19:56.105Z","originalFileLocation":"documentation/loomloom/excel-workbook-workflows.md"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=\"light\";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=\"light\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Prepare, validate, estimate, and submit loomloom workflows from Excel.\">\u003cmeta data-mint-head name=\"application-name\" content=\"CogFoundry 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/cogfoundry-8a54217b/v0GZYcFPw_5KgrE4/_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/cogfoundry-8a54217b/v0GZYcFPw_5KgrE4/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/cogfoundry-8a54217b/v0GZYcFPw_5KgrE4/_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/cogfoundry-8a54217b/v0GZYcFPw_5KgrE4/_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/cogfoundry-8a54217b/v0GZYcFPw_5KgrE4/_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/cogfoundry-8a54217b/v0GZYcFPw_5KgrE4/_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/cogfoundry-8a54217b/v0GZYcFPw_5KgrE4/_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/cogfoundry-8a54217b/v0GZYcFPw_5KgrE4/_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/cogfoundry-8a54217b/v0GZYcFPw_5KgrE4/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Excel workbook workflows - CogFoundry Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Prepare, validate, estimate, and submit loomloom workflows from Excel.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"CogFoundry Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.cogfoundry.ai/documentation/loomloom/excel-workbook-workflows\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://cogfoundry-8a54217b.mintlify.app/_mintlify/api/og/v2?division=Operate+loomloom\u0026amp;title=Excel+workbook+workflows\u0026amp;description=Prepare%2C+validate%2C+estimate%2C+and+submit+loomloom+workflows+from+Excel.\u0026amp;theme=568bd395c831c0c6a9a3aae3\u0026amp;signature=9d38504a6493d7359f5781c8570cf8be192c450b3bf59b52d410aa8ef2e21c28\">\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=\"Excel workbook workflows - CogFoundry Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Prepare, validate, estimate, and submit loomloom workflows from Excel.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://cogfoundry-8a54217b.mintlify.app/_mintlify/api/og/v2?division=Operate+loomloom\u0026amp;title=Excel+workbook+workflows\u0026amp;description=Prepare%2C+validate%2C+estimate%2C+and+submit+loomloom+workflows+from+Excel.\u0026amp;theme=568bd395c831c0c6a9a3aae3\u0026amp;signature=9d38504a6493d7359f5781c8570cf8be192c450b3bf59b52d410aa8ef2e21c28\">\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/cogfoundry-8a54217b/v0GZYcFPw_5KgrE4/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"CogFoundry Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#111111\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.cogfoundry.ai/documentation/loomloom/excel-workbook-workflows\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/documentation/loomloom/excel-workbook-workflows.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.cogfoundry.ai/#organization\",\"name\":\"CogFoundry Docs\",\"url\":\"https://docs.cogfoundry.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/cogfoundry-8a54217b/LHTJQzou6DrszVLD/assets/logo-mark-on-light.svg?fit=max\u0026auto=format\u0026n=LHTJQzou6DrszVLD\u0026q=85\u0026s=f1c465afd64386705c8970aa5276a3fd\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.cogfoundry.ai#website\",\"name\":\"CogFoundry Docs\",\"url\":\"https://docs.cogfoundry.ai\",\"publisher\":{\"@id\":\"https://docs.cogfoundry.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.cogfoundry.ai/documentation/loomloom/excel-workbook-workflows#webpage\",\"url\":\"https://docs.cogfoundry.ai/documentation/loomloom/excel-workbook-workflows\",\"name\":\"Excel workbook workflows\",\"description\":\"Prepare, validate, estimate, and submit loomloom workflows from Excel.\",\"dateModified\":\"2026-08-12T04:19:56.105Z\",\"isPartOf\":{\"@id\":\"https://docs.cogfoundry.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.cogfoundry.ai/documentation/loomloom/excel-workbook-workflows#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.cogfoundry.ai/documentation/loomloom/excel-workbook-workflows#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Operate loomloom\",\"item\":\"https://docs.cogfoundry.ai/documentation/loomloom/supported-agents\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Excel workbook workflows\",\"item\":\"https://docs.cogfoundry.ai/documentation/loomloom/excel-workbook-workflows\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.cogfoundry.ai/documentation/loomloom/excel-workbook-workflows#article\",\"headline\":\"Excel workbook workflows\",\"name\":\"Excel workbook workflows\",\"description\":\"Prepare, validate, estimate, and submit loomloom workflows from Excel.\",\"url\":\"https://docs.cogfoundry.ai/documentation/loomloom/excel-workbook-workflows\",\"mainEntityOfPage\":{\"@id\":\"https://docs.cogfoundry.ai/documentation/loomloom/excel-workbook-workflows#webpage\"},\"dateModified\":\"2026-08-12T04:19:56.105Z\",\"publisher\":{\"@id\":\"https://docs.cogfoundry.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.cogfoundry.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"CogFoundry Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"CogFoundry Docs","nav":{"global":null,"tabs":[{"tab":"Documentation","icon":"book-open","groups":[{"group":"Overview","pages":[{"title":"Quickstart","icon":"rocket","href":"/documentation/overview/quickstart"},{"title":"What is CogFoundry","icon":"factory","href":"/documentation/overview/what-is-cogfoundry"},{"title":"Core Concepts","icon":"boxes","href":"/documentation/overview/core-concepts"},{"title":"Product Map","icon":"map","href":"/documentation/overview/product-map"},{"title":"FAQ","icon":"book-open","href":"/documentation/overview/faq"}]},{"group":"loomloom","pages":[{"title":"loomloom overview","icon":"workflow","href":"/documentation/loomloom/overview"},{"title":"AI work as software","icon":"binary","href":"/documentation/loomloom/why-ai-loops"}]},{"group":"Quick start","pages":[{"title":"Install loomloom","icon":"download","href":"/documentation/loomloom/installation"},{"title":"Configure credentials","icon":"key-round","href":"/documentation/loomloom/configure-credentials"},{"title":"Quick Start","icon":"rocket","href":"/documentation/loomloom/quick-start"}]},{"group":"Guides","pages":[{"title":"loomloom workflows","icon":"route","href":"/documentation/loomloom/workflows"},{"title":"Create reusable AI work IR","icon":"blocks","href":"/documentation/loomloom/private-templates"},{"title":"Build and use SkillBots","icon":"store","href":"/documentation/loomloom/skillbots-and-market"}]},{"group":"Operate loomloom","pages":[{"title":"Supported agents","icon":"bot","href":"/documentation/loomloom/supported-agents"},{"title":"Supported Models","icon":"blocks","href":"/documentation/loomloom/supported-models"},{"title":"Templates","icon":"panels-top-left","href":"/documentation/loomloom/templates"},{"title":"Official templates","description":"Discover and run CogFoundry-maintained loomloom workflows.","icon":"badge-check","href":"/documentation/loomloom/official-templates"},{"title":"Excel workbook workflows","icon":"sheet","href":"/documentation/loomloom/excel-workbook-workflows"},{"title":"Run and monitor workflows","description":"Track a loomloom run from submission through its terminal status.","icon":"activity","href":"/documentation/loomloom/run-and-monitor-workflows"},{"title":"Artifacts and results","icon":"package-open","href":"/documentation/loomloom/artifacts-and-results"}]},{"group":"Reference and support","pages":[{"title":"Command reference","icon":"terminal","href":"/documentation/loomloom/command-reference"},{"title":"Security notes","icon":"shield-check","href":"/documentation/loomloom/security-notes"},{"title":"Troubleshooting","icon":"wrench","href":"/documentation/loomloom/troubleshooting"},{"title":"Uninstall","icon":"trash-2","href":"/documentation/loomloom/uninstall"}]},{"group":"Privacy","pages":[{"title":"Data Collection","icon":"shield-check","href":"/documentation/privacy/data-collection"},{"title":"Provider Logging","icon":"logs","href":"/documentation/privacy/provider-logging"}]}]},{"tab":"Developer Reference","icon":"code","pages":[{"title":"Developer Reference","href":"/developer-reference/loomloom-cli/overview"}]}]},"basePath":"","title":"Excel workbook workflows - CogFoundry Docs","buildId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","deploymentId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","dynamics":[],"chunks":[]}