Create a workflow in a project you can edit. The workflow is created as a draft and runs nothing until you activate it. You become its owner, and its runs execute as you.
The access token received from the authorization server in the OAuth 2.0 flow.
Scopes
agent:write
agent:write
Body
application/json
A new workflow. Created as a draft; use the activate operation to make it run.
project_id
string
required
Project the workflow belongs to. You must have editor access to it.
Minimum string length: 1
title
string
required
Workflow name, shown wherever it is listed.
Required string length: 1 - 255
description
string
default:""
Optional longer description.
Maximum string length: 2000
status
enum<string>
default:draft
Workflow state. A workflow becomes active only through the activate operation, which freezes the version that runs.
Available options:
draft,
paused,
archived
output_folder
string
default:""
Project folder the workflow writes its outputs to, for example /Reports.
Maximum string length: 512
graph
Graph · object | null
The workflow's graph document: the nodes it runs and how they connect, as {"nodes": [...], "edges": [...]}. This is the FULL desired document on every create and update, not a patch — what you send replaces the stored graph. It must contain a trigger node, summation.trigger.schedule/v1 or summation.trigger.manual/v1, wired to the first work node by an edge {"from_node": "", "from_port": "inputs", "to_node": "", "to_port": "inputs"}. Each node is {"key", "type", "config"}; the node type ids you may use and the config each one takes come from GET /v1/workflows/node-types. A config carries ONLY the keys its node type declares there — any other key is refused, so a field the node type does not name cannot be smuggled through it. Use the summation.trigger.schedule/v1 node exactly when this request also carries schedule triggers; see the triggers field. Omit to create an empty draft. Serializes to at most 200000 characters. The web editor adopts API-authored graphs and normalizes them to its canonical form on its next save.
triggers
WorkflowTriggerRequest · object[]
Schedules that start this workflow. Omit for a workflow that only runs on demand. These rows and the graph's trigger nodes must agree: a schedule here requires a summation.trigger.schedule/v1 node in the graph — it is the node the schedule's parameter values are bound to — and that node requires a schedule here, or nothing would fire it. A request where the two disagree is refused.
Maximum array length: 20
Show child attributes
Response
Successful Response
data
Workflow · object
required
Show child attributes
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Summation","colors":{"primary":"#000000","light":"#888888","dark":"#000000"},"logo":{"light":"https://mintcdn.com/summation-676748f5/VNNtt3ifsblE4Ta9/images/summation-logo.svg?fit=max\u0026auto=format\u0026n=VNNtt3ifsblE4Ta9\u0026q=85\u0026s=6d050102e07df435f3532e1a4e34e685","dark":"https://mintcdn.com/summation-676748f5/VNNtt3ifsblE4Ta9/images/summation-logo.svg?fit=max\u0026auto=format\u0026n=VNNtt3ifsblE4Ta9\u0026q=85\u0026s=6d050102e07df435f3532e1a4e34e685"},"favicon":{"light":"https://mintcdn.com/summation-676748f5/shsHObvGm-SkiZl8/images/favicon.ico?fit=max\u0026auto=format\u0026n=shsHObvGm-SkiZl8\u0026q=85\u0026s=25d44d855522b83a4467f76687386368","dark":"https://mintcdn.com/summation-676748f5/shsHObvGm-SkiZl8/images/favicon.ico?fit=max\u0026auto=format\u0026n=shsHObvGm-SkiZl8\u0026q=85\u0026s=25d44d855522b83a4467f76687386368"},"appearance":{"default":"light"},"navbar":{"primary":{"type":"button","label":"Get Started","href":"https://app.summation.com/signup"}},"fonts":{"family":"Inter"},"contextual":{"options":["copy","view","claude","chatgpt"],"display":"header"},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"summation-676748f5","hasAudioNarration":false,"actualSubdomain":"summation-676748f5","customDomains":["docs.summation.com"],"gitSource":{"type":"github","owner":"summationai","repo":"code","deployBranch":"main","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af5cda8b51d0e31167b5abb","clientVersion":"0.0.4149","searchFilterCounts":[{"language":"default","tag":"API","count":156},{"language":"default","tag":"Endpoints","count":144},{"language":"default","tag":"Documentation","count":49},{"language":"default","tag":"Tables","count":31},{"language":"default","tag":"Connectors","count":21},{"language":"default","tag":"Key concepts","count":20},{"language":"default","tag":"Data Connectors","count":17},{"language":"default","tag":"Grid","count":13},{"language":"default","tag":"Conversations","count":12},{"language":"default","tag":"Use cases","count":11}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"a[href=\"https://app.summation.com/signup\"]{border:0!important;box-shadow:none!important}a[href=\"https://app.summation.com/signup\"]>*{background:#000000!important;color:#ffffff!important;box-shadow:none!important;padding-right:1rem!important;padding-left:1rem!important;gap:0!important}a[href=\"https://app.summation.com/signup\"] span,a[href=\"https://app.summation.com/signup\"] svg{color:#ffffff!important}a[href=\"https://app.summation.com/signup\"] svg{display:none!important}a[href=\"https://app.summation.com/signup\"]:hover>*{background:#27272a!important}html[data-current-path=\"/home\"] .eyebrow{display:none}html[data-current-path^=\"/features/\"] .eyebrow{display:none}html[data-current-path=\"/home\"] #header{max-width:41rem;margin-top:3rem}html[data-current-path=\"/home\"] .mdx-content{margin-top:1.5rem}html[data-current-path=\"/home\"] #content-area{width:100%;max-width:64rem}html[data-current-path=\"/home\"] #header>p{margin-top:0.75rem;color:#52525b;font-size:1.125rem;line-height:1.75rem}.home-get-started{display:inline-flex;min-width:10rem;height:2.75rem;align-items:center;justify-content:center;gap:0.5rem;padding-inline:1rem;border-radius:0.75rem;background:#000000;box-shadow:none!important;color:#ffffff!important;font-size:0.875rem;font-weight:500;line-height:1;text-decoration:none!important;transition:background-color 120ms ease}.home-get-started:hover{background:#27272a;box-shadow:none!important}.home-get-started:focus-visible{outline:2px solid #000000;outline-offset:3px}.home-get-started img{width:1rem;height:1rem}.home-section-divider{width:100%;height:0.5px;margin-block:2.5rem;background:#e7e7e7}.home-section-divider+.card-group{margin-top:0!important}html[data-current-path=\"/home\"] .card-group{width:100%;max-width:64rem;grid-template-columns:repeat(3, minmax(0, 1fr))!important;justify-content:center;gap:1.5rem!important}html[data-current-path=\"/home\"] .card-group>.card{--primary: 228 228 231;display:flex;width:100%;min-height:9.5rem;padding:1.3125rem 1.5rem;align-items:center;box-sizing:border-box;margin-block:0!important;border:var(--border-width-border-half, 0.5px) solid\n var(--border-layout-divider, #e7e7e7)!important;border-radius:var(--border-radius-rounded-xl, 0.75rem);background:var(--color-neutral-white, #ffffff);box-shadow:0 1px 2px 0 rgb(0 0 0 / 5%);transition:background-color 120ms ease,\n box-shadow 120ms ease}html[data-current-path=\"/home\"] .card-group>.card:hover{background:#f4f4f5;border-color:#e4e4e7!important}html[data-current-path=\"/home\"] .card-group>.card>div{height:100%;width:100%;padding:0}html[data-current-path=\"/home\"] .card-group [data-component-part=\"card-title\"]{font-size:0.9375rem!important}html[data-current-path=\"/home\"] .card-group [data-component-part=\"card-content\"]{color:var(--home-card-description, #52525b)!important;font-size:0.875rem!important;line-height:1.25rem!important}html[data-current-path=\"/home\"] .card-group>.card svg{color:#000000!important}html.dark[data-current-path=\"/home\"] .card-group>.card{--primary-light: 63 63 70;--home-card-description: #888888;border-color:#3f3f46!important;background:#18181b}html.dark[data-current-path=\"/home\"] .card-group>.card svg{color:#f4f4f5!important}html.dark[data-current-path=\"/home\"] .card-group>.card:hover{background:#27272a;border-color:#3f3f46!important}html.dark[data-current-path=\"/home\"] .home-section-divider{background:#27272a}.card{background-color:#fafafa!important;transition:background-color 120ms ease,\n border-color 120ms ease}.card:hover{background-color:#f4f4f5!important}html.dark .card{background-color:#18181b!important}html.dark .card:hover{background-color:#232326!important}#content-area{box-sizing:content-box;width:auto;max-width:700px;margin-inline:auto}#page-title{font-size:2rem!important;line-height:2.5rem!important}#page-context-menu-button{border-radius:8px 0 0 8px!important}#page-context-menu>button[aria-label=\"More actions\"]{border-radius:0 8px 8px 0!important}html[data-current-path=\"/home\"] #page-context-menu{display:none!important}div[role=\"menu\"]:has([role=\"menuitem\"] [class~=\"wrap-break-word\"]) [role=\"menuitem\"]>div:first-child{border-color:transparent!important}div[role=\"menu\"]:has([role=\"menuitem\"] [class~=\"wrap-break-word\"]) [role=\"menuitem\"]>div:nth-child(2)>div:first-child>svg{display:none!important}.mdx-content{font-size:15px;letter-spacing:-0.1px}.mdx-content a.link{border-bottom:0;font-weight:400;text-decoration-line:underline;text-decoration-style:dotted;text-decoration-color:#a1a1aa;text-decoration-thickness:from-font;text-decoration-skip-ink:none;text-underline-position:from-font;transition:text-decoration-color 120ms ease-out}.mdx-content a.link:hover{text-decoration-style:solid;text-decoration-color:currentColor}@media (prefers-reduced-motion: reduce){.mdx-content a.link{transition:none}}.mdx-content>h2{margin-top:3rem!important}#table-of-contents-content{--toc-indicator-height: 1.5rem;--toc-indicator-y: 0px;position:relative;border-left:1px solid #e4e4e7}nav:has(>div>#table-of-contents-content)>h2{display:none}#table-of-contents-content::before{position:absolute;top:0;left:-2px;width:3px;height:var(--toc-indicator-height);border-radius:0;background:#27272a;content:\"\";opacity:0;pointer-events:none;transform:translateY(var(--toc-indicator-y));transition:transform 240ms cubic-bezier(0.4, 0, 0.2, 1),\n height 240ms cubic-bezier(0.4, 0, 0.2, 1),\n opacity 120ms ease-out}#table-of-contents-content[data-has-active=\"true\"]::before{opacity:1}@media (prefers-reduced-motion: reduce){#table-of-contents-content::before{transition:opacity 120ms ease-out}}#table-of-contents-content .toc-item>a{padding-left:calc(\n var(--toc-padding-left) + var(--toc-focus-padding, 0rem) + 1rem\n )!important}#table-of-contents-content .toc-item[data-active=\"true\"]>a{font-weight:400;text-shadow:none!important}#table-of-contents-content .toc-item[data-active=\"true\"]:not([data-toc-current=\"true\"])>a{color:#4f4f4f}#table-of-contents-content .toc-item[data-toc-current=\"true\"]>a{color:#000000}.dark #table-of-contents-content{border-left-color:#3f3f46}.dark #table-of-contents-content .toc-item[data-active=\"true\"]:not([data-toc-current=\"true\"])>a{color:#9e9e9e}.dark #table-of-contents-content .toc-item[data-toc-current=\"true\"]>a{color:#888888}.dark #table-of-contents-content::before{background:#f4f4f5}#navigation-items .sidebar-group>li+li{margin-top:4px}#navigation-items .sidebar-group a,#navigation-items .sidebar-group button[aria-expanded]{width:calc(100% - 0.5rem)!important;margin-left:0.5rem}#navigation-items .sidebar-group a,#navigation-items .sidebar-group button[aria-expanded]{padding-top:0.25rem!important;padding-bottom:0.25rem!important;line-height:1.25rem!important}#sidebar a[aria-current=\"page\"]{background-color:#f4f4f5!important;border-radius:8px!important;color:#000000!important;font-weight:500!important;text-shadow:none!important}#navigation-items a:not([aria-current=\"page\"]):hover{background-color:#fafafa!important}.dark #navigation-items a:not([aria-current=\"page\"]):hover{background-color:#18181b!important}.dark #sidebar a[aria-current=\"page\"]{background-color:#27272a!important;color:#ffffff!important}#sidebar button[aria-expanded]>div:last-child{margin-left:auto}#navigation-items .sidebar-group a span,#navigation-items .sidebar-group button span{hyphens:none}div:has(>form #search-input){padding:0!important;border:0!important;background:transparent!important;box-shadow:none!important}#theme-preference-menu-trigger{width:2.25rem;height:2.25rem;padding:0!important;border:0.5px solid #e4e4e7;border-radius:0.625rem!important}#theme-preference-menu-trigger [data-theme-preference-icon]{display:none!important}#theme-preference-menu-trigger [data-theme-preference-icon=\"dark\"]{display:inline-flex!important}html[data-summation-theme-toggle=\"ready\"] #theme-preference-menu-content{display:none!important}.dark #theme-preference-menu-trigger{border-color:#27272a}.dark #theme-preference-menu-trigger [data-theme-preference-icon=\"dark\"]{display:none!important}.dark #theme-preference-menu-trigger [data-theme-preference-icon=\"light\"]{display:inline-flex!important}#header-ask-ai,#assistant-entry{display:none!important}.chat-assistant-floating-input{display:none!important}#pagination{display:grid;grid-template-columns:repeat(2, minmax(0, 1fr));gap:1.5rem;padding:0}#footer{border-top:0!important}html[data-current-path=\"/home\"] #pagination{display:none!important}#pagination>a{display:grid;box-sizing:border-box;min-width:0;height:5rem;align-content:center;padding:1rem 1.5rem;column-gap:0.75rem;row-gap:0.5rem;border:1px solid #e4e4e7;border-radius:0.75rem;background:transparent;font-weight:400;transition:border-color 120ms ease,\n background-color 120ms ease}#pagination>a:hover{border-color:#d4d4d8;background:#fafafa}#pagination>a::before{color:#71717a;font-size:0.8125rem;font-weight:400;line-height:1.25rem}#pagination .pagination-prev{grid-template-columns:auto minmax(0, 1fr)}#pagination .pagination-prev::before{grid-column:2;grid-row:1;content:\"Previous\"}#pagination .pagination-next{grid-template-columns:minmax(0, 1fr) auto;margin-left:0;text-align:right}#pagination .pagination-next::before{grid-column:1;grid-row:1;content:\"Next\"}#pagination [data-component-part=\"pagination-chevron\"]{grid-row:1;width:0.25rem;height:0.5rem;align-self:center;stroke-width:1}#pagination [data-component-part=\"pagination-chevron\"] path{stroke-width:1!important}#pagination [data-component-part=\"pagination-title\"]{grid-column:1 / -1;grid-row:2;color:#27272a;font-size:0.9375rem;font-weight:400;line-height:1.5rem}.dark #pagination>a{border-color:#3f3f46}.dark #pagination>a:hover{border-color:#52525b;background:#18181b}.dark #pagination [data-component-part=\"pagination-title\"]{color:#f4f4f5}header .max-w-8xl{max-width:none!important;margin-inline:0!important}#navbar a[href=\"/\"]:has(.nav-logo){display:flex;align-items:center}#navbar a[href=\"/\"] .nav-logo{height:1.25rem!important}.dark #navbar a[href=\"/\"] .nav-logo{filter:invert(1)}#navbar .max-w-8xl>div>div>.flex.items-center{padding-inline:1.5rem!important}@media (max-width: 639px){#navbar a[href=\"/\"] .nav-logo{height:1.125rem!important}}#navbar>div:first-child{border-bottom-color:#f0f0f0!important}:root{--topbar-tabs-height: 0rem !important}@media (min-width: 1024px){#navbar div.hidden.lg\\:flex.px-12.h-12{position:absolute!important;top:0!important;left:183px!important;height:4rem!important;padding:0!important;width:auto!important}#navbar .nav-tabs{column-gap:2rem}#navbar .nav-tabs-item{gap:0.5rem;white-space:nowrap}#navbar .nav-tabs-item:hover>div.absolute.bottom-0{background-color:currentColor}#navbar .nav-tabs-item[aria-current=\"location\"]>div.absolute.bottom-0{background-color:#27272a!important}.dark #navbar .nav-tabs-item[aria-current=\"location\"]>div.absolute.bottom-0{background-color:#888888!important}#navbar .nav-tabs-item[aria-current=\"location\"]{text-shadow:none!important}}@media (min-width: 1024px){#navbar div:has(>#search-bar-entry){flex:0 1 16rem;min-width:12rem}#navbar div:has(>nav[aria-label=\"Main\"]){flex:0 0 auto;margin-left:0}}#search-bar-entry:focus-visible{outline:2px solid currentColor;outline-offset:2px}.sidebar-group-header--collapsible{cursor:pointer;user-select:none}.sidebar-group-header--collapsible:hover{color:#18181b}.dark .sidebar-group-header--collapsible:hover{color:#f4f4f5}.sidebar-group-header--collapsible:focus-visible{outline:2px solid #a1a1aa;outline-offset:2px;border-radius:4px}.sidebar-group-chevron{margin-left:auto;transform:rotate(90deg);transition:transform 120ms ease}.sidebar-group-header--collapsible[data-sidebar-collapsed=\"true\"] .sidebar-group-chevron{transform:rotate(0deg)}ul.sidebar-group[data-sidebar-collapsed=\"true\"]{display:none}header div:has(>#theme-preference-menu-trigger){margin-left:0.5rem!important}#navbar nav:has(a[href=\"https://app.summation.com/signup\"]){margin-right:0!important}header a[href=\"https://app.summation.com/signup\"]{padding-inline:0.75rem!important}header a[href=\"https://app.summation.com/signup\"]>div{padding-inline:0!important;background:#000000!important}@media (min-width: 1024px){html[data-current-path=\"/home\"] #content-container{position:relative;left:7.5rem}#sidebar{width:280px!important;max-width:280px;transform:translateX(min(-2rem, calc((92rem - 100vw) / 2 - 2rem)));border-right:1px solid #f0f0f0}html:has(#chat-assistant-sheet[aria-hidden=\"false\"]) #sidebar{transform:translateX(min(-2rem, calc((115rem - 100vw) / 2 - 2rem)))}#sidebar>#sidebar-content{top:0!important;left:1.5rem!important}#sidebar-content>[class~=\"pr-8\"]{padding-right:1.5rem!important}#sidebar-content .sticky.top-0.h-8{height:1.5rem}#sidebar-content>[data-component-part=\"scroll-area-scrollbar\"][data-orientation=\"vertical\"]{inset-inline-end:-2.5px!important;margin-inline:0!important}.dark #sidebar{border-right-color:rgba(255, 255, 255, 0.18)}}@media (min-width: 1280px){html[data-current-path=\"/home\"] #header,html[data-current-path=\"/home\"] .mdx-content{transform:translateX(-1.625rem)}html[data-current-path=\"/home\"] .mdx-content{width:calc(100% + 5.25rem)}}@media (min-width: 1024px) and (max-width: 1599px){html[data-current-path=\"/home\"]:has(#chat-assistant-sheet[aria-hidden=\"false\"]) #content-container{left:0}}@media (min-width: 1280px) and (max-width: 1599px){html[data-current-path=\"/home\"]:has(#chat-assistant-sheet[aria-hidden=\"false\"]) #header,html[data-current-path=\"/home\"]:has(#chat-assistant-sheet[aria-hidden=\"false\"]) .mdx-content{transform:none}html[data-current-path=\"/home\"]:has(#chat-assistant-sheet[aria-hidden=\"false\"]) .mdx-content{width:100%}}@media (min-width: 1600px) and (max-width: 1839px){html[data-current-path=\"/home\"]:has(#chat-assistant-sheet[aria-hidden=\"false\"]) #content-container{left:calc(50vw - 50rem)}}@media (max-width: 767px){#pagination{grid-template-columns:minmax(0, 1fr)}html[data-current-path=\"/home\"] #header{margin-top:2rem}html[data-current-path=\"/home\"] #header>p{font-size:1rem;line-height:1.5rem}.home-section-divider{margin-block:1.5rem}html[data-current-path=\"/home\"] .card-group{grid-template-columns:minmax(0, 1fr)!important}}figure[data-name=\"frame\"]{padding:1.25rem!important;margin-top:0!important;margin-bottom:1.5rem!important;border-radius:var(--border-radius-rounded-xl, 0.75rem)!important;background:#fafafa!important}.columns figure[data-name=\"frame\"]{margin-bottom:0!important}.columns{margin-top:0!important;margin-bottom:1.5rem!important;row-gap:1.5rem!important}html.dark figure[data-name=\"frame\"]{background:#18181b!important}figure[data-name=\"frame\"]>div[class*=\"bg-grid\"]{display:none}figure[data-name=\"frame\"]>div[class*=\"justify-center\"]{overflow:visible;border-radius:0}figure[data-name=\"frame\"] img{border-radius:0.375rem;box-shadow:0 0 0 0.5px #d4d4d8,\n 0 1px 2px 0 rgb(0 0 0 / 5%)}html.dark figure[data-name=\"frame\"] img{box-shadow:0 0 0 0.5px #3f3f46,\n 0 1px 2px 0 rgb(0 0 0 / 30%)}figure[data-name=\"frame\"]>div[class*=\"pointer-events-none\"]{border-color:transparent}@media (max-width: 767px){figure[data-name=\"frame\"]{padding:0.75rem!important}}html[data-current-path=\"/introduction\"] .card-group,html[data-current-path=\"/use-cases/overview\"] .card-group:has(>.card [data-component-part=\"card-content-container\"].items-center){row-gap:0.5rem!important}html[data-current-path=\"/introduction\"] .card-group>.card,html[data-current-path=\"/use-cases/overview\"] .card-group:has(>.card [data-component-part=\"card-content-container\"].items-center)>.card{margin-block:0!important}.template-meta{display:grid;grid-template-columns:7.5rem minmax(0, 1fr);gap:0.5rem 1rem;margin:0 0 1.5rem;padding:1.25rem;border-radius:var(--border-radius-rounded-xl, 0.75rem);background:#fafafa}.template-meta-label{margin:0;font-weight:500;color:#71717a}.template-meta-value{margin:0}html.dark .template-meta{background:#18181b}html.dark .template-meta-label{color:#a1a1aa}@media (max-width: 639px){.template-meta{grid-template-columns:minmax(0, 1fr);gap:0.25rem;padding:1rem}.template-meta-value:not(:last-child){margin-bottom:0.5rem}}"}],"page":{"pagePath":"api-reference/workflows/create-workflow","slug":"/api-reference/workflows/create-workflow","pageMetadata":{"title":"Create workflow","description":"Create a workflow in a project you can edit. The workflow is created as a draft and runs nothing until you activate it. You become its owner, and its runs execute as you.","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json post /v1/workflows","href":"/api-reference/workflows/create-workflow","autogeneratedByOpenApi":true},"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: \"Create a workflow in a project you can edit. The workflow is created as a draft and runs nothing until you activate it. You become its owner, and its runs execute as you.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Create workflow","description":"Create a workflow in a project you can edit. The workflow is created as a draft and runs nothing until you activate it. You become its owner, and its runs execute as you.","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json post /v1/workflows","href":"/api-reference/workflows/create-workflow","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/summation-676748f5/109fb4ec55c4f518/theme-toggle.js","/_mintlify/custom/summation-676748f5/767147eed46ae967/toc-indicator.js","/_mintlify/custom/summation-676748f5/82e2d1909a80e450/sidebar-collapse.js"],"openApiReferenceData":{"operation":{"tags":["Workflows"],"summary":"Create workflow","description":"Create a workflow in a project you can edit. The workflow is created as a draft and runs nothing until you activate it. You become its owner, and its runs execute as you.","operationId":"create_workflow","security":["3dcaeddd-3c5e-4205-b01d-d65dd3a0a7c7"],"requestBody":"ed83f0ad-d193-45ed-a18c-264162243f47","responses":{"201":"e902413f-76e0-464f-929a-3981bd61092b","400":"6be79a51-8d88-42b3-b24b-25896f52ba16","401":"8fbb0239-9bcf-4e42-8a3a-552729c348b4","403":"174c9ff3-6c55-404b-bdf2-96d4ccfbf05c","404":"76fae658-d6d2-4334-b690-c8a635d5df7a","409":"1c5f40f4-589a-4174-895a-f1942628c001","422":"43069f86-e5f9-4616-871e-3bd1c76a451e","429":"4acaa76a-4461-415f-884c-deb1ca0a3b52","500":"63685e2f-375b-424a-970b-2e9ab3388a25","503":"c636197d-2aa6-4f51-8960-ae9f37f1b983"},"method":"post","type":"path","servers":[],"path":"/v1/workflows","baseUrlOptions":[],"title":"Create workflow","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"project_id":{"type":"string","minLength":1,"title":"Project Id","description":"Project the workflow belongs to. You must have editor access to it.","isRequired":true,"uniqueKey":"project_id","typeLabel":"string"},"title":{"type":"string","maxLength":255,"minLength":1,"title":"Title","description":"Workflow name, shown wherever it is listed.","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"description":{"type":"string","maxLength":2000,"title":"Description","description":"Optional longer description.","default":"","uniqueKey":"description","typeLabel":"string"},"status":{"type":"string","enum":["draft","paused","archived"],"title":"Status","description":"Workflow state. A workflow becomes active only through the activate operation, which freezes the version that runs.","default":"draft","uniqueKey":"status","typeLabel":"enum\u003cstring>"},"output_folder":{"type":"string","maxLength":512,"title":"Output Folder","description":"Project folder the workflow writes its outputs to, for example /Reports.","default":"","uniqueKey":"output_folder","typeLabel":"string"},"graph":{"oneOf":[{"type":"object","title":"Graph","description":"The workflow's graph document: the nodes it runs and how they connect, as {\"nodes\": [...], \"edges\": [...]}. This is the FULL desired document on every create and update, not a patch — what you send replaces the stored graph. It must contain a trigger node, summation.trigger.schedule/v1 or summation.trigger.manual/v1, wired to the first work node by an edge {\"from_node\": \"\u003ctrigger key>\", \"from_port\": \"inputs\", \"to_node\": \"\u003cfirst work node key>\", \"to_port\": \"inputs\"}. Each node is {\"key\", \"type\", \"config\"}; the node type ids you may use and the config each one takes come from GET /v1/workflows/node-types. A config carries ONLY the keys its node type declares there — any other key is refused, so a field the node type does not name cannot be smuggled through it. Use the summation.trigger.schedule/v1 node exactly when this request also carries schedule triggers; see the triggers field. Omit to create an empty draft. Serializes to at most 200000 characters. The web editor adopts API-authored graphs and normalizes them to its canonical form on its next save.","additionalProperties":true,"uniqueKey":"graph.oneOf.0","typeLabel":"Graph · object"},{"type":"null","title":"Graph","description":"The workflow's graph document: the nodes it runs and how they connect, as {\"nodes\": [...], \"edges\": [...]}. This is the FULL desired document on every create and update, not a patch — what you send replaces the stored graph. It must contain a trigger node, summation.trigger.schedule/v1 or summation.trigger.manual/v1, wired to the first work node by an edge {\"from_node\": \"\u003ctrigger key>\", \"from_port\": \"inputs\", \"to_node\": \"\u003cfirst work node key>\", \"to_port\": \"inputs\"}. Each node is {\"key\", \"type\", \"config\"}; the node type ids you may use and the config each one takes come from GET /v1/workflows/node-types. A config carries ONLY the keys its node type declares there — any other key is refused, so a field the node type does not name cannot be smuggled through it. Use the summation.trigger.schedule/v1 node exactly when this request also carries schedule triggers; see the triggers field. Omit to create an empty draft. Serializes to at most 200000 characters. The web editor adopts API-authored graphs and normalizes them to its canonical form on its next save.","uniqueKey":"graph.oneOf.1","typeLabel":"null"}],"uniqueKey":"graph","typeLabel":"Graph · object | null"},"triggers":{"items":{"properties":{"schedule":{"properties":{"type":{"type":"string","enum":["one_time","daily","weekly","monthly"],"title":"Type","description":"Editor-supported cadence kind: one_time, daily, weekly, or monthly.","isRequired":true,"uniqueKey":"triggers.items.[INDEX].schedule.type","typeLabel":"enum\u003cstring>"},"zone_id":{"type":"string","title":"Zone Id","description":"IANA timezone the schedule's local times are read in, for example America/Los_Angeles.","isRequired":true,"uniqueKey":"triggers.items.[INDEX].schedule.zone_id","typeLabel":"string"},"time_of_day":{"oneOf":[{"type":"string","title":"Time Of Day","description":"Local minute-precision time for the cadence; use HH:mm. HH:mm:00 is accepted and normalized, but nonzero seconds are refused because the workflow editor cannot preserve them.","default":"09:00","uniqueKey":"triggers.items.[INDEX].schedule.time_of_day.oneOf.0","typeLabel":"string"},{"type":"null","title":"Time Of Day","description":"Local minute-precision time for the cadence; use HH:mm. HH:mm:00 is accepted and normalized, but nonzero seconds are refused because the workflow editor cannot preserve them.","default":"09:00","uniqueKey":"triggers.items.[INDEX].schedule.time_of_day.oneOf.1","typeLabel":"null"}],"uniqueKey":"triggers.items.[INDEX].schedule.time_of_day","typeLabel":"string | null"},"run_date":{"oneOf":[{"type":"string","title":"Run Date","description":"Required for type one_time, ignored otherwise. The single local date the schedule runs on, as YYYY-MM-DD, read in zone_id at time_of_day.","format":"date","uniqueKey":"triggers.items.[INDEX].schedule.run_date.oneOf.0","typeLabel":"string\u003cdate>"},{"type":"null","title":"Run Date","description":"Required for type one_time, ignored otherwise. The single local date the schedule runs on, as YYYY-MM-DD, read in zone_id at time_of_day.","uniqueKey":"triggers.items.[INDEX].schedule.run_date.oneOf.1","typeLabel":"null"}],"uniqueKey":"triggers.items.[INDEX].schedule.run_date","typeLabel":"string\u003cdate> | null"},"days_of_week":{"items":{"type":"string","enum":["MONDAY","TUESDAY","WEDNESDAY","THURSDAY","FRIDAY","SATURDAY","SUNDAY"],"uniqueKey":"triggers.items.[INDEX].schedule.days_of_week.items.[INDEX]","typeLabel":"enum\u003cstring>"},"type":"array","title":"Days Of Week","description":"Required for type weekly, ignored otherwise. UPPERCASE day names — MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY — one entry per day the schedule runs.","uniqueKey":"triggers.items.[INDEX].schedule.days_of_week","typeLabel":"enum\u003cstring>[]"},"day_of_month":{"oneOf":[{"type":"integer","title":"Day Of Month","description":"Required for type monthly, ignored otherwise. Day of the month, 1 to 31.","maximum":31,"minimum":1,"uniqueKey":"triggers.items.[INDEX].schedule.day_of_month.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Day Of Month","description":"Required for type monthly, ignored otherwise. Day of the month, 1 to 31.","uniqueKey":"triggers.items.[INDEX].schedule.day_of_month.oneOf.1","typeLabel":"null"}],"uniqueKey":"triggers.items.[INDEX].schedule.day_of_month","typeLabel":"integer | null"},"interval":{"type":"integer","const":1,"title":"Interval","description":"Must be 1; the workflow editor does not support skipping recurrence periods.","default":1,"uniqueKey":"triggers.items.[INDEX].schedule.interval","typeLabel":"integer"}},"additionalProperties":false,"type":"object","required":["type","zone_id"],"title":"WorkflowTriggerSchedule","description":"Cadence and timezone for this schedule.","isRequired":true,"uniqueKey":"triggers.items.[INDEX].schedule","typeLabel":"WorkflowTriggerSchedule · object"},"id":{"type":"string","title":"Id","description":"Existing trigger id to update. Omit to create a new trigger.","default":"","uniqueKey":"triggers.items.[INDEX].id","typeLabel":"string"},"type":{"type":"string","const":"schedule","title":"Type","description":"Trigger kind. Only schedule triggers can be created through this API.","default":"schedule","uniqueKey":"triggers.items.[INDEX].type","typeLabel":"string"},"label":{"type":"string","maxLength":255,"title":"Label","description":"Human-readable name for this schedule.","default":"","uniqueKey":"triggers.items.[INDEX].label","typeLabel":"string"},"enabled":{"type":"boolean","title":"Enabled","description":"Set false to keep the schedule but stop it firing.","default":true,"uniqueKey":"triggers.items.[INDEX].enabled","typeLabel":"boolean"},"params":{"additionalProperties":true,"type":"object","title":"Params","description":"Parameter values this schedule passes to the workflow, merged over the workflow's own values.","uniqueKey":"triggers.items.[INDEX].params","typeLabel":"Params · object"}},"additionalProperties":false,"type":"object","required":["schedule"],"title":"WorkflowTriggerRequest","description":"One schedule trigger on a workflow.\n\nTriggers are a full replace-set on every write: a workflow's triggers are exactly the\nones the request carries, and any it omits are deleted along with their backing schedule.\nEcho the ``id`` of a trigger you are keeping so its stored settings survive the write.\n\nAn editor-supported trigger read back from a GET is field for field a trigger this model takes,\nin either spelling, so a caller can hand it straight back on a write. Broader legacy scheduler\nshapes remain readable but must be replaced before this API will write the workflow.","uniqueKey":"triggers.items.[INDEX]","typeLabel":"WorkflowTriggerRequest · object"},"type":"array","maxItems":20,"title":"Triggers","description":"Schedules that start this workflow. Omit for a workflow that only runs on demand. These rows and the graph's trigger nodes must agree: a schedule here requires a summation.trigger.schedule/v1 node in the graph — it is the node the schedule's parameter values are bound to — and that node requires a schedule here, or nothing would fire it. A request where the two disagree is refused.","uniqueKey":"triggers","typeLabel":"WorkflowTriggerRequest · object[]"}},"additionalProperties":false,"type":"object","required":["project_id","title"],"title":"WorkflowCreateRequest","description":"A new workflow. Created as a draft; use the activate operation to make it run.","uniqueKey":"","typeLabel":"WorkflowCreateRequest · object"},"examples":{"Example":{"title":"Example","value":{"project_id":"\u003cstring>","title":"\u003cstring>","description":"","status":"draft","output_folder":"","graph":{},"triggers":[{"schedule":{"zone_id":"\u003cstring>","time_of_day":"09:00","run_date":"2023-12-25","days_of_week":[],"day_of_month":16,"interval":1},"id":"","type":"schedule","label":"","enabled":true,"params":{}}]}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"e902413f-76e0-464f-929a-3981bd61092b":{"description":"Successful Response","content":{"application/json":{"schema":{"properties":{"data":{"properties":{"id":{"type":"string","title":"Id","isRequired":true,"uniqueKey":"data.id","typeLabel":"string"},"projectId":{"type":"string","title":"Projectid","isRequired":true,"uniqueKey":"data.projectId","typeLabel":"string"},"title":{"type":"string","title":"Title","isRequired":true,"uniqueKey":"data.title","typeLabel":"string"},"description":{"type":"string","title":"Description","isRequired":true,"uniqueKey":"data.description","typeLabel":"string"},"ownerUserId":{"type":"string","title":"Owneruserid","description":"The user the workflow runs as. Assigned at creation and never reassigned.","isRequired":true,"uniqueKey":"data.ownerUserId","typeLabel":"string"},"status":{"type":"string","title":"Status","description":"One of draft, active, paused, archived, unknown.","isRequired":true,"uniqueKey":"data.status","typeLabel":"string"},"executionFormat":{"type":"string","title":"Executionformat","description":"typed_graph for workflows built from a graph document. Fixed when the workflow is created.","isRequired":true,"uniqueKey":"data.executionFormat","typeLabel":"string"},"outputFolder":{"type":"string","title":"Outputfolder","isRequired":true,"uniqueKey":"data.outputFolder","typeLabel":"string"},"revision":{"type":"integer","title":"Revision","description":"Advances on every change. Pass it back as expected_revision.","isRequired":true,"uniqueKey":"data.revision","typeLabel":"integer"},"activeVersionId":{"type":"string","title":"Activeversionid","description":"The activated version this workflow currently runs, or empty if it has never been activated.","isRequired":true,"uniqueKey":"data.activeVersionId","typeLabel":"string"},"triggers":{"items":{"properties":{"id":{"type":"string","title":"Id","isRequired":true,"uniqueKey":"data.triggers.items.[INDEX].id","typeLabel":"string"},"type":{"type":"string","title":"Type","description":"schedule, webhook, api, data_event, or unknown.","isRequired":true,"uniqueKey":"data.triggers.items.[INDEX].type","typeLabel":"string"},"label":{"type":"string","title":"Label","isRequired":true,"uniqueKey":"data.triggers.items.[INDEX].label","typeLabel":"string"},"enabled":{"type":"boolean","title":"Enabled","isRequired":true,"uniqueKey":"data.triggers.items.[INDEX].enabled","typeLabel":"boolean"},"params":{"additionalProperties":true,"type":"object","title":"Params","description":"Parameter values this trigger passes to the workflow.","isRequired":true,"uniqueKey":"data.triggers.items.[INDEX].params","typeLabel":"Params · object"},"schedule":{"oneOf":[{"type":"object","title":"WorkflowSchedule","description":"Cadence, for schedule triggers.","required":["type","zoneId"],"properties":{"type":{"type":"string","title":"Type","description":"Stored cadence kind. Writes accept one_time, daily, weekly, and monthly; existing workflows may read as cron, interval, biweekly, or month_end until their cadence is replaced.","isRequired":true,"uniqueKey":"data.triggers.items.[INDEX].schedule.oneOf.0.type","typeLabel":"string"},"zoneId":{"type":"string","title":"Zoneid","description":"IANA timezone the schedule's local times are read in.","isRequired":true,"uniqueKey":"data.triggers.items.[INDEX].schedule.oneOf.0.zoneId","typeLabel":"string"},"cronExpression":{"oneOf":[{"type":"string","title":"Cronexpression","uniqueKey":"data.triggers.items.[INDEX].schedule.oneOf.0.cronExpression.oneOf.0","typeLabel":"string"},{"type":"null","title":"Cronexpression","uniqueKey":"data.triggers.items.[INDEX].schedule.oneOf.0.cronExpression.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.triggers.items.[INDEX].schedule.oneOf.0.cronExpression","typeLabel":"string | null"},"everyMinutes":{"oneOf":[{"type":"integer","title":"Everyminutes","uniqueKey":"data.triggers.items.[INDEX].schedule.oneOf.0.everyMinutes.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Everyminutes","uniqueKey":"data.triggers.items.[INDEX].schedule.oneOf.0.everyMinutes.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.triggers.items.[INDEX].schedule.oneOf.0.everyMinutes","typeLabel":"integer | null"},"timeOfDay":{"oneOf":[{"type":"string","title":"Timeofday","description":"Local time of day, in this schedule's timezone.","uniqueKey":"data.triggers.items.[INDEX].schedule.oneOf.0.timeOfDay.oneOf.0","typeLabel":"string"},{"type":"null","title":"Timeofday","description":"Local time of day, in this schedule's timezone.","uniqueKey":"data.triggers.items.[INDEX].schedule.oneOf.0.timeOfDay.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.triggers.items.[INDEX].schedule.oneOf.0.timeOfDay","typeLabel":"string | null"},"runDate":{"oneOf":[{"type":"string","title":"Rundate","uniqueKey":"data.triggers.items.[INDEX].schedule.oneOf.0.runDate.oneOf.0","typeLabel":"string"},{"type":"null","title":"Rundate","uniqueKey":"data.triggers.items.[INDEX].schedule.oneOf.0.runDate.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.triggers.items.[INDEX].schedule.oneOf.0.runDate","typeLabel":"string | null"},"anchorDate":{"oneOf":[{"type":"string","title":"Anchordate","uniqueKey":"data.triggers.items.[INDEX].schedule.oneOf.0.anchorDate.oneOf.0","typeLabel":"string"},{"type":"null","title":"Anchordate","uniqueKey":"data.triggers.items.[INDEX].schedule.oneOf.0.anchorDate.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.triggers.items.[INDEX].schedule.oneOf.0.anchorDate","typeLabel":"string | null"},"daysOfWeek":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"data.triggers.items.[INDEX].schedule.oneOf.0.daysOfWeek.oneOf.0.items.[INDEX]","typeLabel":"string"},"title":"Daysofweek","description":"Uppercase weekday names, for example MONDAY.","uniqueKey":"data.triggers.items.[INDEX].schedule.oneOf.0.daysOfWeek.oneOf.0","typeLabel":"string[]"},{"type":"null","title":"Daysofweek","description":"Uppercase weekday names, for example MONDAY.","uniqueKey":"data.triggers.items.[INDEX].schedule.oneOf.0.daysOfWeek.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.triggers.items.[INDEX].schedule.oneOf.0.daysOfWeek","typeLabel":"string[] | null"},"dayOfMonth":{"oneOf":[{"type":"integer","title":"Dayofmonth","uniqueKey":"data.triggers.items.[INDEX].schedule.oneOf.0.dayOfMonth.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Dayofmonth","uniqueKey":"data.triggers.items.[INDEX].schedule.oneOf.0.dayOfMonth.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.triggers.items.[INDEX].schedule.oneOf.0.dayOfMonth","typeLabel":"integer | null"},"interval":{"oneOf":[{"type":"integer","title":"Interval","description":"How many periods apart the cadence repeats, for cadences that can skip periods.","uniqueKey":"data.triggers.items.[INDEX].schedule.oneOf.0.interval.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Interval","description":"How many periods apart the cadence repeats, for cadences that can skip periods.","uniqueKey":"data.triggers.items.[INDEX].schedule.oneOf.0.interval.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.triggers.items.[INDEX].schedule.oneOf.0.interval","typeLabel":"integer | null"}},"uniqueKey":"data.triggers.items.[INDEX].schedule.oneOf.0","typeLabel":"WorkflowSchedule · object"},{"type":"null","description":"Cadence, for schedule triggers.","uniqueKey":"data.triggers.items.[INDEX].schedule.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.triggers.items.[INDEX].schedule","typeLabel":"WorkflowSchedule · object | null"}},"type":"object","required":["id","type","label","enabled","params"],"title":"WorkflowTrigger","uniqueKey":"data.triggers.items.[INDEX]","typeLabel":"WorkflowTrigger · object"},"type":"array","title":"Triggers","isRequired":true,"uniqueKey":"data.triggers","typeLabel":"WorkflowTrigger · object[]"},"steps":{"items":{"properties":{"id":{"type":"string","title":"Id","isRequired":true,"uniqueKey":"data.steps.items.[INDEX].id","typeLabel":"string"},"position":{"type":"integer","title":"Position","isRequired":true,"uniqueKey":"data.steps.items.[INDEX].position","typeLabel":"integer"},"type":{"type":"string","title":"Type","description":"playbook, email_delivery, slack_delivery, or unknown.","isRequired":true,"uniqueKey":"data.steps.items.[INDEX].type","typeLabel":"string"},"targetFileId":{"type":"string","title":"Targetfileid","description":"Playbook or attachment file this step acts on.","isRequired":true,"uniqueKey":"data.steps.items.[INDEX].targetFileId","typeLabel":"string"},"config":{"additionalProperties":true,"type":"object","title":"Config","isRequired":true,"uniqueKey":"data.steps.items.[INDEX].config","typeLabel":"Config · object"},"targets":{"items":{"properties":{"kind":{"type":"string","enum":["email_to","email_cc","email_bcc","slack_channel","slack_user","unknown"],"title":"Kind","description":"email_to, email_cc, email_bcc, slack_channel, slack_user, or unknown.","isRequired":true,"uniqueKey":"data.steps.items.[INDEX].targets.items.[INDEX].kind","typeLabel":"enum\u003cstring>"},"value":{"type":"string","title":"Value","description":"Email address, or Slack channel or user id.","isRequired":true,"uniqueKey":"data.steps.items.[INDEX].targets.items.[INDEX].value","typeLabel":"string"},"displayName":{"type":"string","title":"Displayname","isRequired":true,"uniqueKey":"data.steps.items.[INDEX].targets.items.[INDEX].displayName","typeLabel":"string"}},"type":"object","required":["kind","value","displayName"],"title":"WorkflowStepTarget","uniqueKey":"data.steps.items.[INDEX].targets.items.[INDEX]","typeLabel":"WorkflowStepTarget · object"},"type":"array","title":"Targets","isRequired":true,"uniqueKey":"data.steps.items.[INDEX].targets","typeLabel":"WorkflowStepTarget · object[]"}},"type":"object","required":["id","position","type","targetFileId","config","targets"],"title":"WorkflowStep","description":"One step of a legacy step-shaped workflow. Graph workflows carry a graph instead.","uniqueKey":"data.steps.items.[INDEX]","typeLabel":"WorkflowStep · object"},"type":"array","title":"Steps","isRequired":true,"uniqueKey":"data.steps","typeLabel":"WorkflowStep · object[]"},"graph":{"oneOf":[{"type":"object","title":"Graph","description":"The editable graph document, for graph workflows.","additionalProperties":true,"uniqueKey":"data.graph.oneOf.0","typeLabel":"Graph · object"},{"type":"null","title":"Graph","description":"The editable graph document, for graph workflows.","uniqueKey":"data.graph.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.graph","typeLabel":"Graph · object | null"},"createdAt":{"oneOf":[{"type":"string","title":"Createdat","uniqueKey":"data.createdAt.oneOf.0","typeLabel":"string"},{"type":"null","title":"Createdat","uniqueKey":"data.createdAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.createdAt","typeLabel":"string | null"},"updatedAt":{"oneOf":[{"type":"string","title":"Updatedat","uniqueKey":"data.updatedAt.oneOf.0","typeLabel":"string"},{"type":"null","title":"Updatedat","uniqueKey":"data.updatedAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.updatedAt","typeLabel":"string | null"}},"type":"object","required":["id","projectId","title","description","ownerUserId","status","executionFormat","outputFolder","revision","activeVersionId","triggers","steps"],"title":"Workflow","isRequired":true,"uniqueKey":"data","typeLabel":"Workflow · object"}},"type":"object","required":["data"],"title":"WorkflowResponse","uniqueKey":"","typeLabel":"WorkflowResponse · object"},"examples":{"Example":{"title":"Example","value":{"data":{"id":"\u003cstring>","projectId":"\u003cstring>","title":"\u003cstring>","description":"\u003cstring>","ownerUserId":"\u003cstring>","status":"\u003cstring>","executionFormat":"\u003cstring>","outputFolder":"\u003cstring>","revision":123,"activeVersionId":"\u003cstring>","triggers":[{"id":"\u003cstring>","type":"\u003cstring>","label":"\u003cstring>","enabled":true,"params":{},"schedule":{"type":"\u003cstring>","zoneId":"\u003cstring>","cronExpression":"\u003cstring>","everyMinutes":123,"timeOfDay":"\u003cstring>","runDate":"\u003cstring>","anchorDate":"\u003cstring>","daysOfWeek":["\u003cstring>"],"dayOfMonth":123,"interval":123}}],"steps":[{"id":"\u003cstring>","position":123,"type":"\u003cstring>","targetFileId":"\u003cstring>","config":{},"targets":[{"kind":"email_to","value":"\u003cstring>","displayName":"\u003cstring>"}]}],"graph":{},"createdAt":"\u003cstring>","updatedAt":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"6be79a51-8d88-42b3-b24b-25896f52ba16":{"description":"Invalid request or unsupported option.","content":{"application/problem+json":{"schema":{"description":"Public error envelope (RFC 7807 ``application/problem+json``).\n\nMirrors the body produced by :func:`api_error`. Declaring it in the contract\nlets generated clients type error handling instead of guessing.","properties":{"type":{"description":"URI reference identifying the problem type.","title":"Type","type":"string","isRequired":true,"uniqueKey":"type","typeLabel":"string"},"title":{"description":"Short, human-readable summary of the problem type.","title":"Title","type":"string","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"status":{"description":"HTTP status code.","title":"Status","type":"integer","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"detail":{"description":"Human-readable explanation specific to this occurrence.","title":"Detail","type":"string","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"code":{"description":"Stable, machine-readable error code.","title":"Code","type":"string","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"request_id":{"description":"Correlation id, echoed in the x-request-id header.","title":"Request Id","type":"string","isRequired":true,"uniqueKey":"request_id","typeLabel":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemError","type":"object","uniqueKey":"","typeLabel":"ProblemError · object"},"examples":{"Example":{"title":"Example","value":{"type":"\u003cstring>","title":"\u003cstring>","status":123,"detail":"\u003cstring>","code":"\u003cstring>","request_id":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"8fbb0239-9bcf-4e42-8a3a-552729c348b4":{"description":"Missing, invalid, or expired credentials.","content":{"application/problem+json":{"schema":{"description":"Public error envelope (RFC 7807 ``application/problem+json``).\n\nMirrors the body produced by :func:`api_error`. Declaring it in the contract\nlets generated clients type error handling instead of guessing.","properties":{"type":{"description":"URI reference identifying the problem type.","title":"Type","type":"string","isRequired":true,"uniqueKey":"type","typeLabel":"string"},"title":{"description":"Short, human-readable summary of the problem type.","title":"Title","type":"string","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"status":{"description":"HTTP status code.","title":"Status","type":"integer","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"detail":{"description":"Human-readable explanation specific to this occurrence.","title":"Detail","type":"string","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"code":{"description":"Stable, machine-readable error code.","title":"Code","type":"string","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"request_id":{"description":"Correlation id, echoed in the x-request-id header.","title":"Request Id","type":"string","isRequired":true,"uniqueKey":"request_id","typeLabel":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemError","type":"object","uniqueKey":"","typeLabel":"ProblemError · object"},"examples":{"Example":{"title":"Example","value":{"type":"\u003cstring>","title":"\u003cstring>","status":123,"detail":"\u003cstring>","code":"\u003cstring>","request_id":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"174c9ff3-6c55-404b-bdf2-96d4ccfbf05c":{"description":"Authenticated but missing the required scope.","content":{"application/problem+json":{"schema":{"description":"Public error envelope (RFC 7807 ``application/problem+json``).\n\nMirrors the body produced by :func:`api_error`. Declaring it in the contract\nlets generated clients type error handling instead of guessing.","properties":{"type":{"description":"URI reference identifying the problem type.","title":"Type","type":"string","isRequired":true,"uniqueKey":"type","typeLabel":"string"},"title":{"description":"Short, human-readable summary of the problem type.","title":"Title","type":"string","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"status":{"description":"HTTP status code.","title":"Status","type":"integer","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"detail":{"description":"Human-readable explanation specific to this occurrence.","title":"Detail","type":"string","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"code":{"description":"Stable, machine-readable error code.","title":"Code","type":"string","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"request_id":{"description":"Correlation id, echoed in the x-request-id header.","title":"Request Id","type":"string","isRequired":true,"uniqueKey":"request_id","typeLabel":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemError","type":"object","uniqueKey":"","typeLabel":"ProblemError · object"},"examples":{"Example":{"title":"Example","value":{"type":"\u003cstring>","title":"\u003cstring>","status":123,"detail":"\u003cstring>","code":"\u003cstring>","request_id":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"76fae658-d6d2-4334-b690-c8a635d5df7a":{"description":"Resource not found or not accessible.","content":{"application/problem+json":{"schema":{"description":"Public error envelope (RFC 7807 ``application/problem+json``).\n\nMirrors the body produced by :func:`api_error`. Declaring it in the contract\nlets generated clients type error handling instead of guessing.","properties":{"type":{"description":"URI reference identifying the problem type.","title":"Type","type":"string","isRequired":true,"uniqueKey":"type","typeLabel":"string"},"title":{"description":"Short, human-readable summary of the problem type.","title":"Title","type":"string","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"status":{"description":"HTTP status code.","title":"Status","type":"integer","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"detail":{"description":"Human-readable explanation specific to this occurrence.","title":"Detail","type":"string","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"code":{"description":"Stable, machine-readable error code.","title":"Code","type":"string","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"request_id":{"description":"Correlation id, echoed in the x-request-id header.","title":"Request Id","type":"string","isRequired":true,"uniqueKey":"request_id","typeLabel":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemError","type":"object","uniqueKey":"","typeLabel":"ProblemError · object"},"examples":{"Example":{"title":"Example","value":{"type":"\u003cstring>","title":"\u003cstring>","status":123,"detail":"\u003cstring>","code":"\u003cstring>","request_id":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"1c5f40f4-589a-4174-895a-f1942628c001":{"description":"The workflow changed since the revision you read, the update asked to make it active (which only the activate operation can do), or the request_id was already used. Nothing was applied.","content":{"application/problem+json":{"schema":{"description":"Public error envelope (RFC 7807 ``application/problem+json``).\n\nMirrors the body produced by :func:`api_error`. Declaring it in the contract\nlets generated clients type error handling instead of guessing.","properties":{"type":{"description":"URI reference identifying the problem type.","title":"Type","type":"string","isRequired":true,"uniqueKey":"type","typeLabel":"string"},"title":{"description":"Short, human-readable summary of the problem type.","title":"Title","type":"string","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"status":{"description":"HTTP status code.","title":"Status","type":"integer","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"detail":{"description":"Human-readable explanation specific to this occurrence.","title":"Detail","type":"string","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"code":{"description":"Stable, machine-readable error code.","title":"Code","type":"string","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"request_id":{"description":"Correlation id, echoed in the x-request-id header.","title":"Request Id","type":"string","isRequired":true,"uniqueKey":"request_id","typeLabel":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemError","type":"object","uniqueKey":"","typeLabel":"ProblemError · object"},"examples":{"Example":{"title":"Example","value":{"type":"\u003cstring>","title":"\u003cstring>","status":123,"detail":"\u003cstring>","code":"\u003cstring>","request_id":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"43069f86-e5f9-4616-871e-3bd1c76a451e":{"description":"Validation Error","content":{"application/json":{"schema":{"properties":{"detail":{"items":{"properties":{"loc":{"items":{"oneOf":[{"type":"string","uniqueKey":"detail.items.[INDEX].loc.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"integer","uniqueKey":"detail.items.[INDEX].loc.items.[INDEX].oneOf.1","typeLabel":"integer"}],"uniqueKey":"detail.items.[INDEX].loc.items.[INDEX]","typeLabel":"string | integer"},"type":"array","title":"Location","isRequired":true,"uniqueKey":"detail.items.[INDEX].loc","typeLabel":"(string | integer)[]"},"msg":{"type":"string","title":"Message","isRequired":true,"uniqueKey":"detail.items.[INDEX].msg","typeLabel":"string"},"type":{"type":"string","title":"Error Type","isRequired":true,"uniqueKey":"detail.items.[INDEX].type","typeLabel":"string"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError","uniqueKey":"detail.items.[INDEX]","typeLabel":"ValidationError · object"},"type":"array","title":"Detail","uniqueKey":"detail","typeLabel":"ValidationError · object[]"}},"type":"object","title":"HTTPValidationError","uniqueKey":"","typeLabel":"HTTPValidationError · object"},"examples":{"Example":{"title":"Example","value":{"detail":[{"loc":["\u003cstring>"],"msg":"\u003cstring>","type":"\u003cstring>"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"4acaa76a-4461-415f-884c-deb1ca0a3b52":{"description":"Rate limit exceeded.","content":{"application/problem+json":{"schema":{"description":"Public error envelope (RFC 7807 ``application/problem+json``).\n\nMirrors the body produced by :func:`api_error`. Declaring it in the contract\nlets generated clients type error handling instead of guessing.","properties":{"type":{"description":"URI reference identifying the problem type.","title":"Type","type":"string","isRequired":true,"uniqueKey":"type","typeLabel":"string"},"title":{"description":"Short, human-readable summary of the problem type.","title":"Title","type":"string","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"status":{"description":"HTTP status code.","title":"Status","type":"integer","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"detail":{"description":"Human-readable explanation specific to this occurrence.","title":"Detail","type":"string","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"code":{"description":"Stable, machine-readable error code.","title":"Code","type":"string","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"request_id":{"description":"Correlation id, echoed in the x-request-id header.","title":"Request Id","type":"string","isRequired":true,"uniqueKey":"request_id","typeLabel":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemError","type":"object","uniqueKey":"","typeLabel":"ProblemError · object"},"examples":{"Example":{"title":"Example","value":{"type":"\u003cstring>","title":"\u003cstring>","status":123,"detail":"\u003cstring>","code":"\u003cstring>","request_id":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"63685e2f-375b-424a-970b-2e9ab3388a25":{"description":"Internal server error.","content":{"application/problem+json":{"schema":{"description":"Public error envelope (RFC 7807 ``application/problem+json``).\n\nMirrors the body produced by :func:`api_error`. Declaring it in the contract\nlets generated clients type error handling instead of guessing.","properties":{"type":{"description":"URI reference identifying the problem type.","title":"Type","type":"string","isRequired":true,"uniqueKey":"type","typeLabel":"string"},"title":{"description":"Short, human-readable summary of the problem type.","title":"Title","type":"string","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"status":{"description":"HTTP status code.","title":"Status","type":"integer","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"detail":{"description":"Human-readable explanation specific to this occurrence.","title":"Detail","type":"string","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"code":{"description":"Stable, machine-readable error code.","title":"Code","type":"string","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"request_id":{"description":"Correlation id, echoed in the x-request-id header.","title":"Request Id","type":"string","isRequired":true,"uniqueKey":"request_id","typeLabel":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemError","type":"object","uniqueKey":"","typeLabel":"ProblemError · object"},"examples":{"Example":{"title":"Example","value":{"type":"\u003cstring>","title":"\u003cstring>","status":123,"detail":"\u003cstring>","code":"\u003cstring>","request_id":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"c636197d-2aa6-4f51-8960-ae9f37f1b983":{"description":"The workflows service is temporarily unavailable. Retry this request shortly.","content":{"application/problem+json":{"schema":{"description":"Public error envelope (RFC 7807 ``application/problem+json``).\n\nMirrors the body produced by :func:`api_error`. Declaring it in the contract\nlets generated clients type error handling instead of guessing.","properties":{"type":{"description":"URI reference identifying the problem type.","title":"Type","type":"string","isRequired":true,"uniqueKey":"type","typeLabel":"string"},"title":{"description":"Short, human-readable summary of the problem type.","title":"Title","type":"string","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"status":{"description":"HTTP status code.","title":"Status","type":"integer","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"detail":{"description":"Human-readable explanation specific to this occurrence.","title":"Detail","type":"string","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"code":{"description":"Stable, machine-readable error code.","title":"Code","type":"string","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"request_id":{"description":"Correlation id, echoed in the x-request-id header.","title":"Request Id","type":"string","isRequired":true,"uniqueKey":"request_id","typeLabel":"string"}},"required":["type","title","status","detail","code","request_id"],"title":"ProblemError","type":"object","uniqueKey":"","typeLabel":"ProblemError · object"},"examples":{"Example":{"title":"Example","value":{"type":"\u003cstring>","title":"\u003cstring>","status":123,"detail":"\u003cstring>","code":"\u003cstring>","request_id":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"3dcaeddd-3c5e-4205-b01d-d65dd3a0a7c7":{"SummationMachineAuth":{"type":"oauth2","flows":{"clientCredentials":{"scopes":{"agent:read":"agent:read","agent:write":"agent:write"},"tokenUrl":"/v1/auth/m2m/token"}},"scopes":["agent:write"],"schemeName":"SummationMachineAuth"}}},"servers":{},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"oauth2","flows":{"clientCredentials":{"scopes":{"agent:read":"agent:read","agent:write":"agent:write"},"tokenUrl":"/v1/auth/m2m/token"}},"scopes":["agent:write"],"schemeName":"SummationMachineAuth"},"schema":{"title":"OAuth2 Auth","type":"string","isRequired":true,"description":"The access token received from the authorization server in the OAuth 2.0 flow.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"SummationMachineAuth","name":"Authorization"}],"title":"SummationMachineAuth"}]},"originalFileLocation":"https://api.summation.com/openapi.json"},"subdomain":"summation-676748f5","siteName":"Summation","title":"Create workflow - Summation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-28T20:05:21.560Z","originalFileLocation":"api-reference/workflows/create-workflow.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=\"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=\"Create a workflow in a project you can edit. The workflow is created as a draft and runs nothing until you activate it. You become its owner, and its runs execute as you.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Summation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/summation-676748f5/s-DowS6hFbVgFajy/_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/summation-676748f5/s-DowS6hFbVgFajy/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/summation-676748f5/s-DowS6hFbVgFajy/_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/summation-676748f5/s-DowS6hFbVgFajy/_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/summation-676748f5/s-DowS6hFbVgFajy/_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/summation-676748f5/s-DowS6hFbVgFajy/_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/summation-676748f5/s-DowS6hFbVgFajy/_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/summation-676748f5/s-DowS6hFbVgFajy/_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/summation-676748f5/s-DowS6hFbVgFajy/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create workflow - Summation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Create a workflow in a project you can edit. The workflow is created as a draft and runs nothing until you activate it. You become its owner, and its runs execute as you.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Summation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.summation.com/api-reference/workflows/create-workflow\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://summation-676748f5.mintlify.site/_mintlify/api/og/v2?division=Workflows\u0026amp;title=Create+workflow\u0026amp;description=Create+a+workflow+in+a+project+you+can+edit.+The+workflow+is+created+as+a+draft+and+runs+nothing+until+you+activate+it.+You+become+its+owner%2C+and+its+runs+execu\u0026amp;theme=1190c7185ed5fee9aa38321d\u0026amp;signature=e92c31f89458fb50544e2f845126bf6e6ff73cc071da094609646445e039284c\">\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=\"Create workflow - Summation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Create a workflow in a project you can edit. The workflow is created as a draft and runs nothing until you activate it. You become its owner, and its runs execute as you.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://summation-676748f5.mintlify.site/_mintlify/api/og/v2?division=Workflows\u0026amp;title=Create+workflow\u0026amp;description=Create+a+workflow+in+a+project+you+can+edit.+The+workflow+is+created+as+a+draft+and+runs+nothing+until+you+activate+it.+You+become+its+owner%2C+and+its+runs+execu\u0026amp;theme=1190c7185ed5fee9aa38321d\u0026amp;signature=e92c31f89458fb50544e2f845126bf6e6ff73cc071da094609646445e039284c\">\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/summation-676748f5/s-DowS6hFbVgFajy/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Summation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#000000\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.summation.com/api-reference/workflows/create-workflow\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/workflows/create-workflow.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.summation.com/#organization\",\"name\":\"Summation\",\"url\":\"https://docs.summation.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/summation-676748f5/VNNtt3ifsblE4Ta9/images/summation-logo.svg?fit=max\u0026auto=format\u0026n=VNNtt3ifsblE4Ta9\u0026q=85\u0026s=6d050102e07df435f3532e1a4e34e685\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.summation.com#website\",\"name\":\"Summation\",\"url\":\"https://docs.summation.com\",\"publisher\":{\"@id\":\"https://docs.summation.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.summation.com/api-reference/workflows/create-workflow#webpage\",\"url\":\"https://docs.summation.com/api-reference/workflows/create-workflow\",\"name\":\"Create workflow\",\"description\":\"Create a workflow in a project you can edit. The workflow is created as a draft and runs nothing until you activate it. You become its owner, and its runs execute as you.\",\"dateModified\":\"2026-10-28T20:05:21.560Z\",\"isPartOf\":{\"@id\":\"https://docs.summation.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.summation.com/api-reference/workflows/create-workflow#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.summation.com/api-reference/workflows/create-workflow#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Endpoints\",\"item\":\"https://docs.summation.com/api-reference/auth/create-a-machine-access-token\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Workflows\",\"item\":\"https://docs.summation.com/api-reference/workflows/list-workflows\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Create workflow\",\"item\":\"https://docs.summation.com/api-reference/workflows/create-workflow\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.summation.com/api-reference/workflows/create-workflow#apireference\",\"headline\":\"Create workflow\",\"name\":\"Create workflow\",\"description\":\"Create a workflow in a project you can edit. The workflow is created as a draft and runs nothing until you activate it. You become its owner, and its runs execute as you.\",\"url\":\"https://docs.summation.com/api-reference/workflows/create-workflow\",\"mainEntityOfPage\":{\"@id\":\"https://docs.summation.com/api-reference/workflows/create-workflow#webpage\"},\"dateModified\":\"2026-10-28T20:05:21.560Z\",\"publisher\":{\"@id\":\"https://docs.summation.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.summation.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Summation\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Summation\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/workflows/create-workflow.md","siteName":"Summation","nav":{"global":null,"tabs":[{"tab":"Documentation","icon":"book-open","pages":[{"title":"Documentation","href":"/introduction"}]},{"tab":"Use cases","icon":"lightbulb","pages":[{"title":"Use cases","href":"/use-cases/overview"}]},{"tab":"API","icon":"code","groups":[{"group":"Introduction","pages":[{"title":"Overview","href":"/api/overview"},{"title":"CLI","href":"/api/cli"},{"title":"Authentication","href":"/api/authentication"},{"title":"Conventions","href":"/api/conventions"},{"title":"API coverage","href":"/api/coverage"}]},{"group":"Resources","pages":[{"title":"Conversations","href":"/api/conversations"},{"title":"Projects \u0026 files","href":"/api/projects-and-files"},{"title":"Reports","href":"/api/reports"},{"title":"Playbooks \u0026 schedules","href":"/api/playbooks-and-schedules"},{"title":"Workflows","href":"/api/workflows"},{"title":"Tables \u0026 views","href":"/api/tables"},{"title":"Connections","href":"/api/connections"}]},{"group":"Endpoints","pages":[{"group":"Auth","pages":[{"title":"Create a machine access token","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json post /v1/auth/m2m/token","href":"/api-reference/auth/create-a-machine-access-token"},{"title":"Exchange an identity assertion for a member token","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json post /v1/auth/token-exchange","href":"/api-reference/auth/exchange-an-identity-assertion-for-a-member-token"},{"title":"Show current identity","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json get /v1/me","href":"/api-reference/auth/show-current-identity"},{"title":"Show current identity","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json get /v1/auth/status","href":"/api-reference/auth/show-current-identity-1"},{"title":"Clear client credentials","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json post /v1/auth/logout","href":"/api-reference/auth/clear-client-credentials"}]},{"group":"Tenant","pages":[{"title":"Get organization details","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json get /v1/tenant/org","href":"/api-reference/tenant/get-organization-details"}]},{"group":"Projects","pages":[{"title":"List projects","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json get /v1/projects","href":"/api-reference/projects/list-projects"},{"title":"Create project","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json post /v1/projects","href":"/api-reference/projects/create-project"},{"title":"Show default project","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json get /v1/projects/default","href":"/api-reference/projects/show-default-project"},{"title":"Show project","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json get /v1/projects/{project_id}","href":"/api-reference/projects/show-project"},{"title":"Delete project","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json delete /v1/projects/{project_id}","href":"/api-reference/projects/delete-project"},{"title":"Update project","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json patch /v1/projects/{project_id}","href":"/api-reference/projects/update-project"}]},{"group":"Conversations","pages":[{"title":"List chat models","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json get /v1/chat-models","href":"/api-reference/conversations/list-chat-models"},{"title":"List conversations","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json get /v1/projects/{project_id}/conversations","href":"/api-reference/conversations/list-conversations"},{"title":"Create conversation and stream response","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json post /v1/projects/{project_id}/conversations","href":"/api-reference/conversations/create-conversation-and-stream-response"},{"title":"Show conversation","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json get /v1/projects/{project_id}/conversations/{chat_id}","href":"/api-reference/conversations/show-conversation"},{"title":"Create message and stream response","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json post /v1/projects/{project_id}/conversations/{chat_id}/messages","href":"/api-reference/conversations/create-message-and-stream-response"},{"title":"Stream message events","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json get /v1/projects/{project_id}/conversations/{chat_id}/messages/{message_id}/events","href":"/api-reference/conversations/stream-message-events"},{"title":"Submit message feedback","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json post /v1/projects/{project_id}/conversations/{chat_id}/messages/{message_id}/feedback","href":"/api-reference/conversations/submit-message-feedback"},{"title":"List queued messages","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json get /v1/projects/{project_id}/conversations/{chat_id}/queue","href":"/api-reference/conversations/list-queued-messages"},{"title":"Show queued message","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json get /v1/projects/{project_id}/conversations/{chat_id}/queue/{queued_message_id}","href":"/api-reference/conversations/show-queued-message"},{"title":"Withdraw queued message","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json delete /v1/projects/{project_id}/conversations/{chat_id}/queue/{queued_message_id}","href":"/api-reference/conversations/withdraw-queued-message"},{"title":"Resume queued messages","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json post /v1/projects/{project_id}/conversations/{chat_id}/queue/resume","href":"/api-reference/conversations/resume-queued-messages"},{"title":"Cancel analyst reply","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json post /v1/projects/{project_id}/conversations/{chat_id}/messages/{message_id}/cancel","href":"/api-reference/conversations/cancel-analyst-reply"}]},{"group":"Reports","pages":[{"title":"List reports","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json get /v1/projects/{project_id}/reports","href":"/api-reference/reports/list-reports"},{"title":"Generate report and stream response","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json post /v1/projects/{project_id}/reports/generations","href":"/api-reference/reports/generate-report-and-stream-response"},{"title":"Show report","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json get /v1/projects/{project_id}/reports/{report_id}","href":"/api-reference/reports/show-report"},{"title":"Delete report","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json delete /v1/projects/{project_id}/reports/{report_id}","href":"/api-reference/reports/delete-report"},{"title":"Verify report and stream response","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json post /v1/projects/{project_id}/reports/{report_id}/verifications","href":"/api-reference/reports/verify-report-and-stream-response"},{"title":"Export report content","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json get /v1/projects/{project_id}/reports/{report_id}/content","href":"/api-reference/reports/export-report-content"}]},{"group":"Playbooks","pages":[{"title":"List playbooks","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json get /v1/projects/{project_id}/playbooks","href":"/api-reference/playbooks/list-playbooks"},{"title":"Show playbook","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json get /v1/projects/{project_id}/playbooks/{playbook_id}","href":"/api-reference/playbooks/show-playbook"}]},{"group":"Files","pages":[{"title":"List or search files","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json get /v1/projects/{project_id}/files","href":"/api-reference/files/list-or-search-files"},{"title":"Write file content","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json put /v1/projects/{project_id}/files/content","href":"/api-reference/files/write-file-content"},{"title":"Show file","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json get /v1/projects/{project_id}/files/{file_id}","href":"/api-reference/files/show-file"},{"title":"Delete file","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json delete /v1/projects/{project_id}/files/{file_id}","href":"/api-reference/files/delete-file"},{"title":"Create file download URL","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json get /v1/projects/{project_id}/files/{file_id}/download-url","href":"/api-reference/files/create-file-download-url"},{"title":"Download file content","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json get /v1/projects/{project_id}/files/{file_id}/content","href":"/api-reference/files/download-file-content"},{"title":"Create a presigned upload","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json post /v1/projects/{project_id}/files/uploads","href":"/api-reference/files/create-a-presigned-upload"},{"title":"Finalize a presigned upload","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json post /v1/projects/{project_id}/files/uploads/{upload_id}/finalize","href":"/api-reference/files/finalize-a-presigned-upload"},{"title":"Import file through agent workflow","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json post /v1/projects/{project_id}/files/{file_id}/imports","href":"/api-reference/files/import-file-through-agent-workflow"}]},{"group":"Catalog Entries","pages":[{"title":"List project catalog entries","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json get /v1/projects/{project_id}/catalog-entries","href":"/api-reference/catalog-entries/list-project-catalog-entries"},{"title":"Attach table or view to project catalog","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json post /v1/projects/{project_id}/catalog-entries","href":"/api-reference/catalog-entries/attach-table-or-view-to-project-catalog"},{"title":"Show project catalog entry","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json get /v1/projects/{project_id}/catalog-entries/{catalog_entry_id}","href":"/api-reference/catalog-entries/show-project-catalog-entry"},{"title":"Detach project catalog entry","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json delete /v1/projects/{project_id}/catalog-entries/{catalog_entry_id}","href":"/api-reference/catalog-entries/detach-project-catalog-entry"},{"title":"Refresh project catalog entry","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json post /v1/projects/{project_id}/catalog-entries/{catalog_entry_id}/refreshes","href":"/api-reference/catalog-entries/refresh-project-catalog-entry"}]},{"group":"Data Connectors","pages":[{"title":"List connections","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json get /v1/connections/data","href":"/api-reference/data-connectors/list-connections"},{"title":"Create connection","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json post /v1/connections/data","href":"/api-reference/data-connectors/create-connection"},{"title":"Update connection snapshot policy","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json patch /v1/connections/data/{connection_id}/snapshot-config","href":"/api-reference/data-connectors/update-connection-snapshot-policy"},{"title":"Update connection settings","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json patch /v1/connections/data/{connection_id}/config","href":"/api-reference/data-connectors/update-connection-settings"},{"title":"List connector types","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json get /v1/connections/data/types","href":"/api-reference/data-connectors/list-connector-types"},{"title":"Show connector type","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json get /v1/connections/data/types/{connector_type}","href":"/api-reference/data-connectors/show-connector-type"},{"title":"Show connection","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json get /v1/connections/data/{connection_id}","href":"/api-reference/data-connectors/show-connection"},{"title":"Delete connection","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json delete /v1/connections/data/{connection_id}","href":"/api-reference/data-connectors/delete-connection"},{"title":"Update connection","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json patch /v1/connections/data/{connection_id}","href":"/api-reference/data-connectors/update-connection"},{"title":"Browse connection resources","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json post /v1/connections/data/{connection_id}/resources","href":"/api-reference/data-connectors/browse-connection-resources"},{"title":"List connection datasets","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json get /v1/connections/data/{connection_id}/datasets","href":"/api-reference/data-connectors/list-connection-datasets"},{"title":"Attach connection datasets","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json post /v1/connections/data/{connection_id}/datasets","href":"/api-reference/data-connectors/attach-connection-datasets"},{"title":"Detach connection dataset","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json delete /v1/connections/data/{connection_id}/datasets/{dataset_id}","href":"/api-reference/data-connectors/detach-connection-dataset"},{"title":"Update connection dataset","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json patch /v1/connections/data/{connection_id}/datasets/{dataset_id}","href":"/api-reference/data-connectors/update-connection-dataset"},{"title":"Test connection","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json post /v1/connections/data/{connection_id}/tests","href":"/api-reference/data-connectors/test-connection"},{"title":"Snapshot dataset","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json post /v1/connections/data/{connection_id}/datasets/{dataset_id}/snapshots","href":"/api-reference/data-connectors/snapshot-dataset"},{"title":"List snapshot runs","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json get /v1/connections/data/{connection_id}/snapshots","href":"/api-reference/data-connectors/list-snapshot-runs"}]},{"group":"App Connectors","pages":[{"title":"List app connections","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json get /v1/connections/app","href":"/api-reference/app-connectors/list-app-connections"},{"title":"List available app connectors","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json get /v1/connections/app/catalog","href":"/api-reference/app-connectors/list-available-app-connectors"},{"title":"List app connector tools","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json get /v1/connections/app/catalog/{app_key}/tools","href":"/api-reference/app-connectors/list-app-connector-tools"},{"title":"Show app connection","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json get /v1/connections/app/{connection_id}","href":"/api-reference/app-connectors/show-app-connection"},{"title":"Delete app connection","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json delete /v1/connections/app/{connection_id}","href":"/api-reference/app-connectors/delete-app-connection"},{"title":"Update app connection","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json patch /v1/connections/app/{connection_id}","href":"/api-reference/app-connectors/update-app-connection"},{"title":"Disconnect app connection","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json post /v1/connections/app/{connection_id}/disconnect","href":"/api-reference/app-connectors/disconnect-app-connection"}]},{"group":"Tables","pages":[{"title":"List tables","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json get /v1/tables","href":"/api-reference/tables/list-tables"},{"title":"List table catalog","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json get /v1/tables/catalog","href":"/api-reference/tables/list-table-catalog"},{"title":"Show table","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json get /v1/tables/{table_id}","href":"/api-reference/tables/show-table"},{"title":"Delete table","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json delete /v1/tables/{table_id}","href":"/api-reference/tables/delete-table"},{"title":"Fetch table data","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json get /v1/tables/{table_id}/data","href":"/api-reference/tables/fetch-table-data"},{"title":"Show table catalog","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json get /v1/tables/{table_id}/catalog","href":"/api-reference/tables/show-table-catalog"},{"title":"Update table catalog","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json patch /v1/tables/{table_id}/catalog","href":"/api-reference/tables/update-table-catalog"},{"title":"Upsert rows into a table","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json put /v1/tables/{table_id}/rows","href":"/api-reference/tables/upsert-rows-into-a-table"},{"title":"Append rows to a table","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json post /v1/tables/{table_id}/rows","href":"/api-reference/tables/append-rows-to-a-table"},{"title":"Create asset upload URL","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json post /v1/assets/upload-urls","href":"/api-reference/tables/create-asset-upload-url"},{"title":"Preview import asset","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json post /v1/assets/{asset_id}/previews","href":"/api-reference/tables/preview-import-asset"},{"title":"Create table import","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json post /v1/table-imports","href":"/api-reference/tables/create-table-import"},{"title":"Show table import","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json get /v1/table-imports/{import_id}","href":"/api-reference/tables/show-table-import"},{"title":"Submit a NetSuite REST source page","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json post /v1/data-syncs/{sync_id}/pages","href":"/api-reference/tables/submit-a-netsuite-rest-source-page"},{"title":"Get the committed source checkpoint","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json get /v1/data-syncs/{sync_id}/checkpoint","href":"/api-reference/tables/get-the-committed-source-checkpoint"},{"title":"Get a source page","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json get /v1/data-syncs/{sync_id}/pages/{page_id}","href":"/api-reference/tables/get-a-source-page"},{"title":"Create a provider snapshot upload","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json post /v1/data-syncs/{sync_id}/snapshots","href":"/api-reference/tables/create-a-provider-snapshot-upload"},{"title":"Stage one provider snapshot page","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json post /v1/data-syncs/{sync_id}/snapshots/{snapshot_id}/pages","href":"/api-reference/tables/stage-one-provider-snapshot-page"},{"title":"Commit a provider snapshot","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json post /v1/data-syncs/{sync_id}/snapshots/{snapshot_id}/complete","href":"/api-reference/tables/commit-a-provider-snapshot"},{"title":"Get a provider snapshot","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json get /v1/data-syncs/{sync_id}/snapshots/{snapshot_id}","href":"/api-reference/tables/get-a-provider-snapshot"},{"title":"Create an ingestion batch","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json post /v1/tables/{table_id}/ingestion-batches","href":"/api-reference/tables/create-an-ingestion-batch"},{"title":"Create a batch part upload URL","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json post /v1/tables/{table_id}/ingestion-batches/{batch_id}/parts/{part_number}/upload-url","href":"/api-reference/tables/create-a-batch-part-upload-url"},{"title":"Commit an ingestion batch","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json post /v1/tables/{table_id}/ingestion-batches/{batch_id}/commit","href":"/api-reference/tables/commit-an-ingestion-batch"},{"title":"Get an ingestion batch","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json get /v1/tables/{table_id}/ingestion-batches/{batch_id}","href":"/api-reference/tables/get-an-ingestion-batch"},{"title":"Abort an ingestion batch","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json delete /v1/tables/{table_id}/ingestion-batches/{batch_id}","href":"/api-reference/tables/abort-an-ingestion-batch"}]},{"group":"Views","pages":[{"title":"List views","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json get /v1/views","href":"/api-reference/views/list-views"},{"title":"List view catalog","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json get /v1/views/catalog","href":"/api-reference/views/list-view-catalog"},{"title":"Show view","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json get /v1/views/{view_id}","href":"/api-reference/views/show-view"},{"title":"Delete view","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json delete /v1/views/{view_id}","href":"/api-reference/views/delete-view"},{"title":"Fetch view data","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json get /v1/views/{view_id}/data","href":"/api-reference/views/fetch-view-data"},{"title":"Show view catalog","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json get /v1/views/{view_id}/catalog","href":"/api-reference/views/show-view-catalog"},{"title":"Update view catalog","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json patch /v1/views/{view_id}/catalog","href":"/api-reference/views/update-view-catalog"}]},{"group":"Query Executions","pages":[{"title":"Execute read-only SQL query","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json post /v1/query-executions","href":"/api-reference/query-executions/execute-read-only-sql-query"}]},{"group":"Grid","pages":[{"title":"Show grid status","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json get /v1/grid/status","href":"/api-reference/grid/show-grid-status"},{"title":"Show grid diff","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json get /v1/grid/diff","href":"/api-reference/grid/show-grid-diff"},{"title":"Validate grid","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json get /v1/grid/validation","href":"/api-reference/grid/validate-grid"},{"title":"Synchronize materialized table","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json post /v1/grid/tables/{table_id}/synchronizations","href":"/api-reference/grid/synchronize-materialized-table"},{"title":"Create grid table","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json post /v1/grid/tables","href":"/api-reference/grid/create-grid-table"},{"title":"Start async table materialization or refresh","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json post /v1/grid/tables/{table_id}/materializations","href":"/api-reference/grid/start-async-table-materialization-or-refresh"},{"title":"Get table materialization status","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json get /v1/grid/tables/{table_id}/materializations/{run_id}","href":"/api-reference/grid/get-table-materialization-status"},{"title":"Materialize calculation table","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json post /v1/grid/tables/{table_id}/materialize","href":"/api-reference/grid/materialize-calculation-table"},{"title":"Update calculation table query","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json patch /v1/grid/tables/{table_id}","href":"/api-reference/grid/update-calculation-table-query"},{"title":"List table changes","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json get /v1/grid/tables/{table_id}/changes","href":"/api-reference/grid/list-table-changes"},{"title":"Get table change","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json get /v1/grid/tables/{table_id}/changes/{change_id}","href":"/api-reference/grid/get-table-change"},{"title":"Roll back failed table change","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json post /v1/grid/tables/{table_id}/changes/{change_id}/rollback","href":"/api-reference/grid/roll-back-failed-table-change"},{"title":"Show table lineage","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json get /v1/grid/tables/{table_id}/lineage","href":"/api-reference/grid/show-table-lineage"}]},{"group":"Schedules","pages":[{"title":"List schedules","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json get /v1/schedules","href":"/api-reference/schedules/list-schedules"},{"title":"Create schedule","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json post /v1/schedules","href":"/api-reference/schedules/create-schedule"},{"title":"Show schedule","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json get /v1/schedules/{schedule_id}","href":"/api-reference/schedules/show-schedule"},{"title":"Update schedule","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json put /v1/schedules/{schedule_id}","href":"/api-reference/schedules/update-schedule"},{"title":"Delete schedule","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json delete /v1/schedules/{schedule_id}","href":"/api-reference/schedules/delete-schedule"},{"title":"Pause schedule","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json post /v1/schedules/{schedule_id}/pause","href":"/api-reference/schedules/pause-schedule"},{"title":"Resume schedule","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json post /v1/schedules/{schedule_id}/resume","href":"/api-reference/schedules/resume-schedule"},{"title":"List schedule runs","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json get /v1/schedules/{schedule_id}/runs","href":"/api-reference/schedules/list-schedule-runs"},{"title":"Run schedule now","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json post /v1/schedules/{schedule_id}/runs","href":"/api-reference/schedules/run-schedule-now"}]},{"group":"SumApps","pages":[{"title":"List the tenant's deployed SumApps","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json get /v1/sum-apps","href":"/api-reference/sumapps/list-the-tenants-deployed-sumapps"},{"title":"Register a deployed SumApp","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json post /v1/sum-apps","href":"/api-reference/sumapps/register-a-deployed-sumapp"},{"title":"Deregister a SumApp","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json delete /v1/sum-apps/{slug}","href":"/api-reference/sumapps/deregister-a-sumapp"}]},{"group":"Verification Tests","pages":[{"title":"List custom verification tests","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json get /v1/verification-tests","href":"/api-reference/verification-tests/list-custom-verification-tests"},{"title":"Create custom verification tests","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json post /v1/verification-tests","href":"/api-reference/verification-tests/create-custom-verification-tests"},{"title":"List verification-test overlays","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json get /v1/verification-tests/attachments","href":"/api-reference/verification-tests/list-verification-test-overlays"},{"title":"Create verification-test overlay","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json post /v1/verification-tests/attachments","href":"/api-reference/verification-tests/create-verification-test-overlay"},{"title":"Detach verification-test overlay","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json delete /v1/verification-tests/attachments/{attachment_id}","href":"/api-reference/verification-tests/detach-verification-test-overlay"},{"title":"Preview effective verification tests","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json get /v1/verification-tests/effective","href":"/api-reference/verification-tests/preview-effective-verification-tests"}]},{"group":"Workflows","pages":[{"title":"List workflows","description":"List the workflows you own, newest page first. Narrow to one project with project_id. Workflows in every state are returned, including paused and archived ones, so read the status field rather than assuming a listed workflow runs.","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json get /v1/workflows","href":"/api-reference/workflows/list-workflows"},{"title":"Create workflow","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json post /v1/workflows","href":"/api-reference/workflows/create-workflow"},{"title":"List workflow node types","description":"List the node types you may use in a workflow graph, including their input and output ports and machine-readable config schemas. The list reflects what your organization has enabled, so build a graph only from the types it returns. Required config fields are required for activation; drafts may omit them while they are being edited.","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json get /v1/workflows/node-types","href":"/api-reference/workflows/list-workflow-node-types"},{"title":"Show workflow","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json get /v1/workflows/{workflow_id}","href":"/api-reference/workflows/show-workflow"},{"title":"Update workflow","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json put /v1/workflows/{workflow_id}","href":"/api-reference/workflows/update-workflow"},{"title":"Activate workflow","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json post /v1/workflows/{workflow_id}/activate","href":"/api-reference/workflows/activate-workflow"},{"title":"List workflow versions","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json get /v1/workflows/{workflow_id}/versions","href":"/api-reference/workflows/list-workflow-versions"},{"title":"List workflow runs","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json get /v1/workflows/{workflow_id}/runs","href":"/api-reference/workflows/list-workflow-runs"},{"title":"Run workflow now","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json post /v1/workflows/{workflow_id}/runs","href":"/api-reference/workflows/run-workflow-now"},{"title":"Show workflow run","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json get /v1/workflows/{workflow_id}/runs/{run_id}","href":"/api-reference/workflows/show-workflow-run"}]}]}]}]},"basePath":"","title":"Create workflow - Summation","buildId":"dpl_4D8r1dHg6bQcRuBgQyL3z9waJJtn","deploymentId":"dpl_4D8r1dHg6bQcRuBgQyL3z9waJJtn","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-dD8DedlW.js","utils-BgJ6PauS.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-m4sNRkou.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Dg97LVEU.js","snippetPresets-C6CxWGOo.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-CKiRf67B.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CDY0tBIx.js","shallow-BHHaYlmm.js","getApiPlaygroundDisplay-D6K3-cVX.js","CodeSnippet-BrS3fDep.js","CodeSnippets-Dkf1llUu.js","Page-DOwQSAHT.js","getPastedJson-3JcMsaes.js","icon-CWSTKRsN.js","MethodPill-t_TXGK5I.js","DuplicateIcon-DcjhdAbh.js","createIcon-2JHmGxKn.js","DynamicMarkdown-DMUWO-az.js","SectionHeading-DxvGHAss.js","axios-vUo_bRtp.js","Markdown-cyvaulBW.js","clsx-DzViKcUj.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CU0Gjyt0.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-CuigkklY.js"]}