Replace a workflow’s editable state. The request is the complete desired state: triggers it omits are deleted, and a graph it omits is left untouched. Editing changes what the next activation would run, never what an active schedule is running now.
The access token received from the authorization server in the OAuth 2.0 flow.
Scopes
agent:write
agent:write
Path Parameters
workflow_id
string
required
Body
application/json
A full replacement of a workflow's editable state.
Editing a workflow changes what the NEXT activation would run, never what an already
active schedule is running.
This is the read-modify-write half of the surface, so it takes a workflow exactly as a GET
renders it, plus expected_revision: the fields a workflow reports but does not let you
set — its id, owner, execution format, revision, active version, run steps and timestamps —
are dropped rather than refused. Anything else it does not recognise is still a 422, so a
misspelled field cannot silently skip part of the change.
status is the one field that is writable AND readable with a value the write half cannot
mint, so it is accepted as an echo rather than dropped: see its description and
update_workflow.
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
expected_revision
integer
required
The revision you last read. The update is applied only if the workflow is still at that revision; otherwise nothing changes and the request conflicts. This is what stops a stale client deleting another client's triggers.
Required range: x >= 0
description
string
default:""
Optional longer description.
Maximum string length: 2000
status
enum<string> | null
New workflow state. Omit to leave it unchanged. active is accepted only as an echo: an already active workflow can be handed back exactly as it reads, and the update leaves it active. It cannot be used to ACTIVATE a workflow — that is the activate operation, which freezes the version that runs — so asking for active on a workflow that is not already active is refused.
Available options:
draft,
active,
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
Replacement graph document, in the same shape and with the same trigger and edge rules as on create: send the full desired document, since what you send replaces the stored graph rather than merging into it. Omit to leave the stored graph untouched. Serializes to at most 200000 characters.
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/update-workflow","slug":"/api-reference/workflows/update-workflow","pageMetadata":{"title":"Update workflow","description":"Replace a workflow's editable state. The request is the complete desired state: triggers it omits are deleted, and a graph it omits is left untouched. Editing changes what the next activation would run, never what an active schedule is running now.","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json put /v1/workflows/{workflow_id}","href":"/api-reference/workflows/update-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: \"Replace a workflow’s editable state. The request is the complete desired state: triggers it omits are deleted, and a graph it omits is left untouched. Editing changes what the next activation would run, never what an active schedule is running now.\"\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":"Update workflow","description":"Replace a workflow's editable state. The request is the complete desired state: triggers it omits are deleted, and a graph it omits is left untouched. Editing changes what the next activation would run, never what an active schedule is running now.","deprecated":null,"version":null,"openapi":"https://api.summation.com/openapi.json put /v1/workflows/{workflow_id}","href":"/api-reference/workflows/update-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":"Update workflow","description":"Replace a workflow's editable state. The request is the complete desired state: triggers it omits are deleted, and a graph it omits is left untouched. Editing changes what the next activation would run, never what an active schedule is running now.","operationId":"update_workflow","security":["889fcc1d-6777-487c-bb04-2e596344bddd"],"parameters":["bb00fce0-4020-4bfc-a626-6ac8c3cab731"],"requestBody":"7289606a-d8df-4c46-a3b9-190a4c5ce0f0","responses":{"200":"143d8a5a-0214-422e-8de8-34bdd2d9e363","400":"b59cb032-c75e-4bb6-902c-ce231807c619","401":"292cec97-8426-48b3-8d2f-af72380d6d99","403":"707b8d8e-fcca-4d8a-893e-64792379bb4f","404":"5b63645e-4aac-4a5b-b40c-3f59de8ea699","409":"cbe11d2d-7826-4e3d-a31a-ddd68a1c4061","422":"c67759fe-9527-4fc5-a600-195bedc86b3e","429":"72af09b2-3178-42d8-85c0-121d30820586","500":"75f030d1-96f6-4028-943a-a67b14232c41","503":"3060bfbd-3992-45be-852f-8c9d36b3c8fe"},"method":"put","type":"path","servers":[],"path":"/v1/workflows/{workflow_id}","baseUrlOptions":[],"title":"Update workflow","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"bb00fce0-4020-4bfc-a626-6ac8c3cab731":{"name":"workflow_id","in":"path","required":true,"schema":{"type":"string","title":"Workflow Id","isRequired":true,"uniqueKey":"","typeLabel":"string"}}},"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"},"expected_revision":{"type":"integer","minimum":0,"title":"Expected Revision","description":"The revision you last read. The update is applied only if the workflow is still at that revision; otherwise nothing changes and the request conflicts. This is what stops a stale client deleting another client's triggers.","isRequired":true,"uniqueKey":"expected_revision","typeLabel":"integer"},"description":{"type":"string","maxLength":2000,"title":"Description","description":"Optional longer description.","default":"","uniqueKey":"description","typeLabel":"string"},"status":{"oneOf":[{"type":"string","title":"Status","description":"New workflow state. Omit to leave it unchanged. active is accepted only as an echo: an already active workflow can be handed back exactly as it reads, and the update leaves it active. It cannot be used to ACTIVATE a workflow — that is the activate operation, which freezes the version that runs — so asking for active on a workflow that is not already active is refused.","enum":["draft","active","paused","archived"],"uniqueKey":"status.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","title":"Status","description":"New workflow state. Omit to leave it unchanged. active is accepted only as an echo: an already active workflow can be handed back exactly as it reads, and the update leaves it active. It cannot be used to ACTIVATE a workflow — that is the activate operation, which freezes the version that runs — so asking for active on a workflow that is not already active is refused.","uniqueKey":"status.oneOf.1","typeLabel":"null"}],"uniqueKey":"status","typeLabel":"enum\u003cstring> | null"},"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":"Replacement graph document, in the same shape and with the same trigger and edge rules as on create: send the full desired document, since what you send replaces the stored graph rather than merging into it. Omit to leave the stored graph untouched. Serializes to at most 200000 characters.","additionalProperties":true,"uniqueKey":"graph.oneOf.0","typeLabel":"Graph · object"},{"type":"null","title":"Graph","description":"Replacement graph document, in the same shape and with the same trigger and edge rules as on create: send the full desired document, since what you send replaces the stored graph rather than merging into it. Omit to leave the stored graph untouched. Serializes to at most 200000 characters.","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","expected_revision"],"title":"WorkflowUpdateRequest","description":"A full replacement of a workflow's editable state.\n\nEditing a workflow changes what the NEXT activation would run, never what an already\nactive schedule is running.\n\nThis is the read-modify-write half of the surface, so it takes a workflow exactly as a GET\nrenders it, plus ``expected_revision``: the fields a workflow reports but does not let you\nset — its id, owner, execution format, revision, active version, run steps and timestamps —\nare dropped rather than refused. Anything else it does not recognise is still a 422, so a\nmisspelled field cannot silently skip part of the change.\n\n``status`` is the one field that is writable AND readable with a value the write half cannot\nmint, so it is accepted as an echo rather than dropped: see its description and\n``update_workflow``.","uniqueKey":"","typeLabel":"WorkflowUpdateRequest · object"},"examples":{"Example":{"title":"Example","value":{"project_id":"\u003cstring>","title":"\u003cstring>","expected_revision":1,"description":"","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":{"143d8a5a-0214-422e-8de8-34bdd2d9e363":{"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"},"b59cb032-c75e-4bb6-902c-ce231807c619":{"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"},"292cec97-8426-48b3-8d2f-af72380d6d99":{"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"},"707b8d8e-fcca-4d8a-893e-64792379bb4f":{"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"},"5b63645e-4aac-4a5b-b40c-3f59de8ea699":{"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"},"cbe11d2d-7826-4e3d-a31a-ddd68a1c4061":{"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"},"c67759fe-9527-4fc5-a600-195bedc86b3e":{"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"},"72af09b2-3178-42d8-85c0-121d30820586":{"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"},"75f030d1-96f6-4028-943a-a67b14232c41":{"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"},"3060bfbd-3992-45be-852f-8c9d36b3c8fe":{"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":{"889fcc1d-6777-487c-bb04-2e596344bddd":{"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":"Update workflow - Summation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-28T20:05:21.589Z","originalFileLocation":"api-reference/workflows/update-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=\"Replace a workflow\u0026#x27;s editable state. The request is the complete desired state: triggers it omits are deleted, and a graph it omits is left untouched. Editing changes what the next activation would run, never what an active schedule is running now.\">\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=\"Update workflow - Summation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Replace a workflow\u0026#x27;s editable state. The request is the complete desired state: triggers it omits are deleted, and a graph it omits is left untouched. Editing changes what the next activation would run, never what an active schedule is running now.\">\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/update-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=Update+workflow\u0026amp;description=Replace+a+workflow%27s+editable+state.+The+request+is+the+complete+desired+state%3A+triggers+it+omits+are+deleted%2C+and+a+graph+it+omits+is+left+untouched.+Editing+c\u0026amp;theme=1190c7185ed5fee9aa38321d\u0026amp;signature=afb8f2b90ee7de62faeb6709a719f89f9eb7d5d8e3a59245a21818b6907c2e4b\">\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=\"Update workflow - Summation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Replace a workflow\u0026#x27;s editable state. The request is the complete desired state: triggers it omits are deleted, and a graph it omits is left untouched. Editing changes what the next activation would run, never what an active schedule is running now.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://summation-676748f5.mintlify.site/_mintlify/api/og/v2?division=Workflows\u0026amp;title=Update+workflow\u0026amp;description=Replace+a+workflow%27s+editable+state.+The+request+is+the+complete+desired+state%3A+triggers+it+omits+are+deleted%2C+and+a+graph+it+omits+is+left+untouched.+Editing+c\u0026amp;theme=1190c7185ed5fee9aa38321d\u0026amp;signature=afb8f2b90ee7de62faeb6709a719f89f9eb7d5d8e3a59245a21818b6907c2e4b\">\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/update-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/update-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/update-workflow#webpage\",\"url\":\"https://docs.summation.com/api-reference/workflows/update-workflow\",\"name\":\"Update workflow\",\"description\":\"Replace a workflow's editable state. The request is the complete desired state: triggers it omits are deleted, and a graph it omits is left untouched. Editing changes what the next activation would run, never what an active schedule is running now.\",\"dateModified\":\"2026-10-28T20:05:21.589Z\",\"isPartOf\":{\"@id\":\"https://docs.summation.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.summation.com/api-reference/workflows/update-workflow#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.summation.com/api-reference/workflows/update-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\":\"Update workflow\",\"item\":\"https://docs.summation.com/api-reference/workflows/update-workflow\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.summation.com/api-reference/workflows/update-workflow#apireference\",\"headline\":\"Update workflow\",\"name\":\"Update workflow\",\"description\":\"Replace a workflow's editable state. The request is the complete desired state: triggers it omits are deleted, and a graph it omits is left untouched. Editing changes what the next activation would run, never what an active schedule is running now.\",\"url\":\"https://docs.summation.com/api-reference/workflows/update-workflow\",\"mainEntityOfPage\":{\"@id\":\"https://docs.summation.com/api-reference/workflows/update-workflow#webpage\"},\"dateModified\":\"2026-10-28T20:05:21.589Z\",\"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/update-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","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","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","description":"Show one workflow you own, with its triggers, its graph, and the revision to pass back when you update or activate it.","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","description":"Freeze the workflow as it stands into a new version, make that the version it runs, and set it active. From here its schedules fire that frozen definition, so this can start sending outbound email and Slack messages to the recipients the workflow names. Later edits do not change what an activated workflow runs — activate again to ship them.","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":"Update 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"]}