Optional key that makes the request idempotent. Retrying with the same key returns the original response instead of repeating the operation; keys expire after 24 hours. Any string up to 256 characters. See Idempotency.
When true, no step of the run sends an interaction (MFA code, security question) to your user. An interaction that needs a person fails the run with interaction_suppressed, and the credential stays valid. Defaults to false.
Outcome once terminal: success only when every task run succeeded, failure if any failed, unknown otherwise. null while running and for a canceled run.
The session every step of this run executes in. Prefixed with sess_. Assigned when the run is created through the API, or when a trigger-created run is admitted, so null while such a run is queued.
true when the run was created with interactions_suppressed. Omitted otherwise.
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Deck Docs","description":"Deck is the infrastructure layer for accessing user-permissioned data across industries.","colors":{"primary":"#60917e","light":"#60917e","dark":"#60917e"},"logo":{"light":"https://mintcdn.com/decksoftwareinc/qU-Ph3TxWRaVaZ4z/logo/light.svg?fit=max\u0026auto=format\u0026n=qU-Ph3TxWRaVaZ4z\u0026q=85\u0026s=7219c0996a361a0efa1315710acaece8","dark":"https://mintcdn.com/decksoftwareinc/jwJI_GBuvjfYMken/logo/dark.svg?fit=max\u0026auto=format\u0026n=jwJI_GBuvjfYMken\u0026q=85\u0026s=e9bd389078aeea4f50927a177953c988"},"favicon":"https://mintcdn.com/decksoftwareinc/jwJI_GBuvjfYMken/favicon.png?fit=max\u0026auto=format\u0026n=jwJI_GBuvjfYMken\u0026q=85\u0026s=2346acf6ab834aa5c9464f3061102418","appearance":{"default":"dark","strict":true},"background":{},"navbar":{"primary":{"type":"button","label":"Console","href":"https://console.deck.co"}},"footer":{"socials":{"website":"https://deck.co","github":"https://github.com/buildwithdeck","linkedin":"https://www.linkedin.com/company/deck-platform"}},"fonts":{"heading":{"family":"Plain","weight":500},"body":{"family":"Plain","weight":400}},"integrations":{"ga4":{"measurementId":"G-7797442138"}},"contextual":{"options":["copy","view","chatgpt","claude","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"decksoftwareinc","hasAudioNarration":false,"actualSubdomain":"decksoftwareinc","customDomains":["docs.deck.co"],"gitSource":{"type":"github","owner":"buildwithdeck","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6adbd354158f708b7a443742","collectionId":"7d2b213e-1a29-4f61-bb67-19765164898b","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6adbd354158f708b7a443742"},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae37cd920e64767276c8f15","clientVersion":"0.0.4006","searchFilterCounts":[{"language":"default","tag":"API Reference","count":65},{"language":"default","tag":"Guides","count":58},{"language":"default","tag":"Development","count":16},{"language":"default","tag":"Get Started","count":16},{"language":"default","tag":"Concepts","count":10},{"language":"default","tag":"Workflows","count":10},{"language":"default","tag":"API","count":9},{"language":"default","tag":"Platform","count":7},{"language":"default","tag":"Event Destinations","count":7},{"language":"default","tag":"Task Runs","count":7}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"@font-face{font-family:'Plain';src:url(/fonts/PlainRegular.otf) format('opentype');font-weight:400;font-style:normal}@font-face{font-family:'Plain';src:url(/fonts/PlainMedium.otf) format('opentype');font-weight:500;font-style:normal}*,.accordion-group details.accordion,.mdx-content .frame img,.mdx-content [data-name=frame] img{border-radius:0!important}:root{--docs-sidebar-width:18rem;--docs-toc-width:16.5rem;--docs-api-code-width:34rem;--docs-content-max:48rem;--docs-frame-pad:1.5rem;--docs-sidebar-pad-x:1rem;--docs-sidebar-item-pad-x:0.75rem;--docs-nav-pad-x:calc(var(--docs-sidebar-pad-x) + var(--docs-sidebar-item-pad-x));--docs-border:rgba(246, 246, 246, 0.08);--docs-surface:rgba(246, 246, 246, 0.06);--docs-code-bg:rgba(246, 246, 246, 0.03);--docs-code-radius:8px;--docs-note-accent:#547DC5;--docs-note-text:#A2B9E2;--docs-warning-accent:#FDFAC3;--docs-tip-accent:#286650;--docs-tip-text:#7AAB98;--docs-check-accent:#60917E;--docs-info-text:#F6F6F6;--docs-page-end-gap:2.5rem}:root.dark{--tw-text-opacity:1;--text-primary:#F6F6F6;--text-secondary:#F6F6F6B3}.dark body{color:#f6f6f6}.dark .dark\\:text-gray-200,.dark .text-gray-200{color:#f6f6f6!important}.dark .dark\\:text-gray-400,.dark .dark\\:text-gray-500,.dark .text-gray-400,.dark .text-gray-500{color:rgba(246,246,246,.7)!important}.dark .dark\\:text-white,.dark .text-white{color:#f6f6f6!important}#navbar .max-w-8xl{max-width:none!important;width:100%;padding-left:var(--docs-nav-pad-x)!important;padding-right:var(--docs-nav-pad-x)!important;box-sizing:border-box}#navbar .h-12,#navbar .h-16{padding-left:0!important;padding-right:0!important;margin-left:0!important;margin-right:0!important}#navbar .ml-auto.justify-end.space-x-4{column-gap:0!important;row-gap:0!important;gap:0!important}#navbar .ml-auto.justify-end.space-x-4>*{margin-left:0!important;margin-right:0!important;margin-inline:0!important}#navbar .ml-auto.justify-end>:not(nav){display:none!important}#navbar{border-bottom:1px solid var(--docs-border)!important}#navbar .h-12,#navbar .h-12 *,#navbar .h-16,#navbar .h-16 *,#navbar-transition{border-bottom:none!important;border-bottom-width:0!important;box-shadow:none!important}.nav-logo{height:18px!important;width:auto!important}#search-bar-entry,#topbar-cta-button a,[data-component-part=products-selector-trigger],[data-component-part=version-select-trigger],html.dark nav[aria-label=\"Mobile menu\"] a,html.dark nav[aria-label=\"Mobile menu\"] button{border-radius:6px!important}#search-bar-entry{width:20rem!important;max-width:20rem!important;height:2.25rem!important;padding-right:.3rem!important;border:0!important;box-shadow:none!important;outline:0!important;--tw-ring-shadow:0 0 #0000;--tw-ring-offset-shadow:0 0 #0000;background:rgba(246,246,246,.06)!important;filter:none!important}#search-bar-entry:hover{background:rgba(246,246,246,.09)!important;box-shadow:none!important}#search-bar-entry>span.flex-none{border-radius:4px!important;background:rgba(246,246,246,.08);padding:.15rem .35rem;font-weight:500;letter-spacing:.02em;color:rgba(246,246,246,.55)}#topbar-cta-button a{padding:.4rem .7rem .4rem .85rem!important}#topbar-cta-button a>span.absolute{background:#60917e!important;border-radius:6px!important}#topbar-cta-button a:hover>span.absolute{opacity:.88!important}#topbar-cta-button .text-white,#topbar-cta-button svg{color:#f6f6f6!important}#topbar-cta-button a .z-10{gap:.35rem!important}#topbar-cta-button svg{display:block!important;width:.7rem!important;height:.7rem!important;stroke:currentColor!important}#table-of-contents h2 svg,#topbar-cta-button a .z-10::after{display:none!important}div:has(>#sidebar){max-width:none!important;width:100%!important;margin-inline:0!important;padding-inline:0!important}#sidebar{position:sticky!important;left:0;flex-shrink:0!important;width:var(--docs-sidebar-width)!important;margin:0!important;padding:0!important;box-sizing:border-box;border-right-color:var(--docs-border)!important}#mobile-nav,#sidebar{border-right:1px solid var(--docs-border)!important}#footer,footer#footer{margin-top:var(--docs-page-end-gap)!important;padding-top:var(--docs-page-end-gap)!important;padding-bottom:var(--docs-page-end-gap)!important;border-top:1px solid var(--docs-border)!important;border-top-color:var(--docs-border)!important}#content-area>.invisible.sticky,#content-area>[aria-hidden=true].sticky{display:none!important;height:0!important;margin:0!important;padding:0!important;overflow:hidden!important}#sidebar-content{padding:.25rem var(--docs-sidebar-pad-x) 1.5rem;box-sizing:border-box}#sidebar-content .base-ui-disable-scrollbar{padding-right:.25rem!important}#mobile-nav .sidebar-group a,#mobile-nav .sidebar-group button,#sidebar a,#sidebar button{border-radius:4px!important;padding-right:var(--docs-sidebar-item-pad-x)!important;min-width:0;overflow:visible;white-space:nowrap}#mobile-nav .sidebar-group a span.break-words,#mobile-nav .sidebar-group button span.break-words,#sidebar a span.break-words,#sidebar button span.break-words{min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.sidebar-group-header{padding-left:var(--docs-sidebar-item-pad-x)!important}@media (max-width:1023px){#navbar .max-w-8xl{padding-left:1rem!important;padding-right:1rem!important}#navbar button.h-14.lg\\:hidden{padding-left:0!important;padding-right:0!important}#navbar .ml-auto.justify-end.space-x-4,#topbar-cta-button{display:none!important}#navbar .flex.lg\\:hidden.items-center,#navbar button[aria-label=\"More actions\"]{display:flex!important}}#navbar button[aria-label=\"More actions\"] svg,#search-bar-entry-mobile svg{background:#f6f6f6!important}#navbar button[aria-label=\"More actions\"]:hover svg,#search-bar-entry-mobile:hover svg{background:rgba(246,246,246,.7)!important}#mobile-nav [data-component-part=products-selector-trigger],#mobile-nav [data-component-part=version-select-trigger],#mobile-nav button.group\\/trigger{border-radius:6px!important;background:var(--docs-surface)!important;border-color:var(--docs-border)!important}#mobile-nav .sidebar-group{padding-left:.75rem}#mobile-nav [aria-label=\"Close navigation\"]{border-radius:50%!important}html.dark :has(>nav[aria-label=\"Mobile menu\"]){border-radius:8px!important;border:1px solid var(--docs-border)!important;background:#0d100f!important}#content-container,div:has(>#sidebar)>#content-container{flex:1 1 auto!important;min-width:0!important;width:auto!important;max-width:none!important}#content-container>div.flex.flex-row-reverse{display:flex!important;justify-content:flex-start!important;align-items:flex-start!important;width:100%!important;max-width:none!important;gap:0!important;padding-inline:0;box-sizing:border-box}#content-container:has(#table-of-contents) #content-side-layout{position:sticky!important;flex:0 0 var(--docs-toc-width)!important;width:var(--docs-toc-width)!important;max-width:var(--docs-toc-width)!important;margin:0!important;height:calc(100vh - 9.5rem)!important}#table-of-contents-layout{width:var(--docs-toc-width)!important;max-width:var(--docs-toc-width)!important;padding-left:1rem!important;padding-right:var(--docs-nav-pad-x)!important;box-sizing:border-box}#content-area{flex:1 1 auto!important;width:auto!important;min-width:0!important;max-width:none!important;margin:0!important;padding-left:var(--docs-frame-pad)!important;padding-right:var(--docs-frame-pad)!important;display:flex!important;flex-direction:column!important;align-items:center!important;box-sizing:border-box}#content-area>#content,#content-area>#footer,#content-area>#header,#content-area>#pagination,#content-area>.feedback-toolbar,#content-area>.mdx-content,#content-area>footer,html[data-page-mode=wide] #content-area>#content,html[data-page-mode=wide] #content-area>#footer,html[data-page-mode=wide] #content-area>#header,html[data-page-mode=wide] #content-area>#pagination,html[data-page-mode=wide] #content-area>.feedback-toolbar,html[data-page-mode=wide] #content-area>.mdx-content,html[data-page-mode=wide] #content-area>footer{width:100%;max-width:var(--docs-content-max)}#content-container:has(#api-playground-2-operation-page)>div.flex.flex-row-reverse{gap:0!important;padding-right:var(--docs-nav-pad-x);box-sizing:border-box}#content-container:has(#api-playground-2-operation-page) #content-side-layout{flex:0 0 var(--docs-api-code-width)!important;width:var(--docs-api-code-width)!important;max-width:var(--docs-api-code-width)!important;margin:0!important;height:calc(100vh - 9.5rem)!important;padding:0!important}#content-container:has(#api-playground-2-operation-page) #content-side-layout>div{width:100%!important;max-width:none!important}#content-container:has(#api-playground-2-operation-page) #content-area{flex:1 1 auto!important;width:auto!important;max-width:none!important;margin:0!important;padding-left:2.5rem!important;padding-right:2.5rem!important;display:flex!important;flex-direction:column!important;align-items:stretch!important}#content-container:has(#api-playground-2-operation-page) #content-area>#api-playground-2-operation-page,#content-container:has(#api-playground-2-operation-page) #content-area>#footer,#content-container:has(#api-playground-2-operation-page) #content-area>#header,#content-container:has(#api-playground-2-operation-page) #content-area>#pagination,#content-container:has(#api-playground-2-operation-page) #content-area>footer{width:100%;max-width:none!important}#header .eyebrow{color:rgba(246,246,246,.4)!important;font-weight:400!important;font-size:.8125rem!important;letter-spacing:0}#page-context-menu{gap:.35rem}@media (max-width:1023px){#page-context-menu.ml-auto{display:none!important}#page-context-menu.mt-3{display:flex!important;margin-left:0!important;justify-content:flex-start!important}}#page-context-menu button{background:rgba(246,246,246,.06)!important}#page-context-menu button:hover{background:rgba(246,246,246,.1)!important}#pagination,.feedback-toolbar{margin-bottom:0!important;padding-bottom:0!important}.feedback-toolbar{margin-top:var(--docs-page-end-gap);padding-top:var(--docs-page-end-gap)!important;border-top:1px solid var(--docs-border)!important;border-top-color:var(--docs-border)!important;gap:1rem!important}.feedback-toolbar>div{gap:.75rem!important}#pagination{margin-top:var(--docs-page-end-gap)!important;padding-top:0!important}#table-of-contents h2 button,.feedback-toolbar p{color:rgba(246,246,246,.4)!important;font-size:.8125rem!important;font-weight:400!important;letter-spacing:0}#feedback-thumbs-down,#feedback-thumbs-up,#page-context-menu button{border:0!important;box-shadow:none!important;outline:0!important;--tw-ring-shadow:0 0 #0000;border-radius:6px!important;color:rgba(246,246,246,.65)!important}#feedback-thumbs-down,#feedback-thumbs-up{background:var(--docs-surface)!important;padding:.4rem .75rem!important;gap:.45rem!important}#feedback-thumbs-down:hover,#feedback-thumbs-up:hover{background:rgba(246,246,246,.1)!important;color:#f6f6f6!important}#feedback-thumbs-down.border,#feedback-thumbs-up.border{background:rgba(96,145,126,.16)!important;color:#7aab98!important}#feedback-form,#feedback-form-cancel,#feedback-form-input,#feedback-form-submit{border-radius:6px!important}#feedback-form-input{background:var(--docs-surface)!important;border:1px solid var(--docs-border)!important;color:#f6f6f6!important}#feedback-form-submit{background:#60917e!important;color:#f6f6f6!important;border:0!important}#table-of-contents h2{margin:0 0 .75rem!important}#table-of-contents h2 button{cursor:default}#table-of-contents-content.toc{position:relative;margin:0!important;padding:0 0 0 .875rem!important;border-left:1px solid var(--docs-border)!important;list-style:none;min-width:0;overflow:hidden}#table-of-contents-content.toc::before{content:'';position:absolute;top:0;left:-1px;width:2px;height:var(--toc-indicator-h, 0px);background:#f6f6f6;border-radius:1px;pointer-events:none;opacity:var(--toc-indicator-opacity, 0);transform:translateY(var(--toc-indicator-y, 0px));will-change:transform,height}#table-of-contents-content.toc.is-ready::before{transition:transform 220ms cubic-bezier(.645,.045,.355,1),height 220ms cubic-bezier(.645,.045,.355,1),opacity 150ms ease}#table-of-contents .toc-item,#table-of-contents-content.toc>li{margin-top:0!important;min-width:0}#table-of-contents .toc-item ul{margin:0!important;padding:0!important;list-style:none!important;border:0!important}#table-of-contents .toc-item>a{color:rgba(246,246,246,.38)!important;text-shadow:none!important;font-weight:400!important;font-size:.875rem;line-height:1.35;padding-top:.3rem!important;padding-bottom:.3rem!important;padding-left:.2rem!important;display:block;overflow:hidden;text-overflow:ellipsis;white-space:nowrap!important;max-width:100%;word-break:normal!important;overflow-wrap:normal!important;hyphens:none!important;transition:color 150ms ease}#table-of-contents .toc-item[data-depth=\"1\"]>a{padding-left:1.15rem!important}#table-of-contents .toc-item[data-depth=\"2\"]>a{padding-left:2.1rem!important}#table-of-contents .toc-item[data-depth=\"3\"]>a{padding-left:3.05rem!important}#table-of-contents .toc-item[data-depth=\"4\"]>a{padding-left:4rem!important}#table-of-contents .toc-item>a:hover{color:rgba(246,246,246,.72)!important}#table-of-contents .toc-item.is-current>a{color:#f6f6f6!important}@media (prefers-reduced-motion:reduce){#table-of-contents .toc-item a,#table-of-contents-content.toc.is-ready::before{transition:none}}html.dark .code-block.code-block,html.dark .code-group{border-radius:var(--docs-code-radius)!important;border-color:var(--docs-border)!important;overflow:hidden}html.dark .code-block.code-block{--shiki-dark-bg:var(--docs-code-bg);border:1px solid var(--docs-border)!important;background:0 0!important;background-image:none!important;box-shadow:none!important;outline:0!important}html.dark .code-block .code-block-background,html.dark .code-block [data-component-part=code-block-root]{--shiki-dark-bg:var(--docs-code-bg)!important;background:var(--docs-code-bg)!important;background-color:var(--docs-code-bg)!important;background-image:none!important;box-shadow:none!important;border:0!important}html.dark .code-block .shiki,html.dark .code-block pre.shiki{--shiki-dark-bg:transparent!important;background:0 0!important;background-color:transparent!important}.code-block [data-component-part=code-block-header]{border-radius:0!important;background:0 0!important;border:0!important}html.dark .code-block [data-fade-overlay]{display:none!important;background:0 0!important;opacity:0!important;width:0!important}html.dark .code-block button,html.dark button[data-testid=copy-code-button]{border:0!important;box-shadow:none!important;outline:0!important;--tw-ring-shadow:0 0 #0000!important;--tw-ring-offset-shadow:0 0 #0000!important;--tw-ring-color:transparent!important;border-radius:6px!important;background:rgba(246,246,246,.08)!important;background-color:rgba(246,246,246,.08)!important}html.dark .code-block button:hover,html.dark button[data-testid=copy-code-button]:hover{background:rgba(246,246,246,.14)!important;background-color:rgba(246,246,246,.14)!important}html.dark .code-group{--rounded-xl:4px;--radius-xl:4px}html.dark .code-group .code-block-background,html.dark .code-group .rounded-xt,html.dark .code-group [class*=rounded-xt],html.dark .code-group [data-component-part=code-block-root]{--rounded-xl:4px!important;--radius-xl:4px!important;border-radius:4px!important}html.dark .code-group [class*=\"before:rounded\"]::before,html.dark .code-group [class*=rounded-xt]::before,html.dark .code-group [data-component-part=code-block-root]::before{border-radius:4px!important}html.dark .code-group [data-component-part=scroll-area-viewport]{border-radius:inherit!important}html.dark .callout{border-radius:8px!important}html.dark .callout[data-callout-type=note]{border:1px solid rgba(84,125,197,.4)!important;border-color:rgba(84,125,197,.4)!important;background:rgba(84,125,197,.14)!important;background-color:rgba(84,125,197,.14)!important;border-radius:8px!important}html.dark .callout[data-callout-type=note] [data-component-part=callout-content],html.dark .callout[data-callout-type=note] [data-component-part=callout-content] *,html.dark .callout[data-callout-type=note] [data-component-part=callout-icon],html.dark .callout[data-callout-type=note] [data-component-part=callout-icon] svg{color:#a2b9e2!important}html.dark .callout[data-callout-type=warning]{border:1px solid rgba(253,250,195,.4)!important;border-color:rgba(253,250,195,.4)!important;background:rgba(253,250,195,.14)!important;background-color:rgba(253,250,195,.14)!important;border-radius:8px!important}html.dark .callout[data-callout-type=warning] [data-component-part=callout-content],html.dark .callout[data-callout-type=warning] [data-component-part=callout-content] *,html.dark .callout[data-callout-type=warning] [data-component-part=callout-icon],html.dark .callout[data-callout-type=warning] [data-component-part=callout-icon] svg{color:#fdfac3!important}html.dark .callout[data-callout-type=check],html.dark .callout[data-callout-type=tip]{border:1px solid rgba(96,145,126,.45)!important;border-color:rgba(96,145,126,.45)!important}html.dark .callout[data-callout-type=tip]{background:rgba(40,102,80,.18)!important;background-color:rgba(40,102,80,.18)!important;border-radius:8px!important}html.dark .callout[data-callout-type=check] [data-component-part=callout-content],html.dark .callout[data-callout-type=check] [data-component-part=callout-content] *,html.dark .callout[data-callout-type=check] [data-component-part=callout-icon],html.dark .callout[data-callout-type=check] [data-component-part=callout-icon] svg,html.dark .callout[data-callout-type=tip] [data-component-part=callout-content],html.dark .callout[data-callout-type=tip] [data-component-part=callout-content] *,html.dark .callout[data-callout-type=tip] [data-component-part=callout-icon],html.dark .callout[data-callout-type=tip] [data-component-part=callout-icon] svg{color:#7aab98!important}html.dark .callout[data-callout-type=check]{background:rgba(96,145,126,.16)!important;background-color:rgba(96,145,126,.16)!important}html.dark .callout[data-callout-type=info]{border:1px solid rgba(246,246,246,.16)!important;border-color:rgba(246,246,246,.16)!important;background:rgba(246,246,246,.06)!important;background-color:rgba(246,246,246,.06)!important}html.dark .callout[data-callout-type=info] [data-component-part=callout-content],html.dark .callout[data-callout-type=info] [data-component-part=callout-content] *,html.dark .callout[data-callout-type=info] [data-component-part=callout-icon],html.dark .callout[data-callout-type=info] [data-component-part=callout-icon] svg{color:#f6f6f6!important}html.dark [data-component-part=tabs-list] [data-component-part=tab-button]{color:rgba(246,246,246,.6)!important;border-bottom-color:transparent!important}html.dark [data-component-part=tabs-list] [data-component-part=tab-button][data-active=true]{color:#f6f6f6!important;border-bottom-color:#60917e!important}html.dark [data-component-part=code-group-tab-bar] [role=tab]{color:rgba(246,246,246,.6)!important}html.dark [data-component-part=code-group-tab-bar] [role=tab][aria-selected=true],html.dark [data-component-part=code-group-tab-bar] [role=tab][data-active]{color:#f6f6f6!important}html.dark [data-component-part=code-group-tab-bar] [role=tab]>div:first-child{border-radius:6px!important;color:inherit!important}html.dark [data-component-part=code-group-tab-bar] [role=tab][aria-selected=true]>div:last-child{background:#60917e!important;background-color:#60917e!important;border-radius:999px!important}.accordion-group,details.accordion{border-radius:8px!important;overflow:hidden!important}.accordion [data-component-part=accordion-button]{gap:.5rem}.accordion [data-component-part=accordion-button]>div{margin-left:0!important;margin-right:0!important}.accordion [data-component-part=accordion-title-container]{order:1;flex:1 1 auto;width:auto!important}.accordion [data-component-part=accordion-caret-right]{order:2;flex:0 0 auto;margin-left:auto!important}.accordion [data-component-part=accordion-caret-right] svg{width:.75rem!important;height:.75rem!important;background-color:rgba(246,246,246,.7)!important;-webkit-mask-image:url(https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/chevron-down.svg)!important;mask-image:url(https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/regular/chevron-down.svg)!important;-webkit-mask-repeat:no-repeat!important;mask-repeat:no-repeat!important;-webkit-mask-position:center!important;mask-position:center!important;-webkit-mask-size:contain!important;mask-size:contain!important;transition:rotate 75ms ease-out!important;rotate:0deg;transform:none!important}.accordion [data-component-part=accordion-button][aria-expanded=true] [data-component-part=accordion-caret-right] svg,.accordion[open] [data-component-part=accordion-caret-right] svg{rotate:180deg!important}html.dark #text-selection-tooltip,html.dark [role=tooltip],html.dark tooltip{background:#0d100f!important;background-color:#0d100f!important;border:1px solid rgba(246,246,246,.12)!important;border-color:rgba(246,246,246,.12)!important;border-radius:4px!important;color:#f6f6f6!important}html.dark #localization-select-content,html.dark [data-component-part=products-selector-content],html.dark [data-component-part=search-filter-content],html.dark [data-component-part=theme-preference-menu-content],html.dark [data-component-part=version-select-content],html.dark [role=listbox],html.dark [role=menu],html.dark multi-view-dropdown-content,html.dark nav-dropdown-content,html.dark nav-dropdown-products-selector-content,html.dark option-dropdown{border-radius:8px!important}html.dark [data-component-part=search-modal]{border-radius:8px!important;border:1px solid var(--docs-border)!important;background:#0d100f!important;box-shadow:none!important}html.dark [data-component-part=search-cli-state],html.dark [data-component-part=search-input-container]{border-radius:6px!important;background:rgba(246,246,246,.06)!important;border-color:var(--docs-border)!important}html.dark [data-component-part=search-ask-ai-item],html.dark [data-component-part=search-item],html.dark [role=menuitem],html.dark [role=option]{border-radius:6px!important}html.dark [role=menuitem]>div:first-child{border-radius:6px!important}.mdx-content .frame,.mdx-content [data-name=frame],.mdx-content img,.mdx-content video{display:block;width:100%;max-width:100%;height:auto}.prose :where(img):not(:where([class~=\"not-prose\"], [class~=\"not-prose\"] *)){margin-top:0!important}.mdx-content .frame,.mdx-content [data-name=frame],.mdx-content iframe,.mdx-content img,.mdx-content video{border-radius:8px!important}.mdx-content .frame,.mdx-content [data-name=frame],.mdx-content img,.mdx-content video{overflow:hidden!important}html.dark .card,html.dark [data-component-name=mermaid-container],html.dark card,html.dark mermaid,html.dark tile{border-radius:8px!important;background:rgba(246,246,246,.04)!important;background-color:rgba(246,246,246,.04)!important;overflow:hidden!important}html.dark .card,html.dark card,html.dark tile{border-color:var(--docs-border)!important}html.dark .card [data-component-part=card-content],html.dark card [data-component-part=card-content],html.dark tile [data-component-part=card-content]{font-size:.875rem!important;line-height:1.5!important;text-wrap:pretty}html.dark [data-component-name=mermaid-container],html.dark mermaid{display:block;border:1px solid var(--docs-border)!important;padding:1.5rem 1.25rem!important}html.dark [data-component-name=mermaid-container] mermaid{border:0!important;background:0 0!important;padding:0!important;border-radius:0!important;overflow:visible!important}html.dark [data-component-name=mermaid-container] svg,html.dark mermaid svg{background:0 0!important}html.dark [data-component-name=mermaid-container] rect.actor,html.dark mermaid rect.actor{rx:8px!important;ry:8px!important}html.dark [data-component-name=mermaid-container] .messageLine0,html.dark mermaid .messageLine0{stroke:#60917e!important}html.dark [data-component-name=mermaid-container] .messageLine1,html.dark mermaid .messageLine1{stroke:rgba(205,205,205,.55)!important}html.dark [data-component-name=mermaid-container] .messageText,html.dark [data-component-name=mermaid-container] .messageText tspan,html.dark [data-component-name=mermaid-container] text.actor,html.dark [data-component-name=mermaid-container] text.actor tspan,html.dark mermaid .messageText,html.dark mermaid .messageText tspan,html.dark mermaid text.actor,html.dark mermaid text.actor tspan{fill:#f6f6f6!important;font-family:Plain,sans-serif!important}html.dark [data-component-name=mermaid-container] marker path,html.dark mermaid marker path{fill:#60917e!important;stroke:#60917e!important}#content table td,#content table th{padding-top:.875rem!important;padding-bottom:.875rem!important}[data-component-part=step-number]>div{border-radius:50%!important}#content a.link,#content a.link:hover{color:#f6f6f6!important;border-bottom-color:#60917e!important;text-decoration-color:#60917e!important}#content .callout a.link,#content .callout a.link:hover{color:inherit!important;border-bottom-color:currentColor!important;text-decoration-color:currentColor!important}html.dark .code-block,html.dark .code-block code,html.dark .code-block pre,html.dark .code-group .code-block-background,html.dark .code-group [data-component-part=code-block-root],html.dark .code-group [data-component-part=code-group-tab-content],html.dark .code-group code,html.dark .code-group pre{font-size:13px!important}html.dark code:not(pre *){border-radius:4px!important;border:1px solid var(--docs-border)!important;font-size:13px!important}#content-container:has(#api-playground-2-operation-page) [data-component-part=field-name]{color:#f6f6f6!important;font-size:15px!important;font-weight:500!important}#content-container:has(#api-playground-2-operation-page) .method-pill,#content-container:has(#api-playground-2-operation-page) [data-component-part=field-info-pill],#content-container:has(#api-playground-2-operation-page) [data-component-part=field-required-pill],#mobile-nav .method-nav-pill>span,#mobile-nav .method-pill,#sidebar .method-nav-pill>span,#sidebar .method-pill{border-radius:4px!important}#content-container:has(#api-playground-2-operation-page) [data-component-part=field-info-pill],#content-container:has(#api-playground-2-operation-page) [data-component-part=field-info-pill] *,#content-container:has(#api-playground-2-operation-page) [data-component-part=field-meta] .option-dropdown{color:rgba(246,246,246,.55)!important}#mobile-nav .method-nav-pill,#sidebar .method-nav-pill{overflow:visible!important;flex-shrink:0!important}#mobile-nav .method-nav-pill>span,#sidebar .method-nav-pill>span{width:max-content!important;max-width:none!important;overflow:visible!important;text-overflow:clip!important;white-space:nowrap!important}#content-container:has(#api-playground-2-operation-page) .border-standard.rounded-xl,#content-container:has(#api-playground-2-operation-page) .code-group button,#content-container:has(#api-playground-2-operation-page) .tryit-button,#content-container:has(#api-playground-2-operation-page) [data-component-part=version-select-trigger],#content-container:has(#api-playground-2-operation-page) button[aria-label=\"Select language\"],#content-container:has(#api-playground-2-operation-page) button[aria-label=Copy]{border-radius:6px!important}#content-container:has(#api-playground-2-operation-page) .border-standard,#content-container:has(#api-playground-2-operation-page) [data-component-part=expandable-button],#content-container:has(#api-playground-2-operation-page) [data-component-part=expandable]{border-radius:8px!important}"}],"page":{"pagePath":"api-reference/workflows/run-a-workflow","slug":"/api-reference/workflows/run-a-workflow","pageMetadata":{"title":"Run a workflow","description":"Runs a workflow. Returns immediately with the run `queued`.","deprecated":null,"version":null,"openapi":"/api-reference/v2.json post /workflows/{workflow_id}/run","href":"/api-reference/workflows/run-a-workflow","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Runs a workflow. Returns immediately with the run \", _jsx(_components.code, {\n children: \"queued\"\n }), \".\"]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=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":"Run a workflow","description":"Runs a workflow. Returns immediately with the run `queued`.","deprecated":null,"version":null,"openapi":"/api-reference/v2.json post /workflows/{workflow_id}/run","href":"/api-reference/workflows/run-a-workflow","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/decksoftwareinc/60feb3fe1b2400a1/mermaid.js","/_mintlify/custom/decksoftwareinc/53c63d97f88b046e/toc.js"],"openApiReferenceData":{"operation":{"tags":["Workflows"],"summary":"Run a workflow","operationId":"runWorkflow","description":"Runs a workflow. Returns immediately with the run `queued`.","parameters":["9e1405e0-7959-4cd7-8422-9d16695bfca0","cea30d9b-c3b3-4692-9afb-0f950666db52"],"responses":{"201":"15d55728-c99d-4702-afe7-0c9934a4daa9","400":"6a930a64-0155-4493-a20d-bd72470453e0","401":"9c782e8d-2a29-47f1-af9b-dc7e6bf167df","403":"3b0c4b96-f178-4dab-9e18-6048352acd4f","404":"d7565ce9-486a-41cb-bb50-5d2425df5735","409":"57630174-c071-47cf-a927-494545ccfa0b","422":"6800cfa1-144a-4c30-99a6-2526cdb931e2","429":"cf95bc18-4790-4799-b151-35980e27c26a","500":"96b43baa-d8bf-469e-99a6-f58a8486e9e2"},"requestBody":"78fbe8fa-7f36-46d9-a63e-2c883b281d52","method":"post","type":"path","servers":["e7891587-14e5-4adb-832b-247637593716"],"security":["dc8ae21e-0d3e-40ae-bf25-638c0c900a99"],"path":"/workflows/{workflow_id}/run","baseUrlOptions":["https://api.deck.co/v2"],"title":"Run a workflow","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"9e1405e0-7959-4cd7-8422-9d16695bfca0":{"name":"workflow_id","in":"path","required":true,"schema":{"type":"string","pattern":"^wflo_","example":"wflo_AbC123xYz456","isRequired":true,"description":"Unique identifier for the workflow (prefixed with `wflo_`).","uniqueKey":"","typeLabel":"string"},"description":"Unique identifier for the workflow (prefixed with `wflo_`)."},"cea30d9b-c3b3-4692-9afb-0f950666db52":{"name":"Idempotency-Key","in":"header","required":false,"description":"Optional key that makes the request idempotent. Retrying with the same key returns the original response instead of repeating the operation; keys expire after 24 hours. Any string up to 256 characters. See [Idempotency](/api/idempotency).","schema":{"type":"string","maxLength":256,"example":"550e8400-e29b-41d4-a716-446655440000","isRequired":false,"description":"Optional key that makes the request idempotent. Retrying with the same key returns the original response instead of repeating the operation; keys expire after 24 hours. Any string up to 256 characters. See [Idempotency](/api/idempotency).","uniqueKey":"","typeLabel":"string"}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"steps":{"oneOf":[{"type":"null","items":{"type":"object","required":["name"],"properties":{"name":{"type":"string","example":"check_price","description":"The step to override, matching a step `name` in the workflow definition. For a `for_each`, the override applies to the inner step on every item."},"credential_id":{"oneOf":[{"type":"null","description":"Credential for this step's task run. Mutually exclusive with `source_id`."},{"type":"string","description":"Credential for this step's task run. Mutually exclusive with `source_id`."}]},"source_id":{"oneOf":[{"type":"null","description":"Source for this step's task run (public sources only). Mutually exclusive with `credential_id`."},{"type":"string","description":"Source for this step's task run (public sources only). Mutually exclusive with `credential_id`."}]},"input":{"oneOf":[{"type":"null","additionalProperties":true,"description":"Shallow-merged onto the definition's `input`: top-level keys here win, keys absent fall back to the definition. Nested objects replace entirely."},{"type":"object","additionalProperties":true,"description":"Shallow-merged onto the definition's `input`: top-level keys here win, keys absent fall back to the definition. Nested objects replace entirely."}]}},"description":"Run-time values for one step. `session_id` is not accepted; every step of a run executes in one session."},"description":"Per-step overrides. Steps you don't list run exactly as defined.","uniqueKey":"steps.oneOf.0","typeLabel":"null"},{"type":"array","items":{"type":"object","required":["name"],"properties":{"name":{"type":"string","example":"check_price","description":"The step to override, matching a step `name` in the workflow definition. For a `for_each`, the override applies to the inner step on every item.","isRequired":true,"uniqueKey":"steps.oneOf.1.items.[INDEX].name","typeLabel":"string"},"credential_id":{"oneOf":[{"type":"null","description":"Credential for this step's task run. Mutually exclusive with `source_id`.","uniqueKey":"steps.oneOf.1.items.[INDEX].credential_id.oneOf.0","typeLabel":"null"},{"type":"string","description":"Credential for this step's task run. Mutually exclusive with `source_id`.","uniqueKey":"steps.oneOf.1.items.[INDEX].credential_id.oneOf.1","typeLabel":"string"}],"uniqueKey":"steps.oneOf.1.items.[INDEX].credential_id","typeLabel":"null | string"},"source_id":{"oneOf":[{"type":"null","description":"Source for this step's task run (public sources only). Mutually exclusive with `credential_id`.","uniqueKey":"steps.oneOf.1.items.[INDEX].source_id.oneOf.0","typeLabel":"null"},{"type":"string","description":"Source for this step's task run (public sources only). Mutually exclusive with `credential_id`.","uniqueKey":"steps.oneOf.1.items.[INDEX].source_id.oneOf.1","typeLabel":"string"}],"uniqueKey":"steps.oneOf.1.items.[INDEX].source_id","typeLabel":"null | string"},"input":{"oneOf":[{"type":"null","additionalProperties":true,"description":"Shallow-merged onto the definition's `input`: top-level keys here win, keys absent fall back to the definition. Nested objects replace entirely.","uniqueKey":"steps.oneOf.1.items.[INDEX].input.oneOf.0","typeLabel":"null"},{"type":"object","additionalProperties":true,"description":"Shallow-merged onto the definition's `input`: top-level keys here win, keys absent fall back to the definition. Nested objects replace entirely.","uniqueKey":"steps.oneOf.1.items.[INDEX].input.oneOf.1","typeLabel":"object"}],"uniqueKey":"steps.oneOf.1.items.[INDEX].input","typeLabel":"null | object"}},"description":"Run-time values for one step. `session_id` is not accepted; every step of a run executes in one session.","uniqueKey":"steps.oneOf.1.items.[INDEX]","typeLabel":"object"},"description":"Per-step overrides. Steps you don't list run exactly as defined.","uniqueKey":"steps.oneOf.1","typeLabel":"object[]"}],"uniqueKey":"steps","typeLabel":"null | object[]"},"interactions_suppressed":{"type":"boolean","description":"When `true`, no step of the run sends an interaction (MFA code, security question) to your user. An interaction that needs a person fails the run with `interaction_suppressed`, and the credential stays valid. Defaults to `false`.","uniqueKey":"interactions_suppressed","typeLabel":"boolean"}},"description":"Request body for running a workflow. The body may be empty.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"steps":[{"name":"check_price","credential_id":"\u003cstring>","source_id":"\u003cstring>","input":{}}],"interactions_suppressed":true}}},"exampleType":"generated"},"text/json":{"schema":{"type":"object","properties":{"steps":{"oneOf":[{"type":"null","items":{"type":"object","required":["name"],"properties":{"name":{"type":"string","example":"check_price","description":"The step to override, matching a step `name` in the workflow definition. For a `for_each`, the override applies to the inner step on every item."},"credential_id":{"oneOf":[{"type":"null","description":"Credential for this step's task run. Mutually exclusive with `source_id`."},{"type":"string","description":"Credential for this step's task run. Mutually exclusive with `source_id`."}]},"source_id":{"oneOf":[{"type":"null","description":"Source for this step's task run (public sources only). Mutually exclusive with `credential_id`."},{"type":"string","description":"Source for this step's task run (public sources only). Mutually exclusive with `credential_id`."}]},"input":{"oneOf":[{"type":"null","additionalProperties":true,"description":"Shallow-merged onto the definition's `input`: top-level keys here win, keys absent fall back to the definition. Nested objects replace entirely."},{"type":"object","additionalProperties":true,"description":"Shallow-merged onto the definition's `input`: top-level keys here win, keys absent fall back to the definition. Nested objects replace entirely."}]}},"description":"Run-time values for one step. `session_id` is not accepted; every step of a run executes in one session."},"description":"Per-step overrides. Steps you don't list run exactly as defined.","uniqueKey":"steps.oneOf.0","typeLabel":"null"},{"type":"array","items":{"type":"object","required":["name"],"properties":{"name":{"type":"string","example":"check_price","description":"The step to override, matching a step `name` in the workflow definition. For a `for_each`, the override applies to the inner step on every item.","isRequired":true,"uniqueKey":"steps.oneOf.1.items.[INDEX].name","typeLabel":"string"},"credential_id":{"oneOf":[{"type":"null","description":"Credential for this step's task run. Mutually exclusive with `source_id`.","uniqueKey":"steps.oneOf.1.items.[INDEX].credential_id.oneOf.0","typeLabel":"null"},{"type":"string","description":"Credential for this step's task run. Mutually exclusive with `source_id`.","uniqueKey":"steps.oneOf.1.items.[INDEX].credential_id.oneOf.1","typeLabel":"string"}],"uniqueKey":"steps.oneOf.1.items.[INDEX].credential_id","typeLabel":"null | string"},"source_id":{"oneOf":[{"type":"null","description":"Source for this step's task run (public sources only). Mutually exclusive with `credential_id`.","uniqueKey":"steps.oneOf.1.items.[INDEX].source_id.oneOf.0","typeLabel":"null"},{"type":"string","description":"Source for this step's task run (public sources only). Mutually exclusive with `credential_id`.","uniqueKey":"steps.oneOf.1.items.[INDEX].source_id.oneOf.1","typeLabel":"string"}],"uniqueKey":"steps.oneOf.1.items.[INDEX].source_id","typeLabel":"null | string"},"input":{"oneOf":[{"type":"null","additionalProperties":true,"description":"Shallow-merged onto the definition's `input`: top-level keys here win, keys absent fall back to the definition. Nested objects replace entirely.","uniqueKey":"steps.oneOf.1.items.[INDEX].input.oneOf.0","typeLabel":"null"},{"type":"object","additionalProperties":true,"description":"Shallow-merged onto the definition's `input`: top-level keys here win, keys absent fall back to the definition. Nested objects replace entirely.","uniqueKey":"steps.oneOf.1.items.[INDEX].input.oneOf.1","typeLabel":"object"}],"uniqueKey":"steps.oneOf.1.items.[INDEX].input","typeLabel":"null | object"}},"description":"Run-time values for one step. `session_id` is not accepted; every step of a run executes in one session.","uniqueKey":"steps.oneOf.1.items.[INDEX]","typeLabel":"object"},"description":"Per-step overrides. Steps you don't list run exactly as defined.","uniqueKey":"steps.oneOf.1","typeLabel":"object[]"}],"uniqueKey":"steps","typeLabel":"null | object[]"},"interactions_suppressed":{"type":"boolean","description":"When `true`, no step of the run sends an interaction (MFA code, security question) to your user. An interaction that needs a person fails the run with `interaction_suppressed`, and the credential stays valid. Defaults to `false`.","uniqueKey":"interactions_suppressed","typeLabel":"boolean"}},"description":"Request body for running a workflow. The body may be empty.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"steps":[{"name":"check_price","credential_id":"\u003cstring>","source_id":"\u003cstring>","input":{}}],"interactions_suppressed":true}}},"exampleType":"generated"},"application/*+json":{"schema":{"type":"object","properties":{"steps":{"oneOf":[{"type":"null","items":{"type":"object","required":["name"],"properties":{"name":{"type":"string","example":"check_price","description":"The step to override, matching a step `name` in the workflow definition. For a `for_each`, the override applies to the inner step on every item."},"credential_id":{"oneOf":[{"type":"null","description":"Credential for this step's task run. Mutually exclusive with `source_id`."},{"type":"string","description":"Credential for this step's task run. Mutually exclusive with `source_id`."}]},"source_id":{"oneOf":[{"type":"null","description":"Source for this step's task run (public sources only). Mutually exclusive with `credential_id`."},{"type":"string","description":"Source for this step's task run (public sources only). Mutually exclusive with `credential_id`."}]},"input":{"oneOf":[{"type":"null","additionalProperties":true,"description":"Shallow-merged onto the definition's `input`: top-level keys here win, keys absent fall back to the definition. Nested objects replace entirely."},{"type":"object","additionalProperties":true,"description":"Shallow-merged onto the definition's `input`: top-level keys here win, keys absent fall back to the definition. Nested objects replace entirely."}]}},"description":"Run-time values for one step. `session_id` is not accepted; every step of a run executes in one session."},"description":"Per-step overrides. Steps you don't list run exactly as defined.","uniqueKey":"steps.oneOf.0","typeLabel":"null"},{"type":"array","items":{"type":"object","required":["name"],"properties":{"name":{"type":"string","example":"check_price","description":"The step to override, matching a step `name` in the workflow definition. For a `for_each`, the override applies to the inner step on every item.","isRequired":true,"uniqueKey":"steps.oneOf.1.items.[INDEX].name","typeLabel":"string"},"credential_id":{"oneOf":[{"type":"null","description":"Credential for this step's task run. Mutually exclusive with `source_id`.","uniqueKey":"steps.oneOf.1.items.[INDEX].credential_id.oneOf.0","typeLabel":"null"},{"type":"string","description":"Credential for this step's task run. Mutually exclusive with `source_id`.","uniqueKey":"steps.oneOf.1.items.[INDEX].credential_id.oneOf.1","typeLabel":"string"}],"uniqueKey":"steps.oneOf.1.items.[INDEX].credential_id","typeLabel":"null | string"},"source_id":{"oneOf":[{"type":"null","description":"Source for this step's task run (public sources only). Mutually exclusive with `credential_id`.","uniqueKey":"steps.oneOf.1.items.[INDEX].source_id.oneOf.0","typeLabel":"null"},{"type":"string","description":"Source for this step's task run (public sources only). Mutually exclusive with `credential_id`.","uniqueKey":"steps.oneOf.1.items.[INDEX].source_id.oneOf.1","typeLabel":"string"}],"uniqueKey":"steps.oneOf.1.items.[INDEX].source_id","typeLabel":"null | string"},"input":{"oneOf":[{"type":"null","additionalProperties":true,"description":"Shallow-merged onto the definition's `input`: top-level keys here win, keys absent fall back to the definition. Nested objects replace entirely.","uniqueKey":"steps.oneOf.1.items.[INDEX].input.oneOf.0","typeLabel":"null"},{"type":"object","additionalProperties":true,"description":"Shallow-merged onto the definition's `input`: top-level keys here win, keys absent fall back to the definition. Nested objects replace entirely.","uniqueKey":"steps.oneOf.1.items.[INDEX].input.oneOf.1","typeLabel":"object"}],"uniqueKey":"steps.oneOf.1.items.[INDEX].input","typeLabel":"null | object"}},"description":"Run-time values for one step. `session_id` is not accepted; every step of a run executes in one session.","uniqueKey":"steps.oneOf.1.items.[INDEX]","typeLabel":"object"},"description":"Per-step overrides. Steps you don't list run exactly as defined.","uniqueKey":"steps.oneOf.1","typeLabel":"object[]"}],"uniqueKey":"steps","typeLabel":"null | object[]"},"interactions_suppressed":{"type":"boolean","description":"When `true`, no step of the run sends an interaction (MFA code, security question) to your user. An interaction that needs a person fails the run with `interaction_suppressed`, and the credential stays valid. Defaults to `false`.","uniqueKey":"interactions_suppressed","typeLabel":"boolean"}},"description":"Request body for running a workflow. The body may be empty.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"steps":[{"name":"check_price","credential_id":"\u003cstring>","source_id":"\u003cstring>","input":{}}],"interactions_suppressed":true}}},"exampleType":"generated"}},"required":false,"exampleType":"generated"},"responses":{"15d55728-c99d-4702-afe7-0c9934a4daa9":{"description":"Created","content":{"text/plain":{"schema":{"type":"object","required":["id","object","workflow_id","status","result","runtime_ms","session_id","trigger_id","steps","errors","created_at","updated_at"],"properties":{"id":{"type":"string","pattern":"^wrun_","example":"wrun_AbC123xYz456","description":"Unique identifier for the workflow run, prefixed with `wrun_`.","isRequired":true,"uniqueKey":"id","typeLabel":"string"},"object":{"type":"string","description":"Always `workflow_run`.","isRequired":true,"uniqueKey":"object","typeLabel":"string"},"workflow_id":{"type":"string","pattern":"^wflo_","example":"wflo_AbC123xYz456","description":"The workflow that was run.","isRequired":true,"uniqueKey":"workflow_id","typeLabel":"string"},"status":{"type":"string","enum":["queued","running","paused","completed","failed","canceling","canceled"],"description":"Lifecycle state. `paused` means the current step is waiting on external input; the step's own status carries the reason.","isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"result":{"oneOf":[{"type":"null","description":"Outcome once terminal: `success` only when every task run succeeded, `failure` if any failed, `unknown` otherwise. `null` while running and for a canceled run.","isRequired":true,"uniqueKey":"result.oneOf.0","typeLabel":"null"},{"type":"string","description":"Outcome once terminal: `success` only when every task run succeeded, `failure` if any failed, `unknown` otherwise. `null` while running and for a canceled run.","isRequired":true,"uniqueKey":"result.oneOf.1","typeLabel":"string"}],"isRequired":true,"uniqueKey":"result","typeLabel":"null | string"},"runtime_ms":{"oneOf":[{"type":"null","format":"int64","description":"Milliseconds from the first step's start until the run reached a terminal status, excluding time spent queued. `null` until terminal.","isRequired":true,"uniqueKey":"runtime_ms.oneOf.0","typeLabel":"null"},{"type":"integer","format":"int64","description":"Milliseconds from the first step's start until the run reached a terminal status, excluding time spent queued. `null` until terminal.","isRequired":true,"uniqueKey":"runtime_ms.oneOf.1","typeLabel":"integer\u003cint64>"}],"isRequired":true,"uniqueKey":"runtime_ms","typeLabel":"null | integer\u003cint64>"},"session_id":{"oneOf":[{"type":"null","description":"The session every step of this run executes in. Prefixed with `sess_`. Assigned when the run is created through the API, or when a trigger-created run is admitted, so `null` while such a run is queued.","isRequired":true,"uniqueKey":"session_id.oneOf.0","typeLabel":"null"},{"type":"string","description":"The session every step of this run executes in. Prefixed with `sess_`. Assigned when the run is created through the API, or when a trigger-created run is admitted, so `null` while such a run is queued.","isRequired":true,"uniqueKey":"session_id.oneOf.1","typeLabel":"string"}],"isRequired":true,"uniqueKey":"session_id","typeLabel":"null | string"},"trigger_id":{"oneOf":[{"type":"null","description":"The trigger that created this run. Prefixed with `trg_`. `null` for runs created through the API.","isRequired":true,"uniqueKey":"trigger_id.oneOf.0","typeLabel":"null"},{"type":"string","description":"The trigger that created this run. Prefixed with `trg_`. `null` for runs created through the API.","isRequired":true,"uniqueKey":"trigger_id.oneOf.1","typeLabel":"string"}],"isRequired":true,"uniqueKey":"trigger_id","typeLabel":"null | string"},"steps":{"type":"array","items":{"type":"object","required":["name","type","status","output"],"properties":{"name":{"type":"string","description":"The step's name, matching the definition.","isRequired":true,"uniqueKey":"steps.items.[INDEX].name","typeLabel":"string"},"type":{"type":"string","enum":["task","for_each"],"description":"`task` or `for_each`.","isRequired":true,"uniqueKey":"steps.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"status":{"type":"string","description":"The underlying task run's status (`queued`, `running`, `interaction_required`, `review_required`, `completed`, `failed`, `canceling`, `canceled`), plus `skipped` when the step's `if` evaluated false. A `for_each` aggregates its items.","isRequired":true,"uniqueKey":"steps.items.[INDEX].status","typeLabel":"string"},"output":{"oneOf":[{"type":"null","description":"What references to this step resolve to: the task's output, or the ordered array of per-item outputs for a `for_each`. `null` until completion, and for a skipped step.","isRequired":true,"uniqueKey":"steps.items.[INDEX].output.oneOf.0","typeLabel":"null"},{"description":"What references to this step resolve to: the task's output, or the ordered array of per-item outputs for a `for_each`. `null` until completion, and for a skipped step.","isRequired":true,"uniqueKey":"steps.items.[INDEX].output.oneOf.1","typeLabel":"any"}],"isRequired":true,"uniqueKey":"steps.items.[INDEX].output","typeLabel":"null | any"},"task_runs":{"oneOf":[{"type":"null","items":{"type":"object","required":["task_run_id","status","result","created_at","runtime_ms","errors"],"properties":{"task_run_id":{"type":"string","pattern":"^trun_","example":"trun_AbC123xYz456","description":"The task run this entry summarizes. `GET /v2/task-runs/{run_id}` is the authoritative record."},"status":{"type":"string","description":"The task run's status."},"result":{"oneOf":[{"type":"null","description":"`success`, `failure`, or `unknown`. `null` until terminal."},{"type":"string","description":"`success`, `failure`, or `unknown`. `null` until terminal."}]},"created_at":{"type":"string","format":"date-time","example":"2026-06-18T00:00:00Z","description":"When the task run was created. Because steps run sequentially, this is when the step or item started."},"runtime_ms":{"oneOf":[{"type":"null","format":"int32","description":"Execution time in milliseconds. `null` until terminal, and for a run that failed before it started."},{"type":"integer","format":"int32","description":"Execution time in milliseconds. `null` until terminal, and for a run that failed before it started."}]},"errors":{"oneOf":[{"type":"null","items":{"required":["type","code","message"],"type":"object","properties":{"type":{"type":"string","description":"Error category (e.g. `source`, `auth`, `task`, `rate_limit`). Determines the class of failure."},"code":{"type":"string","description":"Machine-readable error code. Use this for programmatic handling."},"message":{"type":"string","description":"Human-readable explanation. Do not rely on this for logic — it may change."},"field":{"oneOf":[{"type":"null","description":"The input field that caused the error, when applicable."},{"type":"string","description":"The input field that caused the error, when applicable."}]}},"description":"Error details for a failed task run. Same structure as API-level errors."},"description":"Errors for this run when it failed. `null` otherwise."},{"type":"array","items":{"required":["type","code","message"],"type":"object","properties":{"type":{"type":"string","description":"Error category (e.g. `source`, `auth`, `task`, `rate_limit`). Determines the class of failure."},"code":{"type":"string","description":"Machine-readable error code. Use this for programmatic handling."},"message":{"type":"string","description":"Human-readable explanation. Do not rely on this for logic — it may change."},"field":{"oneOf":[{"type":"null","description":"The input field that caused the error, when applicable."},{"type":"string","description":"The input field that caused the error, when applicable."}]}},"description":"Error details for a failed task run. Same structure as API-level errors."},"description":"Errors for this run when it failed. `null` otherwise."}]},"item":{"oneOf":[{"type":"null","description":"`for_each` only. The input item this run processed."},{"description":"`for_each` only. The input item this run processed."}]},"input":{"oneOf":[{"type":"null","description":"The resolved input this run received, with references substituted. Returned only when `include=input` is requested."},{"description":"The resolved input this run received, with references substituted. Returned only when `include=input` is requested."}]},"storage":{"oneOf":[{"type":"null","items":{"required":["id","object","file_name","file_type","file_size","purpose","created_at"],"type":"object","properties":{"id":{"type":"string","description":"Unique identifier for the storage item, prefixed with `stor_`.","pattern":"^stor_","example":"stor_AbC123xYz456"},"object":{"type":"string","description":"Always `storage`."},"file_name":{"type":"string","description":"Original file name."},"file_type":{"type":"string","description":"MIME type of the file."},"file_size":{"oneOf":[{"pattern":"^-?(?:0|[1-9]\\d*)$","type":"integer","format":"int64","description":"Size of the file in bytes."},{"pattern":"^-?(?:0|[1-9]\\d*)$","type":"string","format":"int64","description":"Size of the file in bytes."}]},"url":{"oneOf":[{"type":"null","description":"Signed URL to download the file. Time-limited."},{"type":"string","description":"Signed URL to download the file. Time-limited."}]},"extraction":{"oneOf":[{"type":"null","description":"Extracted structured data from the file, if any."},{"description":"Extracted structured data from the file, if any."}]},"purpose":{"type":"string","enum":["attachment","extraction","output"],"description":"How the file relates to the run: `attachment` (a file you provided as task input for the agent to use), `extraction` (a file you provided as task input that Deck extracts data from directly, skipping the agent), or `output` (a file the agent captured during the run)."},"created_at":{"type":"string","format":"date-time","description":"When the storage item was created.","example":"2026-08-24T12:00:00Z"}},"description":"A storage item embedded in the task run detail response when include=storage is requested. Includes the signed download URL and any inline extraction."},"description":"Files captured during this run, each with inline extraction (if any). Returned only when `include=storage` is requested."},{"type":"array","items":{"required":["id","object","file_name","file_type","file_size","purpose","created_at"],"type":"object","properties":{"id":{"type":"string","description":"Unique identifier for the storage item, prefixed with `stor_`.","pattern":"^stor_","example":"stor_AbC123xYz456"},"object":{"type":"string","description":"Always `storage`."},"file_name":{"type":"string","description":"Original file name."},"file_type":{"type":"string","description":"MIME type of the file."},"file_size":{"oneOf":[{"pattern":"^-?(?:0|[1-9]\\d*)$","type":"integer","format":"int64","description":"Size of the file in bytes."},{"pattern":"^-?(?:0|[1-9]\\d*)$","type":"string","format":"int64","description":"Size of the file in bytes."}]},"url":{"oneOf":[{"type":"null","description":"Signed URL to download the file. Time-limited."},{"type":"string","description":"Signed URL to download the file. Time-limited."}]},"extraction":{"oneOf":[{"type":"null","description":"Extracted structured data from the file, if any."},{"description":"Extracted structured data from the file, if any."}]},"purpose":{"type":"string","enum":["attachment","extraction","output"],"description":"How the file relates to the run: `attachment` (a file you provided as task input for the agent to use), `extraction` (a file you provided as task input that Deck extracts data from directly, skipping the agent), or `output` (a file the agent captured during the run)."},"created_at":{"type":"string","format":"date-time","description":"When the storage item was created.","example":"2026-08-24T12:00:00Z"}},"description":"A storage item embedded in the task run detail response when include=storage is requested. Includes the signed download URL and any inline extraction."},"description":"Files captured during this run, each with inline extraction (if any). Returned only when `include=storage` is requested."}]},"artifacts":{"oneOf":[{"type":"null","description":"Screenshots for this run. Returned only when `include=artifacts` is requested."},{"type":"object","description":"Screenshots for this run. Returned only when `include=artifacts` is requested.","required":["screenshots"],"properties":{"screenshots":{"type":"array","items":{"required":["file_name","file_type","file_size","created_at"],"type":"object","properties":{"file_name":{"type":"string","description":"Original file name."},"file_type":{"type":"string","description":"MIME type of the screenshot."},"file_size":{"oneOf":[{"pattern":"^-?(?:0|[1-9]\\d*)$","type":"integer","format":"int64","description":"Size of the file in bytes."},{"pattern":"^-?(?:0|[1-9]\\d*)$","type":"string","format":"int64","description":"Size of the file in bytes."}]},"url":{"oneOf":[{"type":"null","description":"Signed URL to download the screenshot. Time-limited."},{"type":"string","description":"Signed URL to download the screenshot. Time-limited."}]},"reasoning":{"oneOf":[{"type":"null","description":"AI reasoning at the time of capture, if recorded."},{"type":"string","description":"AI reasoning at the time of capture, if recorded."}]},"created_at":{"type":"string","format":"date-time","description":"When the screenshot was captured.","example":"2026-08-24T12:00:00Z"}},"description":"A single screenshot captured during a task run."},"description":"Screenshots captured during the run."}}}]}},"description":"A compact summary of one task run a step produced."},"description":"The task runs this step produced, in order: one for a `task` step, one per item processed for a `for_each`, none for a skipped step. Returned on single-run responses; omitted from list responses.","uniqueKey":"steps.items.[INDEX].task_runs.oneOf.0","typeLabel":"null"},{"type":"array","items":{"type":"object","required":["task_run_id","status","result","created_at","runtime_ms","errors"],"properties":{"task_run_id":{"type":"string","pattern":"^trun_","example":"trun_AbC123xYz456","description":"The task run this entry summarizes. `GET /v2/task-runs/{run_id}` is the authoritative record.","isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].task_run_id","typeLabel":"string"},"status":{"type":"string","description":"The task run's status.","isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].status","typeLabel":"string"},"result":{"oneOf":[{"type":"null","description":"`success`, `failure`, or `unknown`. `null` until terminal.","isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].result.oneOf.0","typeLabel":"null"},{"type":"string","description":"`success`, `failure`, or `unknown`. `null` until terminal.","isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].result.oneOf.1","typeLabel":"string"}],"isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].result","typeLabel":"null | string"},"created_at":{"type":"string","format":"date-time","example":"2026-06-18T00:00:00Z","description":"When the task run was created. Because steps run sequentially, this is when the step or item started.","isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].created_at","typeLabel":"string\u003cdate-time>"},"runtime_ms":{"oneOf":[{"type":"null","format":"int32","description":"Execution time in milliseconds. `null` until terminal, and for a run that failed before it started.","isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].runtime_ms.oneOf.0","typeLabel":"null"},{"type":"integer","format":"int32","description":"Execution time in milliseconds. `null` until terminal, and for a run that failed before it started.","isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].runtime_ms.oneOf.1","typeLabel":"integer\u003cint32>"}],"isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].runtime_ms","typeLabel":"null | integer\u003cint32>"},"errors":{"oneOf":[{"type":"null","items":{"required":["type","code","message"],"type":"object","properties":{"type":{"type":"string","description":"Error category (e.g. `source`, `auth`, `task`, `rate_limit`). Determines the class of failure."},"code":{"type":"string","description":"Machine-readable error code. Use this for programmatic handling."},"message":{"type":"string","description":"Human-readable explanation. Do not rely on this for logic — it may change."},"field":{"oneOf":[{"type":"null","description":"The input field that caused the error, when applicable."},{"type":"string","description":"The input field that caused the error, when applicable."}]}},"description":"Error details for a failed task run. Same structure as API-level errors."},"description":"Errors for this run when it failed. `null` otherwise.","isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].errors.oneOf.0","typeLabel":"null"},{"type":"array","items":{"required":["type","code","message"],"type":"object","properties":{"type":{"type":"string","description":"Error category (e.g. `source`, `auth`, `task`, `rate_limit`). Determines the class of failure.","isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].errors.oneOf.1.items.[INDEX].type","typeLabel":"string"},"code":{"type":"string","description":"Machine-readable error code. Use this for programmatic handling.","isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].errors.oneOf.1.items.[INDEX].code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable explanation. Do not rely on this for logic — it may change.","isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].errors.oneOf.1.items.[INDEX].message","typeLabel":"string"},"field":{"oneOf":[{"type":"null","description":"The input field that caused the error, when applicable.","uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].errors.oneOf.1.items.[INDEX].field.oneOf.0","typeLabel":"null"},{"type":"string","description":"The input field that caused the error, when applicable.","uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].errors.oneOf.1.items.[INDEX].field.oneOf.1","typeLabel":"string"}],"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].errors.oneOf.1.items.[INDEX].field","typeLabel":"null | string"}},"description":"Error details for a failed task run. Same structure as API-level errors.","uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].errors.oneOf.1.items.[INDEX]","typeLabel":"object"},"description":"Errors for this run when it failed. `null` otherwise.","isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].errors.oneOf.1","typeLabel":"object[]"}],"isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].errors","typeLabel":"null | object[]"},"item":{"oneOf":[{"type":"null","description":"`for_each` only. The input item this run processed.","uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].item.oneOf.0","typeLabel":"null"},{"description":"`for_each` only. The input item this run processed.","uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].item.oneOf.1","typeLabel":"any"}],"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].item","typeLabel":"null | any"},"input":{"oneOf":[{"type":"null","description":"The resolved input this run received, with references substituted. Returned only when `include=input` is requested.","uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].input.oneOf.0","typeLabel":"null"},{"description":"The resolved input this run received, with references substituted. Returned only when `include=input` is requested.","uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].input.oneOf.1","typeLabel":"any"}],"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].input","typeLabel":"null | any"},"storage":{"oneOf":[{"type":"null","items":{"required":["id","object","file_name","file_type","file_size","purpose","created_at"],"type":"object","properties":{"id":{"type":"string","description":"Unique identifier for the storage item, prefixed with `stor_`.","pattern":"^stor_","example":"stor_AbC123xYz456"},"object":{"type":"string","description":"Always `storage`."},"file_name":{"type":"string","description":"Original file name."},"file_type":{"type":"string","description":"MIME type of the file."},"file_size":{"oneOf":[{"pattern":"^-?(?:0|[1-9]\\d*)$","type":"integer","format":"int64","description":"Size of the file in bytes."},{"pattern":"^-?(?:0|[1-9]\\d*)$","type":"string","format":"int64","description":"Size of the file in bytes."}]},"url":{"oneOf":[{"type":"null","description":"Signed URL to download the file. Time-limited."},{"type":"string","description":"Signed URL to download the file. Time-limited."}]},"extraction":{"oneOf":[{"type":"null","description":"Extracted structured data from the file, if any."},{"description":"Extracted structured data from the file, if any."}]},"purpose":{"type":"string","enum":["attachment","extraction","output"],"description":"How the file relates to the run: `attachment` (a file you provided as task input for the agent to use), `extraction` (a file you provided as task input that Deck extracts data from directly, skipping the agent), or `output` (a file the agent captured during the run)."},"created_at":{"type":"string","format":"date-time","description":"When the storage item was created.","example":"2026-08-24T12:00:00Z"}},"description":"A storage item embedded in the task run detail response when include=storage is requested. Includes the signed download URL and any inline extraction."},"description":"Files captured during this run, each with inline extraction (if any). Returned only when `include=storage` is requested.","uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].storage.oneOf.0","typeLabel":"null"},{"type":"array","items":{"required":["id","object","file_name","file_type","file_size","purpose","created_at"],"type":"object","properties":{"id":{"type":"string","description":"Unique identifier for the storage item, prefixed with `stor_`.","pattern":"^stor_","example":"stor_AbC123xYz456","isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].storage.oneOf.1.items.[INDEX].id","typeLabel":"string"},"object":{"type":"string","description":"Always `storage`.","isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].storage.oneOf.1.items.[INDEX].object","typeLabel":"string"},"file_name":{"type":"string","description":"Original file name.","isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].storage.oneOf.1.items.[INDEX].file_name","typeLabel":"string"},"file_type":{"type":"string","description":"MIME type of the file.","isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].storage.oneOf.1.items.[INDEX].file_type","typeLabel":"string"},"file_size":{"oneOf":[{"pattern":"^-?(?:0|[1-9]\\d*)$","type":"integer","format":"int64","description":"Size of the file in bytes.","isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].storage.oneOf.1.items.[INDEX].file_size.oneOf.0","typeLabel":"integer\u003cint64>"},{"pattern":"^-?(?:0|[1-9]\\d*)$","type":"string","format":"int64","description":"Size of the file in bytes.","isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].storage.oneOf.1.items.[INDEX].file_size.oneOf.1","typeLabel":"string\u003cint64>"}],"isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].storage.oneOf.1.items.[INDEX].file_size","typeLabel":"integer\u003cint64> | string\u003cint64>"},"purpose":{"type":"string","enum":["attachment","extraction","output"],"description":"How the file relates to the run: `attachment` (a file you provided as task input for the agent to use), `extraction` (a file you provided as task input that Deck extracts data from directly, skipping the agent), or `output` (a file the agent captured during the run).","isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].storage.oneOf.1.items.[INDEX].purpose","typeLabel":"enum\u003cstring>"},"created_at":{"type":"string","format":"date-time","description":"When the storage item was created.","example":"2026-08-24T12:00:00Z","isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].storage.oneOf.1.items.[INDEX].created_at","typeLabel":"string\u003cdate-time>"},"url":{"oneOf":[{"type":"null","description":"Signed URL to download the file. Time-limited.","uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].storage.oneOf.1.items.[INDEX].url.oneOf.0","typeLabel":"null"},{"type":"string","description":"Signed URL to download the file. Time-limited.","uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].storage.oneOf.1.items.[INDEX].url.oneOf.1","typeLabel":"string"}],"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].storage.oneOf.1.items.[INDEX].url","typeLabel":"null | string"},"extraction":{"oneOf":[{"type":"null","description":"Extracted structured data from the file, if any.","uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].storage.oneOf.1.items.[INDEX].extraction.oneOf.0","typeLabel":"null"},{"description":"Extracted structured data from the file, if any.","uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].storage.oneOf.1.items.[INDEX].extraction.oneOf.1","typeLabel":"any"}],"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].storage.oneOf.1.items.[INDEX].extraction","typeLabel":"null | any"}},"description":"A storage item embedded in the task run detail response when include=storage is requested. Includes the signed download URL and any inline extraction.","uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].storage.oneOf.1.items.[INDEX]","typeLabel":"object"},"description":"Files captured during this run, each with inline extraction (if any). Returned only when `include=storage` is requested.","uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].storage.oneOf.1","typeLabel":"object[]"}],"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].storage","typeLabel":"null | object[]"},"artifacts":{"oneOf":[{"type":"null","description":"Screenshots for this run. Returned only when `include=artifacts` is requested.","uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].artifacts.oneOf.0","typeLabel":"null"},{"type":"object","description":"Screenshots for this run. Returned only when `include=artifacts` is requested.","required":["screenshots"],"properties":{"screenshots":{"type":"array","items":{"required":["file_name","file_type","file_size","created_at"],"type":"object","properties":{"file_name":{"type":"string","description":"Original file name.","isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].artifacts.oneOf.1.screenshots.items.[INDEX].file_name","typeLabel":"string"},"file_type":{"type":"string","description":"MIME type of the screenshot.","isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].artifacts.oneOf.1.screenshots.items.[INDEX].file_type","typeLabel":"string"},"file_size":{"oneOf":[{"pattern":"^-?(?:0|[1-9]\\d*)$","type":"integer","format":"int64","description":"Size of the file in bytes.","isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].artifacts.oneOf.1.screenshots.items.[INDEX].file_size.oneOf.0","typeLabel":"integer\u003cint64>"},{"pattern":"^-?(?:0|[1-9]\\d*)$","type":"string","format":"int64","description":"Size of the file in bytes.","isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].artifacts.oneOf.1.screenshots.items.[INDEX].file_size.oneOf.1","typeLabel":"string\u003cint64>"}],"isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].artifacts.oneOf.1.screenshots.items.[INDEX].file_size","typeLabel":"integer\u003cint64> | string\u003cint64>"},"created_at":{"type":"string","format":"date-time","description":"When the screenshot was captured.","example":"2026-08-24T12:00:00Z","isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].artifacts.oneOf.1.screenshots.items.[INDEX].created_at","typeLabel":"string\u003cdate-time>"},"url":{"oneOf":[{"type":"null","description":"Signed URL to download the screenshot. Time-limited.","uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].artifacts.oneOf.1.screenshots.items.[INDEX].url.oneOf.0","typeLabel":"null"},{"type":"string","description":"Signed URL to download the screenshot. Time-limited.","uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].artifacts.oneOf.1.screenshots.items.[INDEX].url.oneOf.1","typeLabel":"string"}],"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].artifacts.oneOf.1.screenshots.items.[INDEX].url","typeLabel":"null | string"},"reasoning":{"oneOf":[{"type":"null","description":"AI reasoning at the time of capture, if recorded.","uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].artifacts.oneOf.1.screenshots.items.[INDEX].reasoning.oneOf.0","typeLabel":"null"},{"type":"string","description":"AI reasoning at the time of capture, if recorded.","uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].artifacts.oneOf.1.screenshots.items.[INDEX].reasoning.oneOf.1","typeLabel":"string"}],"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].artifacts.oneOf.1.screenshots.items.[INDEX].reasoning","typeLabel":"null | string"}},"description":"A single screenshot captured during a task run.","uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].artifacts.oneOf.1.screenshots.items.[INDEX]","typeLabel":"object"},"description":"Screenshots captured during the run.","isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].artifacts.oneOf.1.screenshots","typeLabel":"object[]"}},"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].artifacts.oneOf.1","typeLabel":"object"}],"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].artifacts","typeLabel":"null | object"}},"description":"A compact summary of one task run a step produced.","uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX]","typeLabel":"object"},"description":"The task runs this step produced, in order: one for a `task` step, one per item processed for a `for_each`, none for a skipped step. Returned on single-run responses; omitted from list responses.","uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1","typeLabel":"object[]"}],"uniqueKey":"steps.items.[INDEX].task_runs","typeLabel":"null | object[]"}},"description":"One step's state within a workflow run.","uniqueKey":"steps.items.[INDEX]","typeLabel":"object"},"description":"Per-step state, in definition order.","isRequired":true,"uniqueKey":"steps","typeLabel":"object[]"},"errors":{"oneOf":[{"type":"null","items":{"type":"object","required":["type","code","message"],"properties":{"type":{"type":"string","description":"Error category (e.g. `source`, `auth`, `task`)."},"code":{"type":"string","description":"Machine-readable error code."},"message":{"type":"string","description":"Human-readable explanation. Do not rely on this for logic; it may change."},"field":{"oneOf":[{"type":"null","description":"The input field that caused the error, when applicable. Omitted otherwise."},{"type":"string","description":"The input field that caused the error, when applicable. Omitted otherwise."}]},"step":{"oneOf":[{"type":"null","description":"The step that caused the run to fail."},{"type":"string","description":"The step that caused the run to fail."}]}},"description":"A standard Deck error object plus the `step` that caused the failure. The same error, without `step`, appears on that step's `task_runs` entry."},"description":"Error objects, each naming its `step`, when the run failed. `null` otherwise.","isRequired":true,"uniqueKey":"errors.oneOf.0","typeLabel":"null"},{"type":"array","items":{"type":"object","required":["type","code","message"],"properties":{"type":{"type":"string","description":"Error category (e.g. `source`, `auth`, `task`).","isRequired":true,"uniqueKey":"errors.oneOf.1.items.[INDEX].type","typeLabel":"string"},"code":{"type":"string","description":"Machine-readable error code.","isRequired":true,"uniqueKey":"errors.oneOf.1.items.[INDEX].code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable explanation. Do not rely on this for logic; it may change.","isRequired":true,"uniqueKey":"errors.oneOf.1.items.[INDEX].message","typeLabel":"string"},"field":{"oneOf":[{"type":"null","description":"The input field that caused the error, when applicable. Omitted otherwise.","uniqueKey":"errors.oneOf.1.items.[INDEX].field.oneOf.0","typeLabel":"null"},{"type":"string","description":"The input field that caused the error, when applicable. Omitted otherwise.","uniqueKey":"errors.oneOf.1.items.[INDEX].field.oneOf.1","typeLabel":"string"}],"uniqueKey":"errors.oneOf.1.items.[INDEX].field","typeLabel":"null | string"},"step":{"oneOf":[{"type":"null","description":"The step that caused the run to fail.","uniqueKey":"errors.oneOf.1.items.[INDEX].step.oneOf.0","typeLabel":"null"},{"type":"string","description":"The step that caused the run to fail.","uniqueKey":"errors.oneOf.1.items.[INDEX].step.oneOf.1","typeLabel":"string"}],"uniqueKey":"errors.oneOf.1.items.[INDEX].step","typeLabel":"null | string"}},"description":"A standard Deck error object plus the `step` that caused the failure. The same error, without `step`, appears on that step's `task_runs` entry.","uniqueKey":"errors.oneOf.1.items.[INDEX]","typeLabel":"object"},"description":"Error objects, each naming its `step`, when the run failed. `null` otherwise.","isRequired":true,"uniqueKey":"errors.oneOf.1","typeLabel":"object[]"}],"isRequired":true,"uniqueKey":"errors","typeLabel":"null | object[]"},"created_at":{"type":"string","format":"date-time","example":"2026-06-18T00:00:00Z","isRequired":true,"uniqueKey":"created_at","typeLabel":"string\u003cdate-time>"},"updated_at":{"type":"string","format":"date-time","example":"2026-06-18T00:00:00Z","isRequired":true,"uniqueKey":"updated_at","typeLabel":"string\u003cdate-time>"},"request_id":{"type":"string","description":"Unique identifier for the API request. Include this when contacting support.","uniqueKey":"request_id","typeLabel":"string"},"interactions_suppressed":{"type":"boolean","description":"`true` when the run was created with `interactions_suppressed`. Omitted otherwise.","uniqueKey":"interactions_suppressed","typeLabel":"boolean"}},"description":"Workflow run object.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"wrun_AbC123xYz456","object":"\u003cstring>","workflow_id":"wflo_AbC123xYz456","status":"queued","result":"\u003cstring>","runtime_ms":123,"session_id":"\u003cstring>","trigger_id":"\u003cstring>","steps":[{"name":"\u003cstring>","type":"task","status":"\u003cstring>","output":"\u003cunknown>","task_runs":[{"task_run_id":"trun_AbC123xYz456","status":"\u003cstring>","result":"\u003cstring>","created_at":"2026-06-18T00:00:00Z","runtime_ms":123,"errors":[{"type":"\u003cstring>","code":"\u003cstring>","message":"\u003cstring>","field":"\u003cstring>"}],"item":"\u003cunknown>","input":"\u003cunknown>","storage":[{"id":"stor_AbC123xYz456","object":"\u003cstring>","file_name":"\u003cstring>","file_type":"\u003cstring>","file_size":123,"purpose":"attachment","created_at":"2026-08-24T12:00:00Z","url":"\u003cstring>","extraction":"\u003cunknown>"}],"artifacts":{"screenshots":[{"file_name":"\u003cstring>","file_type":"\u003cstring>","file_size":123,"created_at":"2026-08-24T12:00:00Z","url":"\u003cstring>","reasoning":"\u003cstring>"}]}}]}],"errors":[{"type":"\u003cstring>","code":"\u003cstring>","message":"\u003cstring>","field":"\u003cstring>","step":"\u003cstring>"}],"created_at":"2026-06-18T00:00:00Z","updated_at":"2026-06-18T00:00:00Z","request_id":"\u003cstring>","interactions_suppressed":true}}},"exampleType":"generated"},"application/json":{"schema":{"type":"object","required":["id","object","workflow_id","status","result","runtime_ms","session_id","trigger_id","steps","errors","created_at","updated_at"],"properties":{"id":{"type":"string","pattern":"^wrun_","example":"wrun_AbC123xYz456","description":"Unique identifier for the workflow run, prefixed with `wrun_`.","isRequired":true,"uniqueKey":"id","typeLabel":"string"},"object":{"type":"string","description":"Always `workflow_run`.","isRequired":true,"uniqueKey":"object","typeLabel":"string"},"workflow_id":{"type":"string","pattern":"^wflo_","example":"wflo_AbC123xYz456","description":"The workflow that was run.","isRequired":true,"uniqueKey":"workflow_id","typeLabel":"string"},"status":{"type":"string","enum":["queued","running","paused","completed","failed","canceling","canceled"],"description":"Lifecycle state. `paused` means the current step is waiting on external input; the step's own status carries the reason.","isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"result":{"oneOf":[{"type":"null","description":"Outcome once terminal: `success` only when every task run succeeded, `failure` if any failed, `unknown` otherwise. `null` while running and for a canceled run.","isRequired":true,"uniqueKey":"result.oneOf.0","typeLabel":"null"},{"type":"string","description":"Outcome once terminal: `success` only when every task run succeeded, `failure` if any failed, `unknown` otherwise. `null` while running and for a canceled run.","isRequired":true,"uniqueKey":"result.oneOf.1","typeLabel":"string"}],"isRequired":true,"uniqueKey":"result","typeLabel":"null | string"},"runtime_ms":{"oneOf":[{"type":"null","format":"int64","description":"Milliseconds from the first step's start until the run reached a terminal status, excluding time spent queued. `null` until terminal.","isRequired":true,"uniqueKey":"runtime_ms.oneOf.0","typeLabel":"null"},{"type":"integer","format":"int64","description":"Milliseconds from the first step's start until the run reached a terminal status, excluding time spent queued. `null` until terminal.","isRequired":true,"uniqueKey":"runtime_ms.oneOf.1","typeLabel":"integer\u003cint64>"}],"isRequired":true,"uniqueKey":"runtime_ms","typeLabel":"null | integer\u003cint64>"},"session_id":{"oneOf":[{"type":"null","description":"The session every step of this run executes in. Prefixed with `sess_`. Assigned when the run is created through the API, or when a trigger-created run is admitted, so `null` while such a run is queued.","isRequired":true,"uniqueKey":"session_id.oneOf.0","typeLabel":"null"},{"type":"string","description":"The session every step of this run executes in. Prefixed with `sess_`. Assigned when the run is created through the API, or when a trigger-created run is admitted, so `null` while such a run is queued.","isRequired":true,"uniqueKey":"session_id.oneOf.1","typeLabel":"string"}],"isRequired":true,"uniqueKey":"session_id","typeLabel":"null | string"},"trigger_id":{"oneOf":[{"type":"null","description":"The trigger that created this run. Prefixed with `trg_`. `null` for runs created through the API.","isRequired":true,"uniqueKey":"trigger_id.oneOf.0","typeLabel":"null"},{"type":"string","description":"The trigger that created this run. Prefixed with `trg_`. `null` for runs created through the API.","isRequired":true,"uniqueKey":"trigger_id.oneOf.1","typeLabel":"string"}],"isRequired":true,"uniqueKey":"trigger_id","typeLabel":"null | string"},"steps":{"type":"array","items":{"type":"object","required":["name","type","status","output"],"properties":{"name":{"type":"string","description":"The step's name, matching the definition.","isRequired":true,"uniqueKey":"steps.items.[INDEX].name","typeLabel":"string"},"type":{"type":"string","enum":["task","for_each"],"description":"`task` or `for_each`.","isRequired":true,"uniqueKey":"steps.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"status":{"type":"string","description":"The underlying task run's status (`queued`, `running`, `interaction_required`, `review_required`, `completed`, `failed`, `canceling`, `canceled`), plus `skipped` when the step's `if` evaluated false. A `for_each` aggregates its items.","isRequired":true,"uniqueKey":"steps.items.[INDEX].status","typeLabel":"string"},"output":{"oneOf":[{"type":"null","description":"What references to this step resolve to: the task's output, or the ordered array of per-item outputs for a `for_each`. `null` until completion, and for a skipped step.","isRequired":true,"uniqueKey":"steps.items.[INDEX].output.oneOf.0","typeLabel":"null"},{"description":"What references to this step resolve to: the task's output, or the ordered array of per-item outputs for a `for_each`. `null` until completion, and for a skipped step.","isRequired":true,"uniqueKey":"steps.items.[INDEX].output.oneOf.1","typeLabel":"any"}],"isRequired":true,"uniqueKey":"steps.items.[INDEX].output","typeLabel":"null | any"},"task_runs":{"oneOf":[{"type":"null","items":{"type":"object","required":["task_run_id","status","result","created_at","runtime_ms","errors"],"properties":{"task_run_id":{"type":"string","pattern":"^trun_","example":"trun_AbC123xYz456","description":"The task run this entry summarizes. `GET /v2/task-runs/{run_id}` is the authoritative record."},"status":{"type":"string","description":"The task run's status."},"result":{"oneOf":[{"type":"null","description":"`success`, `failure`, or `unknown`. `null` until terminal."},{"type":"string","description":"`success`, `failure`, or `unknown`. `null` until terminal."}]},"created_at":{"type":"string","format":"date-time","example":"2026-06-18T00:00:00Z","description":"When the task run was created. Because steps run sequentially, this is when the step or item started."},"runtime_ms":{"oneOf":[{"type":"null","format":"int32","description":"Execution time in milliseconds. `null` until terminal, and for a run that failed before it started."},{"type":"integer","format":"int32","description":"Execution time in milliseconds. `null` until terminal, and for a run that failed before it started."}]},"errors":{"oneOf":[{"type":"null","items":{"required":["type","code","message"],"type":"object","properties":{"type":{"type":"string","description":"Error category (e.g. `source`, `auth`, `task`, `rate_limit`). Determines the class of failure."},"code":{"type":"string","description":"Machine-readable error code. Use this for programmatic handling."},"message":{"type":"string","description":"Human-readable explanation. Do not rely on this for logic — it may change."},"field":{"oneOf":[{"type":"null","description":"The input field that caused the error, when applicable."},{"type":"string","description":"The input field that caused the error, when applicable."}]}},"description":"Error details for a failed task run. Same structure as API-level errors."},"description":"Errors for this run when it failed. `null` otherwise."},{"type":"array","items":{"required":["type","code","message"],"type":"object","properties":{"type":{"type":"string","description":"Error category (e.g. `source`, `auth`, `task`, `rate_limit`). Determines the class of failure."},"code":{"type":"string","description":"Machine-readable error code. Use this for programmatic handling."},"message":{"type":"string","description":"Human-readable explanation. Do not rely on this for logic — it may change."},"field":{"oneOf":[{"type":"null","description":"The input field that caused the error, when applicable."},{"type":"string","description":"The input field that caused the error, when applicable."}]}},"description":"Error details for a failed task run. Same structure as API-level errors."},"description":"Errors for this run when it failed. `null` otherwise."}]},"item":{"oneOf":[{"type":"null","description":"`for_each` only. The input item this run processed."},{"description":"`for_each` only. The input item this run processed."}]},"input":{"oneOf":[{"type":"null","description":"The resolved input this run received, with references substituted. Returned only when `include=input` is requested."},{"description":"The resolved input this run received, with references substituted. Returned only when `include=input` is requested."}]},"storage":{"oneOf":[{"type":"null","items":{"required":["id","object","file_name","file_type","file_size","purpose","created_at"],"type":"object","properties":{"id":{"type":"string","description":"Unique identifier for the storage item, prefixed with `stor_`.","pattern":"^stor_","example":"stor_AbC123xYz456"},"object":{"type":"string","description":"Always `storage`."},"file_name":{"type":"string","description":"Original file name."},"file_type":{"type":"string","description":"MIME type of the file."},"file_size":{"oneOf":[{"pattern":"^-?(?:0|[1-9]\\d*)$","type":"integer","format":"int64","description":"Size of the file in bytes."},{"pattern":"^-?(?:0|[1-9]\\d*)$","type":"string","format":"int64","description":"Size of the file in bytes."}]},"url":{"oneOf":[{"type":"null","description":"Signed URL to download the file. Time-limited."},{"type":"string","description":"Signed URL to download the file. Time-limited."}]},"extraction":{"oneOf":[{"type":"null","description":"Extracted structured data from the file, if any."},{"description":"Extracted structured data from the file, if any."}]},"purpose":{"type":"string","enum":["attachment","extraction","output"],"description":"How the file relates to the run: `attachment` (a file you provided as task input for the agent to use), `extraction` (a file you provided as task input that Deck extracts data from directly, skipping the agent), or `output` (a file the agent captured during the run)."},"created_at":{"type":"string","format":"date-time","description":"When the storage item was created.","example":"2026-08-24T12:00:00Z"}},"description":"A storage item embedded in the task run detail response when include=storage is requested. Includes the signed download URL and any inline extraction."},"description":"Files captured during this run, each with inline extraction (if any). Returned only when `include=storage` is requested."},{"type":"array","items":{"required":["id","object","file_name","file_type","file_size","purpose","created_at"],"type":"object","properties":{"id":{"type":"string","description":"Unique identifier for the storage item, prefixed with `stor_`.","pattern":"^stor_","example":"stor_AbC123xYz456"},"object":{"type":"string","description":"Always `storage`."},"file_name":{"type":"string","description":"Original file name."},"file_type":{"type":"string","description":"MIME type of the file."},"file_size":{"oneOf":[{"pattern":"^-?(?:0|[1-9]\\d*)$","type":"integer","format":"int64","description":"Size of the file in bytes."},{"pattern":"^-?(?:0|[1-9]\\d*)$","type":"string","format":"int64","description":"Size of the file in bytes."}]},"url":{"oneOf":[{"type":"null","description":"Signed URL to download the file. Time-limited."},{"type":"string","description":"Signed URL to download the file. Time-limited."}]},"extraction":{"oneOf":[{"type":"null","description":"Extracted structured data from the file, if any."},{"description":"Extracted structured data from the file, if any."}]},"purpose":{"type":"string","enum":["attachment","extraction","output"],"description":"How the file relates to the run: `attachment` (a file you provided as task input for the agent to use), `extraction` (a file you provided as task input that Deck extracts data from directly, skipping the agent), or `output` (a file the agent captured during the run)."},"created_at":{"type":"string","format":"date-time","description":"When the storage item was created.","example":"2026-08-24T12:00:00Z"}},"description":"A storage item embedded in the task run detail response when include=storage is requested. Includes the signed download URL and any inline extraction."},"description":"Files captured during this run, each with inline extraction (if any). Returned only when `include=storage` is requested."}]},"artifacts":{"oneOf":[{"type":"null","description":"Screenshots for this run. Returned only when `include=artifacts` is requested."},{"type":"object","description":"Screenshots for this run. Returned only when `include=artifacts` is requested.","required":["screenshots"],"properties":{"screenshots":{"type":"array","items":{"required":["file_name","file_type","file_size","created_at"],"type":"object","properties":{"file_name":{"type":"string","description":"Original file name."},"file_type":{"type":"string","description":"MIME type of the screenshot."},"file_size":{"oneOf":[{"pattern":"^-?(?:0|[1-9]\\d*)$","type":"integer","format":"int64","description":"Size of the file in bytes."},{"pattern":"^-?(?:0|[1-9]\\d*)$","type":"string","format":"int64","description":"Size of the file in bytes."}]},"url":{"oneOf":[{"type":"null","description":"Signed URL to download the screenshot. Time-limited."},{"type":"string","description":"Signed URL to download the screenshot. Time-limited."}]},"reasoning":{"oneOf":[{"type":"null","description":"AI reasoning at the time of capture, if recorded."},{"type":"string","description":"AI reasoning at the time of capture, if recorded."}]},"created_at":{"type":"string","format":"date-time","description":"When the screenshot was captured.","example":"2026-08-24T12:00:00Z"}},"description":"A single screenshot captured during a task run."},"description":"Screenshots captured during the run."}}}]}},"description":"A compact summary of one task run a step produced."},"description":"The task runs this step produced, in order: one for a `task` step, one per item processed for a `for_each`, none for a skipped step. Returned on single-run responses; omitted from list responses.","uniqueKey":"steps.items.[INDEX].task_runs.oneOf.0","typeLabel":"null"},{"type":"array","items":{"type":"object","required":["task_run_id","status","result","created_at","runtime_ms","errors"],"properties":{"task_run_id":{"type":"string","pattern":"^trun_","example":"trun_AbC123xYz456","description":"The task run this entry summarizes. `GET /v2/task-runs/{run_id}` is the authoritative record.","isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].task_run_id","typeLabel":"string"},"status":{"type":"string","description":"The task run's status.","isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].status","typeLabel":"string"},"result":{"oneOf":[{"type":"null","description":"`success`, `failure`, or `unknown`. `null` until terminal.","isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].result.oneOf.0","typeLabel":"null"},{"type":"string","description":"`success`, `failure`, or `unknown`. `null` until terminal.","isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].result.oneOf.1","typeLabel":"string"}],"isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].result","typeLabel":"null | string"},"created_at":{"type":"string","format":"date-time","example":"2026-06-18T00:00:00Z","description":"When the task run was created. Because steps run sequentially, this is when the step or item started.","isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].created_at","typeLabel":"string\u003cdate-time>"},"runtime_ms":{"oneOf":[{"type":"null","format":"int32","description":"Execution time in milliseconds. `null` until terminal, and for a run that failed before it started.","isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].runtime_ms.oneOf.0","typeLabel":"null"},{"type":"integer","format":"int32","description":"Execution time in milliseconds. `null` until terminal, and for a run that failed before it started.","isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].runtime_ms.oneOf.1","typeLabel":"integer\u003cint32>"}],"isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].runtime_ms","typeLabel":"null | integer\u003cint32>"},"errors":{"oneOf":[{"type":"null","items":{"required":["type","code","message"],"type":"object","properties":{"type":{"type":"string","description":"Error category (e.g. `source`, `auth`, `task`, `rate_limit`). Determines the class of failure."},"code":{"type":"string","description":"Machine-readable error code. Use this for programmatic handling."},"message":{"type":"string","description":"Human-readable explanation. Do not rely on this for logic — it may change."},"field":{"oneOf":[{"type":"null","description":"The input field that caused the error, when applicable."},{"type":"string","description":"The input field that caused the error, when applicable."}]}},"description":"Error details for a failed task run. Same structure as API-level errors."},"description":"Errors for this run when it failed. `null` otherwise.","isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].errors.oneOf.0","typeLabel":"null"},{"type":"array","items":{"required":["type","code","message"],"type":"object","properties":{"type":{"type":"string","description":"Error category (e.g. `source`, `auth`, `task`, `rate_limit`). Determines the class of failure.","isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].errors.oneOf.1.items.[INDEX].type","typeLabel":"string"},"code":{"type":"string","description":"Machine-readable error code. Use this for programmatic handling.","isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].errors.oneOf.1.items.[INDEX].code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable explanation. Do not rely on this for logic — it may change.","isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].errors.oneOf.1.items.[INDEX].message","typeLabel":"string"},"field":{"oneOf":[{"type":"null","description":"The input field that caused the error, when applicable.","uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].errors.oneOf.1.items.[INDEX].field.oneOf.0","typeLabel":"null"},{"type":"string","description":"The input field that caused the error, when applicable.","uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].errors.oneOf.1.items.[INDEX].field.oneOf.1","typeLabel":"string"}],"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].errors.oneOf.1.items.[INDEX].field","typeLabel":"null | string"}},"description":"Error details for a failed task run. Same structure as API-level errors.","uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].errors.oneOf.1.items.[INDEX]","typeLabel":"object"},"description":"Errors for this run when it failed. `null` otherwise.","isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].errors.oneOf.1","typeLabel":"object[]"}],"isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].errors","typeLabel":"null | object[]"},"item":{"oneOf":[{"type":"null","description":"`for_each` only. The input item this run processed.","uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].item.oneOf.0","typeLabel":"null"},{"description":"`for_each` only. The input item this run processed.","uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].item.oneOf.1","typeLabel":"any"}],"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].item","typeLabel":"null | any"},"input":{"oneOf":[{"type":"null","description":"The resolved input this run received, with references substituted. Returned only when `include=input` is requested.","uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].input.oneOf.0","typeLabel":"null"},{"description":"The resolved input this run received, with references substituted. Returned only when `include=input` is requested.","uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].input.oneOf.1","typeLabel":"any"}],"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].input","typeLabel":"null | any"},"storage":{"oneOf":[{"type":"null","items":{"required":["id","object","file_name","file_type","file_size","purpose","created_at"],"type":"object","properties":{"id":{"type":"string","description":"Unique identifier for the storage item, prefixed with `stor_`.","pattern":"^stor_","example":"stor_AbC123xYz456"},"object":{"type":"string","description":"Always `storage`."},"file_name":{"type":"string","description":"Original file name."},"file_type":{"type":"string","description":"MIME type of the file."},"file_size":{"oneOf":[{"pattern":"^-?(?:0|[1-9]\\d*)$","type":"integer","format":"int64","description":"Size of the file in bytes."},{"pattern":"^-?(?:0|[1-9]\\d*)$","type":"string","format":"int64","description":"Size of the file in bytes."}]},"url":{"oneOf":[{"type":"null","description":"Signed URL to download the file. Time-limited."},{"type":"string","description":"Signed URL to download the file. Time-limited."}]},"extraction":{"oneOf":[{"type":"null","description":"Extracted structured data from the file, if any."},{"description":"Extracted structured data from the file, if any."}]},"purpose":{"type":"string","enum":["attachment","extraction","output"],"description":"How the file relates to the run: `attachment` (a file you provided as task input for the agent to use), `extraction` (a file you provided as task input that Deck extracts data from directly, skipping the agent), or `output` (a file the agent captured during the run)."},"created_at":{"type":"string","format":"date-time","description":"When the storage item was created.","example":"2026-08-24T12:00:00Z"}},"description":"A storage item embedded in the task run detail response when include=storage is requested. Includes the signed download URL and any inline extraction."},"description":"Files captured during this run, each with inline extraction (if any). Returned only when `include=storage` is requested.","uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].storage.oneOf.0","typeLabel":"null"},{"type":"array","items":{"required":["id","object","file_name","file_type","file_size","purpose","created_at"],"type":"object","properties":{"id":{"type":"string","description":"Unique identifier for the storage item, prefixed with `stor_`.","pattern":"^stor_","example":"stor_AbC123xYz456","isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].storage.oneOf.1.items.[INDEX].id","typeLabel":"string"},"object":{"type":"string","description":"Always `storage`.","isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].storage.oneOf.1.items.[INDEX].object","typeLabel":"string"},"file_name":{"type":"string","description":"Original file name.","isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].storage.oneOf.1.items.[INDEX].file_name","typeLabel":"string"},"file_type":{"type":"string","description":"MIME type of the file.","isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].storage.oneOf.1.items.[INDEX].file_type","typeLabel":"string"},"file_size":{"oneOf":[{"pattern":"^-?(?:0|[1-9]\\d*)$","type":"integer","format":"int64","description":"Size of the file in bytes.","isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].storage.oneOf.1.items.[INDEX].file_size.oneOf.0","typeLabel":"integer\u003cint64>"},{"pattern":"^-?(?:0|[1-9]\\d*)$","type":"string","format":"int64","description":"Size of the file in bytes.","isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].storage.oneOf.1.items.[INDEX].file_size.oneOf.1","typeLabel":"string\u003cint64>"}],"isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].storage.oneOf.1.items.[INDEX].file_size","typeLabel":"integer\u003cint64> | string\u003cint64>"},"purpose":{"type":"string","enum":["attachment","extraction","output"],"description":"How the file relates to the run: `attachment` (a file you provided as task input for the agent to use), `extraction` (a file you provided as task input that Deck extracts data from directly, skipping the agent), or `output` (a file the agent captured during the run).","isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].storage.oneOf.1.items.[INDEX].purpose","typeLabel":"enum\u003cstring>"},"created_at":{"type":"string","format":"date-time","description":"When the storage item was created.","example":"2026-08-24T12:00:00Z","isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].storage.oneOf.1.items.[INDEX].created_at","typeLabel":"string\u003cdate-time>"},"url":{"oneOf":[{"type":"null","description":"Signed URL to download the file. Time-limited.","uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].storage.oneOf.1.items.[INDEX].url.oneOf.0","typeLabel":"null"},{"type":"string","description":"Signed URL to download the file. Time-limited.","uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].storage.oneOf.1.items.[INDEX].url.oneOf.1","typeLabel":"string"}],"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].storage.oneOf.1.items.[INDEX].url","typeLabel":"null | string"},"extraction":{"oneOf":[{"type":"null","description":"Extracted structured data from the file, if any.","uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].storage.oneOf.1.items.[INDEX].extraction.oneOf.0","typeLabel":"null"},{"description":"Extracted structured data from the file, if any.","uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].storage.oneOf.1.items.[INDEX].extraction.oneOf.1","typeLabel":"any"}],"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].storage.oneOf.1.items.[INDEX].extraction","typeLabel":"null | any"}},"description":"A storage item embedded in the task run detail response when include=storage is requested. Includes the signed download URL and any inline extraction.","uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].storage.oneOf.1.items.[INDEX]","typeLabel":"object"},"description":"Files captured during this run, each with inline extraction (if any). Returned only when `include=storage` is requested.","uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].storage.oneOf.1","typeLabel":"object[]"}],"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].storage","typeLabel":"null | object[]"},"artifacts":{"oneOf":[{"type":"null","description":"Screenshots for this run. Returned only when `include=artifacts` is requested.","uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].artifacts.oneOf.0","typeLabel":"null"},{"type":"object","description":"Screenshots for this run. Returned only when `include=artifacts` is requested.","required":["screenshots"],"properties":{"screenshots":{"type":"array","items":{"required":["file_name","file_type","file_size","created_at"],"type":"object","properties":{"file_name":{"type":"string","description":"Original file name.","isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].artifacts.oneOf.1.screenshots.items.[INDEX].file_name","typeLabel":"string"},"file_type":{"type":"string","description":"MIME type of the screenshot.","isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].artifacts.oneOf.1.screenshots.items.[INDEX].file_type","typeLabel":"string"},"file_size":{"oneOf":[{"pattern":"^-?(?:0|[1-9]\\d*)$","type":"integer","format":"int64","description":"Size of the file in bytes.","isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].artifacts.oneOf.1.screenshots.items.[INDEX].file_size.oneOf.0","typeLabel":"integer\u003cint64>"},{"pattern":"^-?(?:0|[1-9]\\d*)$","type":"string","format":"int64","description":"Size of the file in bytes.","isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].artifacts.oneOf.1.screenshots.items.[INDEX].file_size.oneOf.1","typeLabel":"string\u003cint64>"}],"isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].artifacts.oneOf.1.screenshots.items.[INDEX].file_size","typeLabel":"integer\u003cint64> | string\u003cint64>"},"created_at":{"type":"string","format":"date-time","description":"When the screenshot was captured.","example":"2026-08-24T12:00:00Z","isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].artifacts.oneOf.1.screenshots.items.[INDEX].created_at","typeLabel":"string\u003cdate-time>"},"url":{"oneOf":[{"type":"null","description":"Signed URL to download the screenshot. Time-limited.","uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].artifacts.oneOf.1.screenshots.items.[INDEX].url.oneOf.0","typeLabel":"null"},{"type":"string","description":"Signed URL to download the screenshot. Time-limited.","uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].artifacts.oneOf.1.screenshots.items.[INDEX].url.oneOf.1","typeLabel":"string"}],"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].artifacts.oneOf.1.screenshots.items.[INDEX].url","typeLabel":"null | string"},"reasoning":{"oneOf":[{"type":"null","description":"AI reasoning at the time of capture, if recorded.","uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].artifacts.oneOf.1.screenshots.items.[INDEX].reasoning.oneOf.0","typeLabel":"null"},{"type":"string","description":"AI reasoning at the time of capture, if recorded.","uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].artifacts.oneOf.1.screenshots.items.[INDEX].reasoning.oneOf.1","typeLabel":"string"}],"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].artifacts.oneOf.1.screenshots.items.[INDEX].reasoning","typeLabel":"null | string"}},"description":"A single screenshot captured during a task run.","uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].artifacts.oneOf.1.screenshots.items.[INDEX]","typeLabel":"object"},"description":"Screenshots captured during the run.","isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].artifacts.oneOf.1.screenshots","typeLabel":"object[]"}},"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].artifacts.oneOf.1","typeLabel":"object"}],"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].artifacts","typeLabel":"null | object"}},"description":"A compact summary of one task run a step produced.","uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX]","typeLabel":"object"},"description":"The task runs this step produced, in order: one for a `task` step, one per item processed for a `for_each`, none for a skipped step. Returned on single-run responses; omitted from list responses.","uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1","typeLabel":"object[]"}],"uniqueKey":"steps.items.[INDEX].task_runs","typeLabel":"null | object[]"}},"description":"One step's state within a workflow run.","uniqueKey":"steps.items.[INDEX]","typeLabel":"object"},"description":"Per-step state, in definition order.","isRequired":true,"uniqueKey":"steps","typeLabel":"object[]"},"errors":{"oneOf":[{"type":"null","items":{"type":"object","required":["type","code","message"],"properties":{"type":{"type":"string","description":"Error category (e.g. `source`, `auth`, `task`)."},"code":{"type":"string","description":"Machine-readable error code."},"message":{"type":"string","description":"Human-readable explanation. Do not rely on this for logic; it may change."},"field":{"oneOf":[{"type":"null","description":"The input field that caused the error, when applicable. Omitted otherwise."},{"type":"string","description":"The input field that caused the error, when applicable. Omitted otherwise."}]},"step":{"oneOf":[{"type":"null","description":"The step that caused the run to fail."},{"type":"string","description":"The step that caused the run to fail."}]}},"description":"A standard Deck error object plus the `step` that caused the failure. The same error, without `step`, appears on that step's `task_runs` entry."},"description":"Error objects, each naming its `step`, when the run failed. `null` otherwise.","isRequired":true,"uniqueKey":"errors.oneOf.0","typeLabel":"null"},{"type":"array","items":{"type":"object","required":["type","code","message"],"properties":{"type":{"type":"string","description":"Error category (e.g. `source`, `auth`, `task`).","isRequired":true,"uniqueKey":"errors.oneOf.1.items.[INDEX].type","typeLabel":"string"},"code":{"type":"string","description":"Machine-readable error code.","isRequired":true,"uniqueKey":"errors.oneOf.1.items.[INDEX].code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable explanation. Do not rely on this for logic; it may change.","isRequired":true,"uniqueKey":"errors.oneOf.1.items.[INDEX].message","typeLabel":"string"},"field":{"oneOf":[{"type":"null","description":"The input field that caused the error, when applicable. Omitted otherwise.","uniqueKey":"errors.oneOf.1.items.[INDEX].field.oneOf.0","typeLabel":"null"},{"type":"string","description":"The input field that caused the error, when applicable. Omitted otherwise.","uniqueKey":"errors.oneOf.1.items.[INDEX].field.oneOf.1","typeLabel":"string"}],"uniqueKey":"errors.oneOf.1.items.[INDEX].field","typeLabel":"null | string"},"step":{"oneOf":[{"type":"null","description":"The step that caused the run to fail.","uniqueKey":"errors.oneOf.1.items.[INDEX].step.oneOf.0","typeLabel":"null"},{"type":"string","description":"The step that caused the run to fail.","uniqueKey":"errors.oneOf.1.items.[INDEX].step.oneOf.1","typeLabel":"string"}],"uniqueKey":"errors.oneOf.1.items.[INDEX].step","typeLabel":"null | string"}},"description":"A standard Deck error object plus the `step` that caused the failure. The same error, without `step`, appears on that step's `task_runs` entry.","uniqueKey":"errors.oneOf.1.items.[INDEX]","typeLabel":"object"},"description":"Error objects, each naming its `step`, when the run failed. `null` otherwise.","isRequired":true,"uniqueKey":"errors.oneOf.1","typeLabel":"object[]"}],"isRequired":true,"uniqueKey":"errors","typeLabel":"null | object[]"},"created_at":{"type":"string","format":"date-time","example":"2026-06-18T00:00:00Z","isRequired":true,"uniqueKey":"created_at","typeLabel":"string\u003cdate-time>"},"updated_at":{"type":"string","format":"date-time","example":"2026-06-18T00:00:00Z","isRequired":true,"uniqueKey":"updated_at","typeLabel":"string\u003cdate-time>"},"request_id":{"type":"string","description":"Unique identifier for the API request. Include this when contacting support.","uniqueKey":"request_id","typeLabel":"string"},"interactions_suppressed":{"type":"boolean","description":"`true` when the run was created with `interactions_suppressed`. Omitted otherwise.","uniqueKey":"interactions_suppressed","typeLabel":"boolean"}},"description":"Workflow run object.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"wrun_AbC123xYz456","object":"\u003cstring>","workflow_id":"wflo_AbC123xYz456","status":"queued","result":"\u003cstring>","runtime_ms":123,"session_id":"\u003cstring>","trigger_id":"\u003cstring>","steps":[{"name":"\u003cstring>","type":"task","status":"\u003cstring>","output":"\u003cunknown>","task_runs":[{"task_run_id":"trun_AbC123xYz456","status":"\u003cstring>","result":"\u003cstring>","created_at":"2026-06-18T00:00:00Z","runtime_ms":123,"errors":[{"type":"\u003cstring>","code":"\u003cstring>","message":"\u003cstring>","field":"\u003cstring>"}],"item":"\u003cunknown>","input":"\u003cunknown>","storage":[{"id":"stor_AbC123xYz456","object":"\u003cstring>","file_name":"\u003cstring>","file_type":"\u003cstring>","file_size":123,"purpose":"attachment","created_at":"2026-08-24T12:00:00Z","url":"\u003cstring>","extraction":"\u003cunknown>"}],"artifacts":{"screenshots":[{"file_name":"\u003cstring>","file_type":"\u003cstring>","file_size":123,"created_at":"2026-08-24T12:00:00Z","url":"\u003cstring>","reasoning":"\u003cstring>"}]}}]}],"errors":[{"type":"\u003cstring>","code":"\u003cstring>","message":"\u003cstring>","field":"\u003cstring>","step":"\u003cstring>"}],"created_at":"2026-06-18T00:00:00Z","updated_at":"2026-06-18T00:00:00Z","request_id":"\u003cstring>","interactions_suppressed":true}}},"exampleType":"generated"},"text/json":{"schema":{"type":"object","required":["id","object","workflow_id","status","result","runtime_ms","session_id","trigger_id","steps","errors","created_at","updated_at"],"properties":{"id":{"type":"string","pattern":"^wrun_","example":"wrun_AbC123xYz456","description":"Unique identifier for the workflow run, prefixed with `wrun_`.","isRequired":true,"uniqueKey":"id","typeLabel":"string"},"object":{"type":"string","description":"Always `workflow_run`.","isRequired":true,"uniqueKey":"object","typeLabel":"string"},"workflow_id":{"type":"string","pattern":"^wflo_","example":"wflo_AbC123xYz456","description":"The workflow that was run.","isRequired":true,"uniqueKey":"workflow_id","typeLabel":"string"},"status":{"type":"string","enum":["queued","running","paused","completed","failed","canceling","canceled"],"description":"Lifecycle state. `paused` means the current step is waiting on external input; the step's own status carries the reason.","isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"result":{"oneOf":[{"type":"null","description":"Outcome once terminal: `success` only when every task run succeeded, `failure` if any failed, `unknown` otherwise. `null` while running and for a canceled run.","isRequired":true,"uniqueKey":"result.oneOf.0","typeLabel":"null"},{"type":"string","description":"Outcome once terminal: `success` only when every task run succeeded, `failure` if any failed, `unknown` otherwise. `null` while running and for a canceled run.","isRequired":true,"uniqueKey":"result.oneOf.1","typeLabel":"string"}],"isRequired":true,"uniqueKey":"result","typeLabel":"null | string"},"runtime_ms":{"oneOf":[{"type":"null","format":"int64","description":"Milliseconds from the first step's start until the run reached a terminal status, excluding time spent queued. `null` until terminal.","isRequired":true,"uniqueKey":"runtime_ms.oneOf.0","typeLabel":"null"},{"type":"integer","format":"int64","description":"Milliseconds from the first step's start until the run reached a terminal status, excluding time spent queued. `null` until terminal.","isRequired":true,"uniqueKey":"runtime_ms.oneOf.1","typeLabel":"integer\u003cint64>"}],"isRequired":true,"uniqueKey":"runtime_ms","typeLabel":"null | integer\u003cint64>"},"session_id":{"oneOf":[{"type":"null","description":"The session every step of this run executes in. Prefixed with `sess_`. Assigned when the run is created through the API, or when a trigger-created run is admitted, so `null` while such a run is queued.","isRequired":true,"uniqueKey":"session_id.oneOf.0","typeLabel":"null"},{"type":"string","description":"The session every step of this run executes in. Prefixed with `sess_`. Assigned when the run is created through the API, or when a trigger-created run is admitted, so `null` while such a run is queued.","isRequired":true,"uniqueKey":"session_id.oneOf.1","typeLabel":"string"}],"isRequired":true,"uniqueKey":"session_id","typeLabel":"null | string"},"trigger_id":{"oneOf":[{"type":"null","description":"The trigger that created this run. Prefixed with `trg_`. `null` for runs created through the API.","isRequired":true,"uniqueKey":"trigger_id.oneOf.0","typeLabel":"null"},{"type":"string","description":"The trigger that created this run. Prefixed with `trg_`. `null` for runs created through the API.","isRequired":true,"uniqueKey":"trigger_id.oneOf.1","typeLabel":"string"}],"isRequired":true,"uniqueKey":"trigger_id","typeLabel":"null | string"},"steps":{"type":"array","items":{"type":"object","required":["name","type","status","output"],"properties":{"name":{"type":"string","description":"The step's name, matching the definition.","isRequired":true,"uniqueKey":"steps.items.[INDEX].name","typeLabel":"string"},"type":{"type":"string","enum":["task","for_each"],"description":"`task` or `for_each`.","isRequired":true,"uniqueKey":"steps.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"status":{"type":"string","description":"The underlying task run's status (`queued`, `running`, `interaction_required`, `review_required`, `completed`, `failed`, `canceling`, `canceled`), plus `skipped` when the step's `if` evaluated false. A `for_each` aggregates its items.","isRequired":true,"uniqueKey":"steps.items.[INDEX].status","typeLabel":"string"},"output":{"oneOf":[{"type":"null","description":"What references to this step resolve to: the task's output, or the ordered array of per-item outputs for a `for_each`. `null` until completion, and for a skipped step.","isRequired":true,"uniqueKey":"steps.items.[INDEX].output.oneOf.0","typeLabel":"null"},{"description":"What references to this step resolve to: the task's output, or the ordered array of per-item outputs for a `for_each`. `null` until completion, and for a skipped step.","isRequired":true,"uniqueKey":"steps.items.[INDEX].output.oneOf.1","typeLabel":"any"}],"isRequired":true,"uniqueKey":"steps.items.[INDEX].output","typeLabel":"null | any"},"task_runs":{"oneOf":[{"type":"null","items":{"type":"object","required":["task_run_id","status","result","created_at","runtime_ms","errors"],"properties":{"task_run_id":{"type":"string","pattern":"^trun_","example":"trun_AbC123xYz456","description":"The task run this entry summarizes. `GET /v2/task-runs/{run_id}` is the authoritative record."},"status":{"type":"string","description":"The task run's status."},"result":{"oneOf":[{"type":"null","description":"`success`, `failure`, or `unknown`. `null` until terminal."},{"type":"string","description":"`success`, `failure`, or `unknown`. `null` until terminal."}]},"created_at":{"type":"string","format":"date-time","example":"2026-06-18T00:00:00Z","description":"When the task run was created. Because steps run sequentially, this is when the step or item started."},"runtime_ms":{"oneOf":[{"type":"null","format":"int32","description":"Execution time in milliseconds. `null` until terminal, and for a run that failed before it started."},{"type":"integer","format":"int32","description":"Execution time in milliseconds. `null` until terminal, and for a run that failed before it started."}]},"errors":{"oneOf":[{"type":"null","items":{"required":["type","code","message"],"type":"object","properties":{"type":{"type":"string","description":"Error category (e.g. `source`, `auth`, `task`, `rate_limit`). Determines the class of failure."},"code":{"type":"string","description":"Machine-readable error code. Use this for programmatic handling."},"message":{"type":"string","description":"Human-readable explanation. Do not rely on this for logic — it may change."},"field":{"oneOf":[{"type":"null","description":"The input field that caused the error, when applicable."},{"type":"string","description":"The input field that caused the error, when applicable."}]}},"description":"Error details for a failed task run. Same structure as API-level errors."},"description":"Errors for this run when it failed. `null` otherwise."},{"type":"array","items":{"required":["type","code","message"],"type":"object","properties":{"type":{"type":"string","description":"Error category (e.g. `source`, `auth`, `task`, `rate_limit`). Determines the class of failure."},"code":{"type":"string","description":"Machine-readable error code. Use this for programmatic handling."},"message":{"type":"string","description":"Human-readable explanation. Do not rely on this for logic — it may change."},"field":{"oneOf":[{"type":"null","description":"The input field that caused the error, when applicable."},{"type":"string","description":"The input field that caused the error, when applicable."}]}},"description":"Error details for a failed task run. Same structure as API-level errors."},"description":"Errors for this run when it failed. `null` otherwise."}]},"item":{"oneOf":[{"type":"null","description":"`for_each` only. The input item this run processed."},{"description":"`for_each` only. The input item this run processed."}]},"input":{"oneOf":[{"type":"null","description":"The resolved input this run received, with references substituted. Returned only when `include=input` is requested."},{"description":"The resolved input this run received, with references substituted. Returned only when `include=input` is requested."}]},"storage":{"oneOf":[{"type":"null","items":{"required":["id","object","file_name","file_type","file_size","purpose","created_at"],"type":"object","properties":{"id":{"type":"string","description":"Unique identifier for the storage item, prefixed with `stor_`.","pattern":"^stor_","example":"stor_AbC123xYz456"},"object":{"type":"string","description":"Always `storage`."},"file_name":{"type":"string","description":"Original file name."},"file_type":{"type":"string","description":"MIME type of the file."},"file_size":{"oneOf":[{"pattern":"^-?(?:0|[1-9]\\d*)$","type":"integer","format":"int64","description":"Size of the file in bytes."},{"pattern":"^-?(?:0|[1-9]\\d*)$","type":"string","format":"int64","description":"Size of the file in bytes."}]},"url":{"oneOf":[{"type":"null","description":"Signed URL to download the file. Time-limited."},{"type":"string","description":"Signed URL to download the file. Time-limited."}]},"extraction":{"oneOf":[{"type":"null","description":"Extracted structured data from the file, if any."},{"description":"Extracted structured data from the file, if any."}]},"purpose":{"type":"string","enum":["attachment","extraction","output"],"description":"How the file relates to the run: `attachment` (a file you provided as task input for the agent to use), `extraction` (a file you provided as task input that Deck extracts data from directly, skipping the agent), or `output` (a file the agent captured during the run)."},"created_at":{"type":"string","format":"date-time","description":"When the storage item was created.","example":"2026-08-24T12:00:00Z"}},"description":"A storage item embedded in the task run detail response when include=storage is requested. Includes the signed download URL and any inline extraction."},"description":"Files captured during this run, each with inline extraction (if any). Returned only when `include=storage` is requested."},{"type":"array","items":{"required":["id","object","file_name","file_type","file_size","purpose","created_at"],"type":"object","properties":{"id":{"type":"string","description":"Unique identifier for the storage item, prefixed with `stor_`.","pattern":"^stor_","example":"stor_AbC123xYz456"},"object":{"type":"string","description":"Always `storage`."},"file_name":{"type":"string","description":"Original file name."},"file_type":{"type":"string","description":"MIME type of the file."},"file_size":{"oneOf":[{"pattern":"^-?(?:0|[1-9]\\d*)$","type":"integer","format":"int64","description":"Size of the file in bytes."},{"pattern":"^-?(?:0|[1-9]\\d*)$","type":"string","format":"int64","description":"Size of the file in bytes."}]},"url":{"oneOf":[{"type":"null","description":"Signed URL to download the file. Time-limited."},{"type":"string","description":"Signed URL to download the file. Time-limited."}]},"extraction":{"oneOf":[{"type":"null","description":"Extracted structured data from the file, if any."},{"description":"Extracted structured data from the file, if any."}]},"purpose":{"type":"string","enum":["attachment","extraction","output"],"description":"How the file relates to the run: `attachment` (a file you provided as task input for the agent to use), `extraction` (a file you provided as task input that Deck extracts data from directly, skipping the agent), or `output` (a file the agent captured during the run)."},"created_at":{"type":"string","format":"date-time","description":"When the storage item was created.","example":"2026-08-24T12:00:00Z"}},"description":"A storage item embedded in the task run detail response when include=storage is requested. Includes the signed download URL and any inline extraction."},"description":"Files captured during this run, each with inline extraction (if any). Returned only when `include=storage` is requested."}]},"artifacts":{"oneOf":[{"type":"null","description":"Screenshots for this run. Returned only when `include=artifacts` is requested."},{"type":"object","description":"Screenshots for this run. Returned only when `include=artifacts` is requested.","required":["screenshots"],"properties":{"screenshots":{"type":"array","items":{"required":["file_name","file_type","file_size","created_at"],"type":"object","properties":{"file_name":{"type":"string","description":"Original file name."},"file_type":{"type":"string","description":"MIME type of the screenshot."},"file_size":{"oneOf":[{"pattern":"^-?(?:0|[1-9]\\d*)$","type":"integer","format":"int64","description":"Size of the file in bytes."},{"pattern":"^-?(?:0|[1-9]\\d*)$","type":"string","format":"int64","description":"Size of the file in bytes."}]},"url":{"oneOf":[{"type":"null","description":"Signed URL to download the screenshot. Time-limited."},{"type":"string","description":"Signed URL to download the screenshot. Time-limited."}]},"reasoning":{"oneOf":[{"type":"null","description":"AI reasoning at the time of capture, if recorded."},{"type":"string","description":"AI reasoning at the time of capture, if recorded."}]},"created_at":{"type":"string","format":"date-time","description":"When the screenshot was captured.","example":"2026-08-24T12:00:00Z"}},"description":"A single screenshot captured during a task run."},"description":"Screenshots captured during the run."}}}]}},"description":"A compact summary of one task run a step produced."},"description":"The task runs this step produced, in order: one for a `task` step, one per item processed for a `for_each`, none for a skipped step. Returned on single-run responses; omitted from list responses.","uniqueKey":"steps.items.[INDEX].task_runs.oneOf.0","typeLabel":"null"},{"type":"array","items":{"type":"object","required":["task_run_id","status","result","created_at","runtime_ms","errors"],"properties":{"task_run_id":{"type":"string","pattern":"^trun_","example":"trun_AbC123xYz456","description":"The task run this entry summarizes. `GET /v2/task-runs/{run_id}` is the authoritative record.","isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].task_run_id","typeLabel":"string"},"status":{"type":"string","description":"The task run's status.","isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].status","typeLabel":"string"},"result":{"oneOf":[{"type":"null","description":"`success`, `failure`, or `unknown`. `null` until terminal.","isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].result.oneOf.0","typeLabel":"null"},{"type":"string","description":"`success`, `failure`, or `unknown`. `null` until terminal.","isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].result.oneOf.1","typeLabel":"string"}],"isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].result","typeLabel":"null | string"},"created_at":{"type":"string","format":"date-time","example":"2026-06-18T00:00:00Z","description":"When the task run was created. Because steps run sequentially, this is when the step or item started.","isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].created_at","typeLabel":"string\u003cdate-time>"},"runtime_ms":{"oneOf":[{"type":"null","format":"int32","description":"Execution time in milliseconds. `null` until terminal, and for a run that failed before it started.","isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].runtime_ms.oneOf.0","typeLabel":"null"},{"type":"integer","format":"int32","description":"Execution time in milliseconds. `null` until terminal, and for a run that failed before it started.","isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].runtime_ms.oneOf.1","typeLabel":"integer\u003cint32>"}],"isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].runtime_ms","typeLabel":"null | integer\u003cint32>"},"errors":{"oneOf":[{"type":"null","items":{"required":["type","code","message"],"type":"object","properties":{"type":{"type":"string","description":"Error category (e.g. `source`, `auth`, `task`, `rate_limit`). Determines the class of failure."},"code":{"type":"string","description":"Machine-readable error code. Use this for programmatic handling."},"message":{"type":"string","description":"Human-readable explanation. Do not rely on this for logic — it may change."},"field":{"oneOf":[{"type":"null","description":"The input field that caused the error, when applicable."},{"type":"string","description":"The input field that caused the error, when applicable."}]}},"description":"Error details for a failed task run. Same structure as API-level errors."},"description":"Errors for this run when it failed. `null` otherwise.","isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].errors.oneOf.0","typeLabel":"null"},{"type":"array","items":{"required":["type","code","message"],"type":"object","properties":{"type":{"type":"string","description":"Error category (e.g. `source`, `auth`, `task`, `rate_limit`). Determines the class of failure.","isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].errors.oneOf.1.items.[INDEX].type","typeLabel":"string"},"code":{"type":"string","description":"Machine-readable error code. Use this for programmatic handling.","isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].errors.oneOf.1.items.[INDEX].code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable explanation. Do not rely on this for logic — it may change.","isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].errors.oneOf.1.items.[INDEX].message","typeLabel":"string"},"field":{"oneOf":[{"type":"null","description":"The input field that caused the error, when applicable.","uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].errors.oneOf.1.items.[INDEX].field.oneOf.0","typeLabel":"null"},{"type":"string","description":"The input field that caused the error, when applicable.","uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].errors.oneOf.1.items.[INDEX].field.oneOf.1","typeLabel":"string"}],"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].errors.oneOf.1.items.[INDEX].field","typeLabel":"null | string"}},"description":"Error details for a failed task run. Same structure as API-level errors.","uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].errors.oneOf.1.items.[INDEX]","typeLabel":"object"},"description":"Errors for this run when it failed. `null` otherwise.","isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].errors.oneOf.1","typeLabel":"object[]"}],"isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].errors","typeLabel":"null | object[]"},"item":{"oneOf":[{"type":"null","description":"`for_each` only. The input item this run processed.","uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].item.oneOf.0","typeLabel":"null"},{"description":"`for_each` only. The input item this run processed.","uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].item.oneOf.1","typeLabel":"any"}],"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].item","typeLabel":"null | any"},"input":{"oneOf":[{"type":"null","description":"The resolved input this run received, with references substituted. Returned only when `include=input` is requested.","uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].input.oneOf.0","typeLabel":"null"},{"description":"The resolved input this run received, with references substituted. Returned only when `include=input` is requested.","uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].input.oneOf.1","typeLabel":"any"}],"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].input","typeLabel":"null | any"},"storage":{"oneOf":[{"type":"null","items":{"required":["id","object","file_name","file_type","file_size","purpose","created_at"],"type":"object","properties":{"id":{"type":"string","description":"Unique identifier for the storage item, prefixed with `stor_`.","pattern":"^stor_","example":"stor_AbC123xYz456"},"object":{"type":"string","description":"Always `storage`."},"file_name":{"type":"string","description":"Original file name."},"file_type":{"type":"string","description":"MIME type of the file."},"file_size":{"oneOf":[{"pattern":"^-?(?:0|[1-9]\\d*)$","type":"integer","format":"int64","description":"Size of the file in bytes."},{"pattern":"^-?(?:0|[1-9]\\d*)$","type":"string","format":"int64","description":"Size of the file in bytes."}]},"url":{"oneOf":[{"type":"null","description":"Signed URL to download the file. Time-limited."},{"type":"string","description":"Signed URL to download the file. Time-limited."}]},"extraction":{"oneOf":[{"type":"null","description":"Extracted structured data from the file, if any."},{"description":"Extracted structured data from the file, if any."}]},"purpose":{"type":"string","enum":["attachment","extraction","output"],"description":"How the file relates to the run: `attachment` (a file you provided as task input for the agent to use), `extraction` (a file you provided as task input that Deck extracts data from directly, skipping the agent), or `output` (a file the agent captured during the run)."},"created_at":{"type":"string","format":"date-time","description":"When the storage item was created.","example":"2026-08-24T12:00:00Z"}},"description":"A storage item embedded in the task run detail response when include=storage is requested. Includes the signed download URL and any inline extraction."},"description":"Files captured during this run, each with inline extraction (if any). Returned only when `include=storage` is requested.","uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].storage.oneOf.0","typeLabel":"null"},{"type":"array","items":{"required":["id","object","file_name","file_type","file_size","purpose","created_at"],"type":"object","properties":{"id":{"type":"string","description":"Unique identifier for the storage item, prefixed with `stor_`.","pattern":"^stor_","example":"stor_AbC123xYz456","isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].storage.oneOf.1.items.[INDEX].id","typeLabel":"string"},"object":{"type":"string","description":"Always `storage`.","isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].storage.oneOf.1.items.[INDEX].object","typeLabel":"string"},"file_name":{"type":"string","description":"Original file name.","isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].storage.oneOf.1.items.[INDEX].file_name","typeLabel":"string"},"file_type":{"type":"string","description":"MIME type of the file.","isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].storage.oneOf.1.items.[INDEX].file_type","typeLabel":"string"},"file_size":{"oneOf":[{"pattern":"^-?(?:0|[1-9]\\d*)$","type":"integer","format":"int64","description":"Size of the file in bytes.","isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].storage.oneOf.1.items.[INDEX].file_size.oneOf.0","typeLabel":"integer\u003cint64>"},{"pattern":"^-?(?:0|[1-9]\\d*)$","type":"string","format":"int64","description":"Size of the file in bytes.","isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].storage.oneOf.1.items.[INDEX].file_size.oneOf.1","typeLabel":"string\u003cint64>"}],"isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].storage.oneOf.1.items.[INDEX].file_size","typeLabel":"integer\u003cint64> | string\u003cint64>"},"purpose":{"type":"string","enum":["attachment","extraction","output"],"description":"How the file relates to the run: `attachment` (a file you provided as task input for the agent to use), `extraction` (a file you provided as task input that Deck extracts data from directly, skipping the agent), or `output` (a file the agent captured during the run).","isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].storage.oneOf.1.items.[INDEX].purpose","typeLabel":"enum\u003cstring>"},"created_at":{"type":"string","format":"date-time","description":"When the storage item was created.","example":"2026-08-24T12:00:00Z","isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].storage.oneOf.1.items.[INDEX].created_at","typeLabel":"string\u003cdate-time>"},"url":{"oneOf":[{"type":"null","description":"Signed URL to download the file. Time-limited.","uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].storage.oneOf.1.items.[INDEX].url.oneOf.0","typeLabel":"null"},{"type":"string","description":"Signed URL to download the file. Time-limited.","uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].storage.oneOf.1.items.[INDEX].url.oneOf.1","typeLabel":"string"}],"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].storage.oneOf.1.items.[INDEX].url","typeLabel":"null | string"},"extraction":{"oneOf":[{"type":"null","description":"Extracted structured data from the file, if any.","uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].storage.oneOf.1.items.[INDEX].extraction.oneOf.0","typeLabel":"null"},{"description":"Extracted structured data from the file, if any.","uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].storage.oneOf.1.items.[INDEX].extraction.oneOf.1","typeLabel":"any"}],"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].storage.oneOf.1.items.[INDEX].extraction","typeLabel":"null | any"}},"description":"A storage item embedded in the task run detail response when include=storage is requested. Includes the signed download URL and any inline extraction.","uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].storage.oneOf.1.items.[INDEX]","typeLabel":"object"},"description":"Files captured during this run, each with inline extraction (if any). Returned only when `include=storage` is requested.","uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].storage.oneOf.1","typeLabel":"object[]"}],"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].storage","typeLabel":"null | object[]"},"artifacts":{"oneOf":[{"type":"null","description":"Screenshots for this run. Returned only when `include=artifacts` is requested.","uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].artifacts.oneOf.0","typeLabel":"null"},{"type":"object","description":"Screenshots for this run. Returned only when `include=artifacts` is requested.","required":["screenshots"],"properties":{"screenshots":{"type":"array","items":{"required":["file_name","file_type","file_size","created_at"],"type":"object","properties":{"file_name":{"type":"string","description":"Original file name.","isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].artifacts.oneOf.1.screenshots.items.[INDEX].file_name","typeLabel":"string"},"file_type":{"type":"string","description":"MIME type of the screenshot.","isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].artifacts.oneOf.1.screenshots.items.[INDEX].file_type","typeLabel":"string"},"file_size":{"oneOf":[{"pattern":"^-?(?:0|[1-9]\\d*)$","type":"integer","format":"int64","description":"Size of the file in bytes.","isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].artifacts.oneOf.1.screenshots.items.[INDEX].file_size.oneOf.0","typeLabel":"integer\u003cint64>"},{"pattern":"^-?(?:0|[1-9]\\d*)$","type":"string","format":"int64","description":"Size of the file in bytes.","isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].artifacts.oneOf.1.screenshots.items.[INDEX].file_size.oneOf.1","typeLabel":"string\u003cint64>"}],"isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].artifacts.oneOf.1.screenshots.items.[INDEX].file_size","typeLabel":"integer\u003cint64> | string\u003cint64>"},"created_at":{"type":"string","format":"date-time","description":"When the screenshot was captured.","example":"2026-08-24T12:00:00Z","isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].artifacts.oneOf.1.screenshots.items.[INDEX].created_at","typeLabel":"string\u003cdate-time>"},"url":{"oneOf":[{"type":"null","description":"Signed URL to download the screenshot. Time-limited.","uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].artifacts.oneOf.1.screenshots.items.[INDEX].url.oneOf.0","typeLabel":"null"},{"type":"string","description":"Signed URL to download the screenshot. Time-limited.","uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].artifacts.oneOf.1.screenshots.items.[INDEX].url.oneOf.1","typeLabel":"string"}],"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].artifacts.oneOf.1.screenshots.items.[INDEX].url","typeLabel":"null | string"},"reasoning":{"oneOf":[{"type":"null","description":"AI reasoning at the time of capture, if recorded.","uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].artifacts.oneOf.1.screenshots.items.[INDEX].reasoning.oneOf.0","typeLabel":"null"},{"type":"string","description":"AI reasoning at the time of capture, if recorded.","uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].artifacts.oneOf.1.screenshots.items.[INDEX].reasoning.oneOf.1","typeLabel":"string"}],"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].artifacts.oneOf.1.screenshots.items.[INDEX].reasoning","typeLabel":"null | string"}},"description":"A single screenshot captured during a task run.","uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].artifacts.oneOf.1.screenshots.items.[INDEX]","typeLabel":"object"},"description":"Screenshots captured during the run.","isRequired":true,"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].artifacts.oneOf.1.screenshots","typeLabel":"object[]"}},"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].artifacts.oneOf.1","typeLabel":"object"}],"uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX].artifacts","typeLabel":"null | object"}},"description":"A compact summary of one task run a step produced.","uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1.items.[INDEX]","typeLabel":"object"},"description":"The task runs this step produced, in order: one for a `task` step, one per item processed for a `for_each`, none for a skipped step. Returned on single-run responses; omitted from list responses.","uniqueKey":"steps.items.[INDEX].task_runs.oneOf.1","typeLabel":"object[]"}],"uniqueKey":"steps.items.[INDEX].task_runs","typeLabel":"null | object[]"}},"description":"One step's state within a workflow run.","uniqueKey":"steps.items.[INDEX]","typeLabel":"object"},"description":"Per-step state, in definition order.","isRequired":true,"uniqueKey":"steps","typeLabel":"object[]"},"errors":{"oneOf":[{"type":"null","items":{"type":"object","required":["type","code","message"],"properties":{"type":{"type":"string","description":"Error category (e.g. `source`, `auth`, `task`)."},"code":{"type":"string","description":"Machine-readable error code."},"message":{"type":"string","description":"Human-readable explanation. Do not rely on this for logic; it may change."},"field":{"oneOf":[{"type":"null","description":"The input field that caused the error, when applicable. Omitted otherwise."},{"type":"string","description":"The input field that caused the error, when applicable. Omitted otherwise."}]},"step":{"oneOf":[{"type":"null","description":"The step that caused the run to fail."},{"type":"string","description":"The step that caused the run to fail."}]}},"description":"A standard Deck error object plus the `step` that caused the failure. The same error, without `step`, appears on that step's `task_runs` entry."},"description":"Error objects, each naming its `step`, when the run failed. `null` otherwise.","isRequired":true,"uniqueKey":"errors.oneOf.0","typeLabel":"null"},{"type":"array","items":{"type":"object","required":["type","code","message"],"properties":{"type":{"type":"string","description":"Error category (e.g. `source`, `auth`, `task`).","isRequired":true,"uniqueKey":"errors.oneOf.1.items.[INDEX].type","typeLabel":"string"},"code":{"type":"string","description":"Machine-readable error code.","isRequired":true,"uniqueKey":"errors.oneOf.1.items.[INDEX].code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable explanation. Do not rely on this for logic; it may change.","isRequired":true,"uniqueKey":"errors.oneOf.1.items.[INDEX].message","typeLabel":"string"},"field":{"oneOf":[{"type":"null","description":"The input field that caused the error, when applicable. Omitted otherwise.","uniqueKey":"errors.oneOf.1.items.[INDEX].field.oneOf.0","typeLabel":"null"},{"type":"string","description":"The input field that caused the error, when applicable. Omitted otherwise.","uniqueKey":"errors.oneOf.1.items.[INDEX].field.oneOf.1","typeLabel":"string"}],"uniqueKey":"errors.oneOf.1.items.[INDEX].field","typeLabel":"null | string"},"step":{"oneOf":[{"type":"null","description":"The step that caused the run to fail.","uniqueKey":"errors.oneOf.1.items.[INDEX].step.oneOf.0","typeLabel":"null"},{"type":"string","description":"The step that caused the run to fail.","uniqueKey":"errors.oneOf.1.items.[INDEX].step.oneOf.1","typeLabel":"string"}],"uniqueKey":"errors.oneOf.1.items.[INDEX].step","typeLabel":"null | string"}},"description":"A standard Deck error object plus the `step` that caused the failure. The same error, without `step`, appears on that step's `task_runs` entry.","uniqueKey":"errors.oneOf.1.items.[INDEX]","typeLabel":"object"},"description":"Error objects, each naming its `step`, when the run failed. `null` otherwise.","isRequired":true,"uniqueKey":"errors.oneOf.1","typeLabel":"object[]"}],"isRequired":true,"uniqueKey":"errors","typeLabel":"null | object[]"},"created_at":{"type":"string","format":"date-time","example":"2026-06-18T00:00:00Z","isRequired":true,"uniqueKey":"created_at","typeLabel":"string\u003cdate-time>"},"updated_at":{"type":"string","format":"date-time","example":"2026-06-18T00:00:00Z","isRequired":true,"uniqueKey":"updated_at","typeLabel":"string\u003cdate-time>"},"request_id":{"type":"string","description":"Unique identifier for the API request. Include this when contacting support.","uniqueKey":"request_id","typeLabel":"string"},"interactions_suppressed":{"type":"boolean","description":"`true` when the run was created with `interactions_suppressed`. Omitted otherwise.","uniqueKey":"interactions_suppressed","typeLabel":"boolean"}},"description":"Workflow run object.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"wrun_AbC123xYz456","object":"\u003cstring>","workflow_id":"wflo_AbC123xYz456","status":"queued","result":"\u003cstring>","runtime_ms":123,"session_id":"\u003cstring>","trigger_id":"\u003cstring>","steps":[{"name":"\u003cstring>","type":"task","status":"\u003cstring>","output":"\u003cunknown>","task_runs":[{"task_run_id":"trun_AbC123xYz456","status":"\u003cstring>","result":"\u003cstring>","created_at":"2026-06-18T00:00:00Z","runtime_ms":123,"errors":[{"type":"\u003cstring>","code":"\u003cstring>","message":"\u003cstring>","field":"\u003cstring>"}],"item":"\u003cunknown>","input":"\u003cunknown>","storage":[{"id":"stor_AbC123xYz456","object":"\u003cstring>","file_name":"\u003cstring>","file_type":"\u003cstring>","file_size":123,"purpose":"attachment","created_at":"2026-08-24T12:00:00Z","url":"\u003cstring>","extraction":"\u003cunknown>"}],"artifacts":{"screenshots":[{"file_name":"\u003cstring>","file_type":"\u003cstring>","file_size":123,"created_at":"2026-08-24T12:00:00Z","url":"\u003cstring>","reasoning":"\u003cstring>"}]}}]}],"errors":[{"type":"\u003cstring>","code":"\u003cstring>","message":"\u003cstring>","field":"\u003cstring>","step":"\u003cstring>"}],"created_at":"2026-06-18T00:00:00Z","updated_at":"2026-06-18T00:00:00Z","request_id":"\u003cstring>","interactions_suppressed":true}}},"exampleType":"generated"}},"exampleType":"generated"},"6a930a64-0155-4493-a20d-bd72470453e0":{"description":"Bad request — validation error or malformed input.","content":{"application/json":{"schema":{"required":["errors"],"type":"object","properties":{"errors":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string","uniqueKey":"errors.additionalProperties.items.[INDEX]","typeLabel":"string"},"uniqueKey":"errors.additionalProperties","typeLabel":"string[]"},"description":"Validation errors grouped by field name.","isRequired":true,"uniqueKey":"errors","typeLabel":"object"},"type":{"oneOf":[{"type":"null","description":"RFC 9110 problem type URI.","uniqueKey":"type.oneOf.0","typeLabel":"null"},{"type":"string","description":"RFC 9110 problem type URI.","uniqueKey":"type.oneOf.1","typeLabel":"string"}],"uniqueKey":"type","typeLabel":"null | string"},"title":{"oneOf":[{"type":"null","description":"Short summary of the validation failure.","uniqueKey":"title.oneOf.0","typeLabel":"null"},{"type":"string","description":"Short summary of the validation failure.","uniqueKey":"title.oneOf.1","typeLabel":"string"}],"uniqueKey":"title","typeLabel":"null | string"},"status":{"oneOf":[{"type":"null","description":"HTTP status code.","format":"int32","uniqueKey":"status.oneOf.0","typeLabel":"null"},{"type":"integer","description":"HTTP status code.","format":"int32","uniqueKey":"status.oneOf.1","typeLabel":"integer\u003cint32>"}],"uniqueKey":"status","typeLabel":"null | integer\u003cint32>"},"traceId":{"oneOf":[{"type":"null","description":"Request trace identifier.","uniqueKey":"traceId.oneOf.0","typeLabel":"null"},{"type":"string","description":"Request trace identifier.","uniqueKey":"traceId.oneOf.1","typeLabel":"string"}],"uniqueKey":"traceId","typeLabel":"null | string"}},"description":"Validation error returned for malformed requests (HTTP 400).","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"errors":{},"type":"\u003cstring>","title":"\u003cstring>","status":123,"traceId":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"9c782e8d-2a29-47f1-af9b-dc7e6bf167df":{"description":"Unauthorized.","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"3b0c4b96-f178-4dab-9e18-6048352acd4f":{"description":"Forbidden.","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"d7565ce9-486a-41cb-bb50-5d2425df5735":{"description":"Not found — the requested resource does not exist.","content":{"application/json":{"schema":{"required":["errors","request_id"],"type":"object","properties":{"errors":{"type":"array","items":{"required":["type","code","message"],"type":"object","properties":{"type":{"type":"string","description":"Error category (e.g. `source`, `auth`, `task`, `rate_limit`). Determines the class of failure.","isRequired":true,"uniqueKey":"errors.items.[INDEX].type","typeLabel":"string"},"code":{"type":"string","description":"Machine-readable error code. Use this for programmatic handling.","isRequired":true,"uniqueKey":"errors.items.[INDEX].code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable explanation. Do not rely on this for logic — it may change.","isRequired":true,"uniqueKey":"errors.items.[INDEX].message","typeLabel":"string"},"field":{"oneOf":[{"type":"null","description":"The input field that caused the error, when applicable.","uniqueKey":"errors.items.[INDEX].field.oneOf.0","typeLabel":"null"},{"type":"string","description":"The input field that caused the error, when applicable.","uniqueKey":"errors.items.[INDEX].field.oneOf.1","typeLabel":"string"}],"uniqueKey":"errors.items.[INDEX].field","typeLabel":"null | string"}},"description":"Error details for a failed task run. Same structure as API-level errors.","uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"description":"One or more errors that describe what went wrong.","isRequired":true,"uniqueKey":"errors","typeLabel":"object[]"},"request_id":{"type":"string","description":"Unique identifier for this request, useful for tracing.","isRequired":true,"uniqueKey":"request_id","typeLabel":"string"}},"description":"Standard error response.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"errors":[{"type":"\u003cstring>","code":"\u003cstring>","message":"\u003cstring>","field":"\u003cstring>"}],"request_id":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"57630174-c071-47cf-a927-494545ccfa0b":{"description":"Conflict — the request is valid but cannot be completed in the current state. Also returned when an `Idempotency-Key` is reused with different request parameters (`idempotency_error`).","content":{"application/json":{"schema":{"required":["errors","request_id"],"type":"object","properties":{"errors":{"type":"array","items":{"required":["type","code","message"],"type":"object","properties":{"type":{"type":"string","description":"Error category (e.g. `source`, `auth`, `task`, `rate_limit`). Determines the class of failure.","isRequired":true,"uniqueKey":"errors.items.[INDEX].type","typeLabel":"string"},"code":{"type":"string","description":"Machine-readable error code. Use this for programmatic handling.","isRequired":true,"uniqueKey":"errors.items.[INDEX].code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable explanation. Do not rely on this for logic — it may change.","isRequired":true,"uniqueKey":"errors.items.[INDEX].message","typeLabel":"string"},"field":{"oneOf":[{"type":"null","description":"The input field that caused the error, when applicable.","uniqueKey":"errors.items.[INDEX].field.oneOf.0","typeLabel":"null"},{"type":"string","description":"The input field that caused the error, when applicable.","uniqueKey":"errors.items.[INDEX].field.oneOf.1","typeLabel":"string"}],"uniqueKey":"errors.items.[INDEX].field","typeLabel":"null | string"}},"description":"Error details for a failed task run. Same structure as API-level errors.","uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"description":"One or more errors that describe what went wrong.","isRequired":true,"uniqueKey":"errors","typeLabel":"object[]"},"request_id":{"type":"string","description":"Unique identifier for this request, useful for tracing.","isRequired":true,"uniqueKey":"request_id","typeLabel":"string"}},"description":"Standard error response.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"errors":[{"type":"\u003cstring>","code":"\u003cstring>","message":"\u003cstring>","field":"\u003cstring>"}],"request_id":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"6800cfa1-144a-4c30-99a6-2526cdb931e2":{"description":"Unprocessable content — the request body is understood but contains invalid values.","content":{"application/json":{"schema":{"required":["errors","request_id"],"type":"object","properties":{"errors":{"type":"array","items":{"required":["type","code","message"],"type":"object","properties":{"type":{"type":"string","description":"Error category (e.g. `source`, `auth`, `task`, `rate_limit`). Determines the class of failure.","isRequired":true,"uniqueKey":"errors.items.[INDEX].type","typeLabel":"string"},"code":{"type":"string","description":"Machine-readable error code. Use this for programmatic handling.","isRequired":true,"uniqueKey":"errors.items.[INDEX].code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable explanation. Do not rely on this for logic — it may change.","isRequired":true,"uniqueKey":"errors.items.[INDEX].message","typeLabel":"string"},"field":{"oneOf":[{"type":"null","description":"The input field that caused the error, when applicable.","uniqueKey":"errors.items.[INDEX].field.oneOf.0","typeLabel":"null"},{"type":"string","description":"The input field that caused the error, when applicable.","uniqueKey":"errors.items.[INDEX].field.oneOf.1","typeLabel":"string"}],"uniqueKey":"errors.items.[INDEX].field","typeLabel":"null | string"}},"description":"Error details for a failed task run. Same structure as API-level errors.","uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"description":"One or more errors that describe what went wrong.","isRequired":true,"uniqueKey":"errors","typeLabel":"object[]"},"request_id":{"type":"string","description":"Unique identifier for this request, useful for tracing.","isRequired":true,"uniqueKey":"request_id","typeLabel":"string"}},"description":"Standard error response.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"errors":[{"type":"\u003cstring>","code":"\u003cstring>","message":"\u003cstring>","field":"\u003cstring>"}],"request_id":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"cf95bc18-4790-4799-b151-35980e27c26a":{"description":"Too many requests. The organization-wide API rate limit was exceeded (`rate_limit_exceeded`), or the organization is at its session limit (`session_limit_exceeded`). Each workflow run holds one session until it finishes. Retry with exponential backoff.","content":{"application/json":{"schema":{"required":["errors","request_id"],"type":"object","properties":{"errors":{"type":"array","items":{"required":["type","code","message"],"type":"object","properties":{"type":{"type":"string","description":"Error category (e.g. `source`, `auth`, `task`, `rate_limit`). Determines the class of failure.","isRequired":true,"uniqueKey":"errors.items.[INDEX].type","typeLabel":"string"},"code":{"type":"string","description":"Machine-readable error code. Use this for programmatic handling.","isRequired":true,"uniqueKey":"errors.items.[INDEX].code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable explanation. Do not rely on this for logic — it may change.","isRequired":true,"uniqueKey":"errors.items.[INDEX].message","typeLabel":"string"},"field":{"oneOf":[{"type":"null","description":"The input field that caused the error, when applicable.","uniqueKey":"errors.items.[INDEX].field.oneOf.0","typeLabel":"null"},{"type":"string","description":"The input field that caused the error, when applicable.","uniqueKey":"errors.items.[INDEX].field.oneOf.1","typeLabel":"string"}],"uniqueKey":"errors.items.[INDEX].field","typeLabel":"null | string"}},"description":"Error details for a failed task run. Same structure as API-level errors.","uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"description":"One or more errors that describe what went wrong.","isRequired":true,"uniqueKey":"errors","typeLabel":"object[]"},"request_id":{"type":"string","description":"Unique identifier for this request, useful for tracing.","isRequired":true,"uniqueKey":"request_id","typeLabel":"string"}},"description":"Standard error response.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"errors":[{"type":"\u003cstring>","code":"\u003cstring>","message":"\u003cstring>","field":"\u003cstring>"}],"request_id":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"96b43baa-d8bf-469e-99a6-f58a8486e9e2":{"description":"Internal server error.","content":{"application/json":{"schema":{"required":["errors","request_id"],"type":"object","properties":{"errors":{"type":"array","items":{"required":["type","code","message"],"type":"object","properties":{"type":{"type":"string","description":"Error category (e.g. `source`, `auth`, `task`, `rate_limit`). Determines the class of failure.","isRequired":true,"uniqueKey":"errors.items.[INDEX].type","typeLabel":"string"},"code":{"type":"string","description":"Machine-readable error code. Use this for programmatic handling.","isRequired":true,"uniqueKey":"errors.items.[INDEX].code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable explanation. Do not rely on this for logic — it may change.","isRequired":true,"uniqueKey":"errors.items.[INDEX].message","typeLabel":"string"},"field":{"oneOf":[{"type":"null","description":"The input field that caused the error, when applicable.","uniqueKey":"errors.items.[INDEX].field.oneOf.0","typeLabel":"null"},{"type":"string","description":"The input field that caused the error, when applicable.","uniqueKey":"errors.items.[INDEX].field.oneOf.1","typeLabel":"string"}],"uniqueKey":"errors.items.[INDEX].field","typeLabel":"null | string"}},"description":"Error details for a failed task run. Same structure as API-level errors.","uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"description":"One or more errors that describe what went wrong.","isRequired":true,"uniqueKey":"errors","typeLabel":"object[]"},"request_id":{"type":"string","description":"Unique identifier for this request, useful for tracing.","isRequired":true,"uniqueKey":"request_id","typeLabel":"string"}},"description":"Standard error response.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"errors":[{"type":"\u003cstring>","code":"\u003cstring>","message":"\u003cstring>","field":"\u003cstring>"}],"request_id":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"dc8ae21e-0d3e-40ae-bf25-638c0c900a99":{"BearerAuth":{"type":"http","description":"Secret key (sk_live_...)","scheme":"bearer","bearerFormat":"JWT","scopes":[],"schemeName":"BearerAuth"}}},"servers":{"e7891587-14e5-4adb-832b-247637593716":{"url":"https://api.deck.co/v2","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","description":"Secret key (sk_live_...)","scheme":"bearer","bearerFormat":"JWT","scopes":[],"schemeName":"BearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Secret key (sk_live_...)","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"BearerAuth","name":"Authorization"}],"title":"BearerAuth"}]},"originalFileLocation":"api-reference/v2.json"},"subdomain":"decksoftwareinc","siteName":"Deck Docs","title":"Run a workflow - Deck Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-23T21:36:30.824Z","originalFileLocation":"api-reference/workflows/run-a-workflow.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=\"dark\";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=\"dark\"}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=\"Runs a workflow. Returns immediately with the run queued.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Deck Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/decksoftwareinc/DmQKfMV4zw6ETaNX/_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/decksoftwareinc/DmQKfMV4zw6ETaNX/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/decksoftwareinc/DmQKfMV4zw6ETaNX/_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/decksoftwareinc/DmQKfMV4zw6ETaNX/_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/decksoftwareinc/DmQKfMV4zw6ETaNX/_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/decksoftwareinc/DmQKfMV4zw6ETaNX/_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/decksoftwareinc/DmQKfMV4zw6ETaNX/_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/decksoftwareinc/DmQKfMV4zw6ETaNX/_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/decksoftwareinc/DmQKfMV4zw6ETaNX/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Run a workflow - Deck Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Runs a workflow. Returns immediately with the run queued.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Deck Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.deck.co/api-reference/workflows/run-a-workflow\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://decksoftwareinc.mintlify.app/_mintlify/api/og/v2?division=Workflows\u0026amp;title=Run+a+workflow\u0026amp;description=Runs+a+workflow.+Returns+immediately+with+the+run+%60queued%60.\u0026amp;theme=34e13586d13a0a394dea5bd4\u0026amp;signature=a807b6d64d4bb7121126fc0b38e1e48d14524119d33efff44839a4b81f236f89\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Run a workflow - Deck Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Runs a workflow. Returns immediately with the run queued.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://decksoftwareinc.mintlify.app/_mintlify/api/og/v2?division=Workflows\u0026amp;title=Run+a+workflow\u0026amp;description=Runs+a+workflow.+Returns+immediately+with+the+run+%60queued%60.\u0026amp;theme=34e13586d13a0a394dea5bd4\u0026amp;signature=a807b6d64d4bb7121126fc0b38e1e48d14524119d33efff44839a4b81f236f89\">\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/decksoftwareinc/DmQKfMV4zw6ETaNX/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Deck Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#60917e\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.deck.co/api-reference/workflows/run-a-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/run-a-workflow.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.deck.co/#organization\",\"name\":\"Deck Docs\",\"url\":\"https://docs.deck.co\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/decksoftwareinc/qU-Ph3TxWRaVaZ4z/logo/light.svg?fit=max\u0026auto=format\u0026n=qU-Ph3TxWRaVaZ4z\u0026q=85\u0026s=7219c0996a361a0efa1315710acaece8\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.deck.co#website\",\"name\":\"Deck Docs\",\"url\":\"https://docs.deck.co\",\"publisher\":{\"@id\":\"https://docs.deck.co/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.deck.co/api-reference/workflows/run-a-workflow#webpage\",\"url\":\"https://docs.deck.co/api-reference/workflows/run-a-workflow\",\"name\":\"Run a workflow\",\"description\":\"Runs a workflow. Returns immediately with the run queued.\",\"dateModified\":\"2026-10-23T21:36:30.824Z\",\"isPartOf\":{\"@id\":\"https://docs.deck.co#website\"},\"breadcrumb\":{\"@id\":\"https://docs.deck.co/api-reference/workflows/run-a-workflow#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.deck.co/api-reference/workflows/run-a-workflow#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Workflows\",\"item\":\"https://docs.deck.co/api-reference/workflows/create-a-workflow\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Run a workflow\",\"item\":\"https://docs.deck.co/api-reference/workflows/run-a-workflow\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.deck.co/api-reference/workflows/run-a-workflow#apireference\",\"headline\":\"Run a workflow\",\"name\":\"Run a workflow\",\"description\":\"Runs a workflow. Returns immediately with the run queued.\",\"url\":\"https://docs.deck.co/api-reference/workflows/run-a-workflow\",\"mainEntityOfPage\":{\"@id\":\"https://docs.deck.co/api-reference/workflows/run-a-workflow#webpage\"},\"dateModified\":\"2026-10-23T21:36:30.824Z\",\"publisher\":{\"@id\":\"https://docs.deck.co/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.deck.co#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Deck Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Deck Docs","nav":{"global":null,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":""}]},{"tab":"API Reference","groups":[{"group":"Agents","pages":[{"title":"Create an agent","deprecated":null,"version":null,"openapi":"/api-reference/v2.json post /agents","href":"/api-reference/agents/create-an-agent"},{"title":"List agents","deprecated":null,"version":null,"openapi":"/api-reference/v2.json get /agents","href":"/api-reference/agents/list-agents"},{"title":"Retrieve an agent","deprecated":null,"version":null,"openapi":"/api-reference/v2.json get /agents/{agent_id}","href":"/api-reference/agents/retrieve-an-agent"},{"title":"Update an agent","deprecated":null,"version":null,"openapi":"/api-reference/v2.json patch /agents/{agent_id}","href":"/api-reference/agents/update-an-agent"},{"title":"Delete an agent","deprecated":null,"version":null,"openapi":"/api-reference/v2.json delete /agents/{agent_id}","href":"/api-reference/agents/delete-an-agent"}]},{"group":"Sources","pages":[{"title":"Create a source","deprecated":null,"version":null,"openapi":"/api-reference/v2.json post /sources","href":"/api-reference/sources/create-a-source"},{"title":"List sources","deprecated":null,"version":null,"openapi":"/api-reference/v2.json get /sources","href":"/api-reference/sources/list-sources"},{"title":"Retrieve a source","deprecated":null,"version":null,"openapi":"/api-reference/v2.json get /sources/{source_id}","href":"/api-reference/sources/retrieve-a-source"},{"title":"Update a source","deprecated":null,"version":null,"openapi":"/api-reference/v2.json patch /sources/{source_id}","href":"/api-reference/sources/update-a-source"},{"title":"Reset a source","deprecated":null,"version":null,"openapi":"/api-reference/v2.json post /sources/{source_id}/reset","href":"/api-reference/sources/reset-a-source"},{"title":"Delete a source","deprecated":null,"version":null,"openapi":"/api-reference/v2.json delete /sources/{source_id}","href":"/api-reference/sources/delete-a-source"}]},{"group":"Tasks","pages":[{"title":"Create a task","deprecated":null,"version":null,"openapi":"/api-reference/v2.json post /tasks","href":"/api-reference/tasks/create-a-task"},{"title":"List tasks","deprecated":null,"version":null,"openapi":"/api-reference/v2.json get /tasks","href":"/api-reference/tasks/list-tasks"},{"title":"Retrieve a task","deprecated":null,"version":null,"openapi":"/api-reference/v2.json get /tasks/{task_id}","href":"/api-reference/tasks/retrieve-a-task"},{"title":"Update a task","deprecated":null,"version":null,"openapi":"/api-reference/v2.json patch /tasks/{task_id}","href":"/api-reference/tasks/update-a-task"},{"title":"Delete a task","deprecated":null,"version":null,"openapi":"/api-reference/v2.json delete /tasks/{task_id}","href":"/api-reference/tasks/delete-a-task"},{"title":"Run a task","deprecated":null,"version":null,"openapi":"/api-reference/v2.json post /tasks/{task_id}/run","href":"/api-reference/tasks/run-a-task"},{"title":"Reset a task","deprecated":null,"version":null,"openapi":"/api-reference/v2.json post /tasks/{task_id}/reset","href":"/api-reference/tasks/reset-a-task"}]},{"group":"Task Runs","pages":[{"title":"Retrieve a task run","deprecated":null,"version":null,"openapi":"/api-reference/v2.json get /task-runs/{run_id}","href":"/api-reference/task-runs/retrieve-a-task-run"},{"title":"List task runs","deprecated":null,"version":null,"openapi":"/api-reference/v2.json get /task-runs","href":"/api-reference/task-runs/list-task-runs"},{"title":"List task run storage items","deprecated":null,"version":null,"openapi":"/api-reference/v2.json get /task-runs/{run_id}/storage","href":"/api-reference/task-runs/list-task-run-storage-items"},{"title":"List task run screenshots","deprecated":null,"version":null,"openapi":"/api-reference/v2.json get /task-runs/{run_id}/screenshots","href":"/api-reference/task-runs/list-task-run-screenshots"},{"title":"Cancel a task run","deprecated":null,"version":null,"openapi":"/api-reference/v2.json post /task-runs/{run_id}/cancel","href":"/api-reference/task-runs/cancel-a-task-run"},{"title":"Rerun a task run","deprecated":null,"version":null,"openapi":"/api-reference/v2.json post /task-runs/{run_id}/rerun","href":"/api-reference/task-runs/rerun-a-task-run"},{"title":"Submit interaction input","deprecated":null,"version":null,"openapi":"/api-reference/v2.json post /task-runs/{run_id}/interaction","href":"/api-reference/task-runs/submit-interaction-input"}]},{"group":"Credentials","pages":[{"title":"Create a credential","deprecated":null,"version":null,"openapi":"/api-reference/v2.json post /credentials","href":"/api-reference/credentials/create-a-credential"},{"title":"List credentials","deprecated":null,"version":null,"openapi":"/api-reference/v2.json get /credentials","href":"/api-reference/credentials/list-credentials"},{"title":"Retrieve a credential","deprecated":null,"version":null,"openapi":"/api-reference/v2.json get /credentials/{credential_id}","href":"/api-reference/credentials/retrieve-a-credential"},{"title":"Update a credential","deprecated":null,"version":null,"openapi":"/api-reference/v2.json patch /credentials/{credential_id}","href":"/api-reference/credentials/update-a-credential"},{"title":"Delete a credential","deprecated":null,"version":null,"openapi":"/api-reference/v2.json delete /credentials/{credential_id}","href":"/api-reference/credentials/delete-a-credential"}]},{"group":"Sessions","pages":[{"title":"Start a session","deprecated":null,"version":null,"openapi":"/api-reference/v2.json post /sessions","href":"/api-reference/sessions/start-a-session"},{"title":"List sessions","deprecated":null,"version":null,"openapi":"/api-reference/v2.json get /sessions","href":"/api-reference/sessions/list-sessions"},{"title":"Retrieve a session","deprecated":null,"version":null,"openapi":"/api-reference/v2.json get /sessions/{session_id}","href":"/api-reference/sessions/retrieve-a-session"},{"title":"End a session","deprecated":null,"version":null,"openapi":"/api-reference/v2.json post /sessions/{session_id}/end","href":"/api-reference/sessions/end-a-session"}]},{"group":"Storage","pages":[{"title":"Retrieve a storage item","deprecated":null,"version":null,"openapi":"/api-reference/v2.json get /storage/{storage_id}","href":"/api-reference/storage/retrieve-a-storage-item"},{"title":"Delete a storage item","deprecated":null,"version":null,"openapi":"/api-reference/v2.json delete /storage/{storage_id}","href":"/api-reference/storage/delete-a-storage-item"}]},{"group":"Triggers","pages":[{"title":"Create a trigger","deprecated":null,"version":null,"openapi":"/api-reference/v2.json post /triggers","href":"/api-reference/triggers/create-a-trigger"},{"title":"List triggers","deprecated":null,"version":null,"openapi":"/api-reference/v2.json get /triggers","href":"/api-reference/triggers/list-triggers"},{"title":"Retrieve a trigger","deprecated":null,"version":null,"openapi":"/api-reference/v2.json get /triggers/{trigger_id}","href":"/api-reference/triggers/retrieve-a-trigger"},{"title":"Update a trigger","deprecated":null,"version":null,"openapi":"/api-reference/v2.json patch /triggers/{trigger_id}","href":"/api-reference/triggers/update-a-trigger"},{"title":"Delete a trigger","deprecated":null,"version":null,"openapi":"/api-reference/v2.json delete /triggers/{trigger_id}","href":"/api-reference/triggers/delete-a-trigger"},{"title":"List trigger credentials","deprecated":null,"version":null,"openapi":"/api-reference/v2.json get /triggers/{trigger_id}/credentials","href":"/api-reference/triggers/list-trigger-credentials"}]},{"group":"Workflows","pages":[{"title":"Create a workflow","deprecated":null,"version":null,"openapi":"/api-reference/v2.json post /workflows","href":"/api-reference/workflows/create-a-workflow"},{"title":"List workflows","deprecated":null,"version":null,"openapi":"/api-reference/v2.json get /workflows","href":"/api-reference/workflows/list-workflows"},{"title":"Retrieve a workflow","deprecated":null,"version":null,"openapi":"/api-reference/v2.json get /workflows/{workflow_id}","href":"/api-reference/workflows/retrieve-a-workflow"},{"title":"Update a workflow","deprecated":null,"version":null,"openapi":"/api-reference/v2.json patch /workflows/{workflow_id}","href":"/api-reference/workflows/update-a-workflow"},{"title":"Delete a workflow","description":"Deletes a workflow. Runs already in flight are unaffected.","deprecated":null,"version":null,"openapi":"/api-reference/v2.json delete /workflows/{workflow_id}","href":"/api-reference/workflows/delete-a-workflow"},{"title":"Run a workflow","deprecated":null,"version":null,"openapi":"/api-reference/v2.json post /workflows/{workflow_id}/run","href":"/api-reference/workflows/run-a-workflow"},{"title":"List workflow runs","description":"Returns a paginated list of workflow runs.","deprecated":null,"version":null,"openapi":"/api-reference/v2.json get /workflow-runs","href":"/api-reference/workflow-runs/list-workflow-runs"},{"title":"Retrieve a workflow run","deprecated":null,"version":null,"openapi":"/api-reference/v2.json get /workflow-runs/{workflow_run_id}","href":"/api-reference/workflow-runs/retrieve-a-workflow-run"},{"title":"Cancel a workflow run","deprecated":null,"version":null,"openapi":"/api-reference/v2.json post /workflow-runs/{workflow_run_id}/cancel","href":"/api-reference/workflow-runs/cancel-a-workflow-run"},{"title":"Rerun a workflow run","deprecated":null,"version":null,"openapi":"/api-reference/v2.json post /workflow-runs/{workflow_run_id}/rerun","href":"/api-reference/workflow-runs/rerun-a-workflow-run"}]},{"group":"Event Destinations","pages":[{"title":"Create an event destination","deprecated":null,"version":null,"openapi":"/api-reference/v2.json post /event-destinations","href":"/api-reference/event-destinations/create-an-event-destination"},{"title":"List event destinations","deprecated":null,"version":null,"openapi":"/api-reference/v2.json get /event-destinations","href":"/api-reference/event-destinations/list-event-destinations"},{"title":"Retrieve an event destination","deprecated":null,"version":null,"openapi":"/api-reference/v2.json get /event-destinations/{destination_id}","href":"/api-reference/event-destinations/retrieve-an-event-destination"},{"title":"Update an event destination","deprecated":null,"version":null,"openapi":"/api-reference/v2.json patch /event-destinations/{destination_id}","href":"/api-reference/event-destinations/update-an-event-destination"},{"title":"Delete an event destination","deprecated":null,"version":null,"openapi":"/api-reference/v2.json delete /event-destinations/{destination_id}","href":"/api-reference/event-destinations/delete-an-event-destination"},{"title":"Send a test event to a destination","deprecated":null,"version":null,"openapi":"/api-reference/v2.json post /event-destinations/{destination_id}/test","href":"/api-reference/event-destinations/send-a-test-event-to-a-destination"},{"title":"List event deliveries","deprecated":null,"version":null,"openapi":"/api-reference/v2.json get /event-destinations/{destination_id}/event-deliveries","href":"/api-reference/event-destinations/list-event-deliveries"}]},{"group":"Events","pages":[{"title":"List events","deprecated":null,"version":null,"openapi":"/api-reference/v2.json get /events","href":"/api-reference/events/list-events"},{"title":"Retrieve an event","deprecated":null,"version":null,"openapi":"/api-reference/v2.json get /events/{event_id}","href":"/api-reference/events/retrieve-an-event"},{"title":"List event types","deprecated":null,"version":null,"openapi":"/api-reference/v2.json get /event-types","href":"/api-reference/events/list-event-types"}]},{"group":"Components","pages":[{"title":"Create a session token","deprecated":null,"version":null,"openapi":"/api-reference/v2.json post /token","href":"/api-reference/components/create-a-session-token"}]},{"group":"Platform","pages":[{"title":"Retrieve the static IP range","deprecated":null,"version":null,"openapi":"/api-reference/v2.json get /static-ips","href":"/api-reference/platform/retrieve-the-static-ip-range"}]},{"group":"Test","pages":[{"title":"Test your API key","deprecated":null,"version":null,"openapi":"/api-reference/v2.json get /test","href":"/api-reference/test/test-your-api-key"}]}]},{"tab":"Changelog","href":"https://deck.co/changelog"}]},"title":"Run a workflow - Deck Docs","buildId":"dpl_2xiSHD9XEvLsPGPcfoMtkLTB3dy9","deploymentId":"dpl_2xiSHD9XEvLsPGPcfoMtkLTB3dy9","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DmVyH30O.js","utils-BHQqGGOd.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-CD-E4BIt.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Bp5Lq9Ds.js","snippetPresets-C4xAVCFP.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CgXVLxUC.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BF8I5oUf.js","shallow-Byd0lWnC.js","getApiPlaygroundDisplay-BGOZG1OK.js","CodeSnippet-CpvQL0CY.js","CodeSnippets-B8wkBKXa.js","Page-CBCH2P7b.js","getPastedJson-Ry3scI3Y.js","icon-D7a9HcdD.js","MethodPill-CJ8pmHhz.js","DuplicateIcon-rh1HJF0t.js","createIcon-DvGznqYs.js","DynamicMarkdown-Cc6AuSHS.js","SectionHeading-B4A0S-ep.js","axios-vUo_bRtp.js","Markdown-Cc16CX65.js","clsx-Cs6nMGht.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-zbf22OZA.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-C_fs-y5n.js"]}