Comma-separated list of additional fields to include on each task_runs entry. Supported values: input, storage, artifacts. Sections are omitted from the response (not returned as null) when their flag is not present.
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/workflow-runs/retrieve-a-workflow-run","slug":"/api-reference/workflow-runs/retrieve-a-workflow-run","pageMetadata":{"title":"Retrieve a workflow run","description":"Returns a single workflow run by ID, including each step's status, output, and task runs.","deprecated":null,"version":null,"openapi":"/api-reference/v2.json get /workflow-runs/{workflow_run_id}","href":"/api-reference/workflow-runs/retrieve-a-workflow-run","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Returns a single workflow run by ID, including each step’s status, output, and task runs.\"\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":"Retrieve a workflow run","description":"Returns a single workflow run by ID, including each step's status, output, and task runs.","deprecated":null,"version":null,"openapi":"/api-reference/v2.json get /workflow-runs/{workflow_run_id}","href":"/api-reference/workflow-runs/retrieve-a-workflow-run","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/decksoftwareinc/60feb3fe1b2400a1/mermaid.js","/_mintlify/custom/decksoftwareinc/53c63d97f88b046e/toc.js"],"openApiReferenceData":{"operation":{"tags":["Workflow Runs"],"summary":"Retrieve a workflow run","operationId":"getWorkflowRun","description":"Returns a single workflow run by ID, including each step's status, output, and task runs.","parameters":["172d7e86-9777-4482-81d4-61546c3b9dd2","aa4be9e8-955f-49f0-a24d-4bea46d0aa50"],"responses":{"200":"cd879dd8-069c-4bd5-84e2-5630c6132a4c","400":"4ad67f66-1f2b-4592-86ac-107db73e7d33","401":"de404f2f-143b-41fe-89d5-c76be1d9c785","403":"92629274-312f-4cdc-a59a-51bb63bf02ad","404":"981e1b85-7d4e-4d38-95b0-11ed90de02bc","409":"ed8dbb68-ddb6-4c86-929f-6ed4bb70e406","422":"b277be3d-59b7-4faa-a099-0001628dcf93","429":"0aa94054-a56a-4b0d-9fb1-7c3c1a5d939c","500":"caf72945-200d-4e95-a1cc-a666745c443a"},"method":"get","type":"path","servers":["e7891587-14e5-4adb-832b-247637593716"],"security":["dc8ae21e-0d3e-40ae-bf25-638c0c900a99"],"path":"/workflow-runs/{workflow_run_id}","baseUrlOptions":["https://api.deck.co/v2"],"title":"Retrieve a workflow run","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"172d7e86-9777-4482-81d4-61546c3b9dd2":{"name":"workflow_run_id","in":"path","required":true,"schema":{"type":"string","pattern":"^wrun_","example":"wrun_AbC123xYz456","isRequired":true,"description":"Unique identifier for the workflow run (prefixed with `wrun_`).","uniqueKey":"","typeLabel":"string"},"description":"Unique identifier for the workflow run (prefixed with `wrun_`)."},"aa4be9e8-955f-49f0-a24d-4bea46d0aa50":{"name":"include","in":"query","schema":{"type":"string","description":"Comma-separated list of additional fields to include on each `task_runs` entry. Supported values: `input`, `storage`, `artifacts`. Sections are omitted from the response (not returned as null) when their flag is not present.","uniqueKey":"","typeLabel":"string"},"description":"Comma-separated list of additional fields to include on each `task_runs` entry. Supported values: `input`, `storage`, `artifacts`. Sections are omitted from the response (not returned as null) when their flag is not present."}},"responses":{"cd879dd8-069c-4bd5-84e2-5630c6132a4c":{"description":"OK","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"},"4ad67f66-1f2b-4592-86ac-107db73e7d33":{"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"},"de404f2f-143b-41fe-89d5-c76be1d9c785":{"description":"Unauthorized.","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"92629274-312f-4cdc-a59a-51bb63bf02ad":{"description":"Forbidden.","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"981e1b85-7d4e-4d38-95b0-11ed90de02bc":{"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"},"ed8dbb68-ddb6-4c86-929f-6ed4bb70e406":{"description":"Conflict — the request is valid but cannot be completed in the current state.","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"},"b277be3d-59b7-4faa-a099-0001628dcf93":{"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"},"0aa94054-a56a-4b0d-9fb1-7c3c1a5d939c":{"description":"Too many requests — the organization-wide API rate limit was exceeded (`rate_limit_exceeded`). 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"},"caf72945-200d-4e95-a1cc-a666745c443a":{"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":"Retrieve a workflow run - Deck Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-23T21:36:30.845Z","originalFileLocation":"api-reference/workflow-runs/retrieve-a-workflow-run.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=\"Returns a single workflow run by ID, including each step\u0026#x27;s status, output, and task runs.\">\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=\"Retrieve a workflow run - Deck Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Returns a single workflow run by ID, including each step\u0026#x27;s status, output, and task runs.\">\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/workflow-runs/retrieve-a-workflow-run\">\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=Retrieve+a+workflow+run\u0026amp;description=Returns+a+single+workflow+run+by+ID%2C+including+each+step%27s+status%2C+output%2C+and+task+runs.\u0026amp;theme=34e13586d13a0a394dea5bd4\u0026amp;signature=7815da1dd513086c67c5ba54681f8b22540964f0e0728148c30b316cbcc7742e\">\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=\"Retrieve a workflow run - Deck Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Returns a single workflow run by ID, including each step\u0026#x27;s status, output, and task runs.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://decksoftwareinc.mintlify.app/_mintlify/api/og/v2?division=Workflows\u0026amp;title=Retrieve+a+workflow+run\u0026amp;description=Returns+a+single+workflow+run+by+ID%2C+including+each+step%27s+status%2C+output%2C+and+task+runs.\u0026amp;theme=34e13586d13a0a394dea5bd4\u0026amp;signature=7815da1dd513086c67c5ba54681f8b22540964f0e0728148c30b316cbcc7742e\">\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/workflow-runs/retrieve-a-workflow-run\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/workflow-runs/retrieve-a-workflow-run.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/workflow-runs/retrieve-a-workflow-run#webpage\",\"url\":\"https://docs.deck.co/api-reference/workflow-runs/retrieve-a-workflow-run\",\"name\":\"Retrieve a workflow run\",\"description\":\"Returns a single workflow run by ID, including each step's status, output, and task runs.\",\"dateModified\":\"2026-10-23T21:36:30.845Z\",\"isPartOf\":{\"@id\":\"https://docs.deck.co#website\"},\"breadcrumb\":{\"@id\":\"https://docs.deck.co/api-reference/workflow-runs/retrieve-a-workflow-run#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.deck.co/api-reference/workflow-runs/retrieve-a-workflow-run#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Workflows\",\"item\":\"https://docs.deck.co/api-reference/workflows/create-a-workflow\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Retrieve a workflow run\",\"item\":\"https://docs.deck.co/api-reference/workflow-runs/retrieve-a-workflow-run\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.deck.co/api-reference/workflow-runs/retrieve-a-workflow-run#apireference\",\"headline\":\"Retrieve a workflow run\",\"name\":\"Retrieve a workflow run\",\"description\":\"Returns a single workflow run by ID, including each step's status, output, and task runs.\",\"url\":\"https://docs.deck.co/api-reference/workflow-runs/retrieve-a-workflow-run\",\"mainEntityOfPage\":{\"@id\":\"https://docs.deck.co/api-reference/workflow-runs/retrieve-a-workflow-run#webpage\"},\"dateModified\":\"2026-10-23T21:36:30.845Z\",\"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","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","description":"Cancels a workflow run and any in-flight task 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":"Retrieve a workflow run - 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"]}