Hands a run whose Wait for step waits on another system what it waited for; the run carries on from there. 202 the run carries on, 404 no such run of this automation in this workspace, 409 the run isn’t waiting for a callback (already answered, or past its time limit).
{"docsConfig":{"theme":"maple","$schema":"https://mintlify.com/docs.json","name":"Mercora","description":"Trade operations for physical commodity traders: documents, matching, reconciliation, financials and the P\u0026L.","colors":{"primary":"#232323","light":"#FFF9EE","dark":"#232323"},"logo":{"light":"https://mintcdn.com/placeholder-f4ffdeec/22McaegbdDRSI41b/logo/mark-dark.svg?fit=max\u0026auto=format\u0026n=22McaegbdDRSI41b\u0026q=85\u0026s=72ad184e9bf63cc57e531ed33f5c631b","dark":"https://mintcdn.com/placeholder-f4ffdeec/22McaegbdDRSI41b/logo/mark-light.svg?fit=max\u0026auto=format\u0026n=22McaegbdDRSI41b\u0026q=85\u0026s=743a6c820e7423e0df7a6e0ae10efc86","href":"/"},"favicon":"https://mintcdn.com/placeholder-f4ffdeec/22McaegbdDRSI41b/favicon.svg?fit=max\u0026auto=format\u0026n=22McaegbdDRSI41b\u0026q=85\u0026s=60a082af42cdf29819901c284f9e7359","appearance":{"default":"system","strict":false},"background":{"color":{"light":"#FFFFFF","dark":"#171717"}},"navbar":{"links":[{"href":"https://mercora.io","label":"mercora.io"}]},"footer":{"socials":{"website":"https://mercora.io","linkedin":"https://www.linkedin.com/company/mercoraai"}},"search":{"prompt":"Search the docs…"},"fonts":{"family":"Inter"},"icons":{"library":"fontawesome"},"styling":{"eyebrows":"section","codeblocks":"system","latex":true},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"placeholder-f4ffdeec","hasAudioNarration":false,"actualSubdomain":"placeholder-f4ffdeec","customDomains":["docs.mercora.io"],"gitSource":{"type":"github","owner":"sebastianbugal","repo":"mercora","deployBranch":"main","contentDirectory":"client_docs","isPrivate":true,"mountPath":"","label":"","_id":"6adf3dbbabb6f86a455ef035"},"chroma":{"latestBuiltDeploymentHistoryId":"6ae0668a02cd8de5ec2643dc","collectionId":"13289552-774c-43a0-b354-db31f2d90208","liveDeploymentHistoryId":"6ae0668a02cd8de5ec2643dc","schemaVersion":"v3"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae09da407896b4595e1d2f2","clientVersion":"0.0.3971","searchFilterCounts":[{"language":"default","tag":"Guides","count":37},{"language":"default","tag":"API reference","count":6},{"language":"default","tag":"Documents","count":6},{"language":"default","tag":"Integrations","count":6},{"language":"default","tag":"Copilot and workflows","count":5},{"language":"default","tag":"Get started","count":5},{"language":"default","tag":"Administration","count":3},{"language":"default","tag":"Core concepts","count":3},{"language":"default","tag":"Finance","count":3},{"language":"default","tag":"Records","count":3}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","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":"editor-nav-generations","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":"editor-agent-model-picker","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}],"isAtlas":false,"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"/* vietnamese */\n@font-face {\n font-family: 'Newsreader';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/newsreader/v26/cY9AfjOCX1hbuyalUrK439HyjJBG.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Newsreader';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/newsreader/v26/cY9AfjOCX1hbuyalUrK439DyjJBG.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Newsreader';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/newsreader/v26/cY9AfjOCX1hbuyalUrK4397yjA.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* vietnamese */\n@font-face {\n font-family: 'Newsreader';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/newsreader/v26/cY9AfjOCX1hbuyalUrK439HyjJBG.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Newsreader';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/newsreader/v26/cY9AfjOCX1hbuyalUrK439DyjJBG.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Newsreader';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/newsreader/v26/cY9AfjOCX1hbuyalUrK4397yjA.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n:root{--mc-border:rgb(35 35 35 / 0.1);--mc-border-strong:rgb(35 35 35 / 0.28);--mc-shadow:0 1px 2px rgb(0 0 0 / 0.04), 0 6px 16px -6px rgb(0 0 0 / 0.08);--mc-frame-bg:#fafafa}html.dark{--mc-border:rgb(255 249 238 / 0.1);--mc-border-strong:rgb(255 249 238 / 0.3);--mc-shadow:0 1px 2px rgb(0 0 0 / 0.3), 0 6px 16px -6px rgb(0 0 0 / 0.5);--mc-frame-bg:#1d1d1d}#page-title{font-family:\"Newsreader\",ui-serif,Georgia,serif;font-weight:500;letter-spacing:-.015em}.mdx-content>blockquote,.mdx-content>ol,.mdx-content>p,.mdx-content>ul{max-width:72ch}.card{transition:border-color 150ms ease,box-shadow 150ms ease}.card:hover{border-color:var(--mc-border-strong)!important;box-shadow:var(--mc-shadow)}[data-name=frame]{background:var(--mc-frame-bg)}[data-name=frame] img{border:1px solid var(--mc-border);border-radius:.625rem}.mdx-content table{font-size:.875rem;font-variant-numeric:tabular-nums}.mdx-content td,.mdx-content th{padding-top:.5rem;padding-bottom:.5rem}@media (prefers-reduced-motion:reduce){.card{transition:none}}"}],"page":{"pagePath":"api-reference/automations/answer-a-run-that-waits-for-your-system","slug":"/api-reference/automations/answer-a-run-that-waits-for-your-system","pageMetadata":{"title":"Answer a run that waits for your system","description":"Hands a run whose Wait for step waits on another system what it waited for; the run carries on from there. 202 the run carries on, 404 no such run of this automation in this workspace, 409 the run isn't waiting for a callback (already answered, or past its time limit).\n\nScope: `automations`.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /agents/{id}/runs/{runId}/callback","href":"/api-reference/automations/answer-a-run-that-waits-for-your-system","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Hands a run whose Wait for step waits on another system what it waited for; the run carries on from there. 202 the run carries on, 404 no such run of this automation in this workspace, 409 the run isn’t waiting for a callback (already answered, or past its time limit).\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Scope: \", _jsx(_components.code, {\n children: \"automations\"\n }), \".\"]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"codeStyling":"system","config":{},"pageMetadata":{"title":"Answer a run that waits for your system","description":"Hands a run whose Wait for step waits on another system what it waited for; the run carries on from there. 202 the run carries on, 404 no such run of this automation in this workspace, 409 the run isn't waiting for a callback (already answered, or past its time limit).\n\nScope: `automations`.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /agents/{id}/runs/{runId}/callback","href":"/api-reference/automations/answer-a-run-that-waits-for-your-system","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"answerAutomationRun","tags":["Automations"],"summary":"Answer a run that waits for your system","description":"Hands a run whose Wait for step waits on another system what it waited for; the run carries on from there. 202 the run carries on, 404 no such run of this automation in this workspace, 409 the run isn't waiting for a callback (already answered, or past its time limit).\n\nScope: `automations`.","security":["1ad6fb98-06ea-453e-9eab-de82ce651051"],"parameters":["5286c963-b2c4-4c10-ba21-c0da10c083ab","3df314f3-eacb-4026-88c6-2049e2d0e5e9"],"requestBody":"b8b23deb-45fd-41a2-9bc3-3fa983d9ab73","responses":{"202":"d4974ea9-64ab-4dad-a77e-e4163ce83b1e","400":"8c7e9cf8-71e5-458a-a3d1-3e7241547767","401":"f79fbd51-50a0-492f-89cc-f32459fdb389","403":"78a25d6e-bd75-4c56-967b-bcae06e27bfc","404":"5f8d06bc-743e-47d5-9d2b-a29b4cc0a370","409":"aa062c3b-d163-42e7-bbcb-810b2655cce5","422":"1ccaecdc-5981-493f-943e-8e5842b9e4a7","500":"4943eddb-0d6f-451e-9c71-6e3600eb9fd4"},"method":"post","type":"path","servers":["fb5a5da5-1701-4b2c-9d0f-153c62c7944d"],"path":"/agents/{id}/runs/{runId}/callback","baseUrlOptions":["https://{workspace}.mercora.io/api/v1"],"title":"Answer a run that waits for your system","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"5286c963-b2c4-4c10-ba21-c0da10c083ab":{"schema":{"type":"string","description":"The automation's id.","isRequired":true,"uniqueKey":"","typeLabel":"string"},"required":true,"description":"The automation's id.","name":"id","in":"path"},"3df314f3-eacb-4026-88c6-2049e2d0e5e9":{"schema":{"type":"string","description":"The run's id, as the run request returned it.","isRequired":true,"uniqueKey":"","typeLabel":"string"},"required":true,"description":"The run's id, as the run request returned it.","name":"runId","in":"path"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"payload":{"type":"object","additionalProperties":{"oneOf":[{}],"uniqueKey":"payload.additionalProperties","typeLabel":"any"},"description":"What the run waited for. Its fields become the waiting step's values, which later steps pick by name.","isRequired":true,"uniqueKey":"payload","typeLabel":"object"}},"required":["payload"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"example":{"payload":{"fill_price":2450,"lots":10}},"examples":{"Example":{"title":"Example","value":{"payload":{"fill_price":2450,"lots":10}}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"d4974ea9-64ab-4dad-a77e-e4163ce83b1e":{"description":"The run carries on.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"The run's id.","isRequired":true,"uniqueKey":"id","typeLabel":"string"}},"required":["id"],"uniqueKey":"","typeLabel":"object"},"example":{"id":"1c9e2f3a-4b5d-4e6f-9a0b-1c2d3e4f5a6b"},"examples":{"Example":{"title":"Example","value":{"id":"1c9e2f3a-4b5d-4e6f-9a0b-1c2d3e4f5a6b"}}},"exampleType":"examples"}},"exampleType":"examples"},"8c7e9cf8-71e5-458a-a3d1-3e7241547767":{"description":"Body is not JSON.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"field":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"issues.items.[INDEX].field.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"issues.items.[INDEX].field.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"issues.items.[INDEX].field","typeLabel":"string | null"},"message":{"type":"string","isRequired":true,"uniqueKey":"issues.items.[INDEX].message","typeLabel":"string"}},"required":["field","message"],"uniqueKey":"issues.items.[INDEX]","typeLabel":"object"},"description":"On a 422: one entry per field that failed.","uniqueKey":"issues","typeLabel":"object[]"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","issues":[{"field":"\u003cstring>","message":"\u003cstring>"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"f79fbd51-50a0-492f-89cc-f32459fdb389":{"description":"Key missing, unknown or revoked.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"field":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"issues.items.[INDEX].field.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"issues.items.[INDEX].field.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"issues.items.[INDEX].field","typeLabel":"string | null"},"message":{"type":"string","isRequired":true,"uniqueKey":"issues.items.[INDEX].message","typeLabel":"string"}},"required":["field","message"],"uniqueKey":"issues.items.[INDEX]","typeLabel":"object"},"description":"On a 422: one entry per field that failed.","uniqueKey":"issues","typeLabel":"object[]"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","issues":[{"field":"\u003cstring>","message":"\u003cstring>"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"78a25d6e-bd75-4c56-967b-bcae06e27bfc":{"description":"The key lacks the `automations` scope, or the resource's module is off for the workspace.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"field":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"issues.items.[INDEX].field.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"issues.items.[INDEX].field.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"issues.items.[INDEX].field","typeLabel":"string | null"},"message":{"type":"string","isRequired":true,"uniqueKey":"issues.items.[INDEX].message","typeLabel":"string"}},"required":["field","message"],"uniqueKey":"issues.items.[INDEX]","typeLabel":"object"},"description":"On a 422: one entry per field that failed.","uniqueKey":"issues","typeLabel":"object[]"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","issues":[{"field":"\u003cstring>","message":"\u003cstring>"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"5f8d06bc-743e-47d5-9d2b-a29b4cc0a370":{"description":"No such run of this automation in this workspace.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"field":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"issues.items.[INDEX].field.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"issues.items.[INDEX].field.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"issues.items.[INDEX].field","typeLabel":"string | null"},"message":{"type":"string","isRequired":true,"uniqueKey":"issues.items.[INDEX].message","typeLabel":"string"}},"required":["field","message"],"uniqueKey":"issues.items.[INDEX]","typeLabel":"object"},"description":"On a 422: one entry per field that failed.","uniqueKey":"issues","typeLabel":"object[]"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","issues":[{"field":"\u003cstring>","message":"\u003cstring>"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"aa062c3b-d163-42e7-bbcb-810b2655cce5":{"description":"The run isn't waiting for a callback.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"field":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"issues.items.[INDEX].field.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"issues.items.[INDEX].field.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"issues.items.[INDEX].field","typeLabel":"string | null"},"message":{"type":"string","isRequired":true,"uniqueKey":"issues.items.[INDEX].message","typeLabel":"string"}},"required":["field","message"],"uniqueKey":"issues.items.[INDEX]","typeLabel":"object"},"description":"On a 422: one entry per field that failed.","uniqueKey":"issues","typeLabel":"object[]"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","issues":[{"field":"\u003cstring>","message":"\u003cstring>"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"1ccaecdc-5981-493f-943e-8e5842b9e4a7":{"description":"Body failed its schema; `issues` lists each field.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"field":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"issues.items.[INDEX].field.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"issues.items.[INDEX].field.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"issues.items.[INDEX].field","typeLabel":"string | null"},"message":{"type":"string","isRequired":true,"uniqueKey":"issues.items.[INDEX].message","typeLabel":"string"}},"required":["field","message"],"uniqueKey":"issues.items.[INDEX]","typeLabel":"object"},"description":"On a 422: one entry per field that failed.","uniqueKey":"issues","typeLabel":"object[]"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","issues":[{"field":"\u003cstring>","message":"\u003cstring>"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"4943eddb-0d6f-451e-9c71-6e3600eb9fd4":{"description":"Ours, logged with the workspace and key. Retrying is safe.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"field":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"issues.items.[INDEX].field.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"issues.items.[INDEX].field.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"issues.items.[INDEX].field","typeLabel":"string | null"},"message":{"type":"string","isRequired":true,"uniqueKey":"issues.items.[INDEX].message","typeLabel":"string"}},"required":["field","message"],"uniqueKey":"issues.items.[INDEX]","typeLabel":"object"},"description":"On a 422: one entry per field that failed.","uniqueKey":"issues","typeLabel":"object[]"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","issues":[{"field":"\u003cstring>","message":"\u003cstring>"}]}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"1ad6fb98-06ea-453e-9eab-de82ce651051":{"bearerAuth":{"type":"http","scheme":"bearer","description":"A workspace API key (mk_…), made under Settings → Administration → API.","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"fb5a5da5-1701-4b2c-9d0f-153c62c7944d":{"url":"https://{workspace}.mercora.io/api/v1","description":"Your Mercora workspace","variables":{"workspace":{"default":"your-company","description":"Your workspace subdomain"}}}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"A workspace API key (mk_…), made under Settings → Administration → API.","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"A workspace API key (mk_…), made under Settings → Administration → API.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"placeholder-f4ffdeec","siteName":"Mercora","title":"Answer a run that waits for your system - Mercora","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-26T11:51:22.899Z","originalFileLocation":"api-reference/automations/answer-a-run-that-waits-for-your-system.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}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=\"Hands a run whose Wait for step waits on another system what it waited for; the run carries on from there. 202 the run carries on, 404 no such run of this automation in this workspace, 409 the run isn\u0026#x27;t waiting for a callback (already answered, or past its time limit). Scope: automations.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Mercora\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/placeholder-f4ffdeec/XOETJcrPFhZvltr-/_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/placeholder-f4ffdeec/XOETJcrPFhZvltr-/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/placeholder-f4ffdeec/XOETJcrPFhZvltr-/_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/placeholder-f4ffdeec/XOETJcrPFhZvltr-/_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/placeholder-f4ffdeec/XOETJcrPFhZvltr-/_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/placeholder-f4ffdeec/XOETJcrPFhZvltr-/_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/placeholder-f4ffdeec/XOETJcrPFhZvltr-/_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/placeholder-f4ffdeec/XOETJcrPFhZvltr-/_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/placeholder-f4ffdeec/XOETJcrPFhZvltr-/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Answer a run that waits for your system - Mercora\">\u003cmeta data-mint-head property=\"og:description\" content=\"Hands a run whose Wait for step waits on another system what it waited for; the run carries on from there. 202 the run carries on, 404 no such run of this automation in this workspace, 409 the run isn\u0026#x27;t waiting for a callback (already answered, or past its time limit). Scope: automations.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Mercora\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.mercora.io/api-reference/automations/answer-a-run-that-waits-for-your-system\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://placeholder-f4ffdeec.mintlify.app/_mintlify/api/og/v2?division=Automations\u0026amp;title=Answer+a+run+that+waits+for+your+system\u0026amp;description=Hands+a+run+whose+Wait+for+step+waits+on+another+system+what+it+waited+for%3B+the+run+carries+on+from+there.+202+the+run+carries+on%2C+404+no+such+run+of+this+autom\u0026amp;theme=b55c1587f6fc9c9340bca578\u0026amp;signature=546f866c61db1a81bff79ee5b9fb3b6d3a7626726051dec49f9e58842fcf68dd\">\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=\"Answer a run that waits for your system - Mercora\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Hands a run whose Wait for step waits on another system what it waited for; the run carries on from there. 202 the run carries on, 404 no such run of this automation in this workspace, 409 the run isn\u0026#x27;t waiting for a callback (already answered, or past its time limit). Scope: automations.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://placeholder-f4ffdeec.mintlify.app/_mintlify/api/og/v2?division=Automations\u0026amp;title=Answer+a+run+that+waits+for+your+system\u0026amp;description=Hands+a+run+whose+Wait+for+step+waits+on+another+system+what+it+waited+for%3B+the+run+carries+on+from+there.+202+the+run+carries+on%2C+404+no+such+run+of+this+autom\u0026amp;theme=b55c1587f6fc9c9340bca578\u0026amp;signature=546f866c61db1a81bff79ee5b9fb3b6d3a7626726051dec49f9e58842fcf68dd\">\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/placeholder-f4ffdeec/XOETJcrPFhZvltr-/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Mercora\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#232323\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.mercora.io/api-reference/automations/answer-a-run-that-waits-for-your-system\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/automations/answer-a-run-that-waits-for-your-system.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.mercora.io/#organization\",\"name\":\"Mercora\",\"url\":\"https://docs.mercora.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/placeholder-f4ffdeec/22McaegbdDRSI41b/logo/mark-dark.svg?fit=max\u0026auto=format\u0026n=22McaegbdDRSI41b\u0026q=85\u0026s=72ad184e9bf63cc57e531ed33f5c631b\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.mercora.io#website\",\"name\":\"Mercora\",\"url\":\"https://docs.mercora.io\",\"publisher\":{\"@id\":\"https://docs.mercora.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.mercora.io/api-reference/automations/answer-a-run-that-waits-for-your-system#webpage\",\"url\":\"https://docs.mercora.io/api-reference/automations/answer-a-run-that-waits-for-your-system\",\"name\":\"Answer a run that waits for your system\",\"description\":\"Hands a run whose Wait for step waits on another system what it waited for; the run carries on from there. 202 the run carries on, 404 no such run of this automation in this workspace, 409 the run isn't waiting for a callback (already answered, or past its time limit). Scope: automations.\",\"dateModified\":\"2026-10-26T11:51:22.899Z\",\"isPartOf\":{\"@id\":\"https://docs.mercora.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.mercora.io/api-reference/automations/answer-a-run-that-waits-for-your-system#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.mercora.io/api-reference/automations/answer-a-run-that-waits-for-your-system#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Automations\",\"item\":\"https://docs.mercora.io/api-reference/automations/start-an-automation-run\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Answer a run that waits for your system\",\"item\":\"https://docs.mercora.io/api-reference/automations/answer-a-run-that-waits-for-your-system\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.mercora.io/api-reference/automations/answer-a-run-that-waits-for-your-system#apireference\",\"headline\":\"Answer a run that waits for your system\",\"name\":\"Answer a run that waits for your system\",\"description\":\"Hands a run whose Wait for step waits on another system what it waited for; the run carries on from there. 202 the run carries on, 404 no such run of this automation in this workspace, 409 the run isn't waiting for a callback (already answered, or past its time limit). Scope: automations.\",\"url\":\"https://docs.mercora.io/api-reference/automations/answer-a-run-that-waits-for-your-system\",\"mainEntityOfPage\":{\"@id\":\"https://docs.mercora.io/api-reference/automations/answer-a-run-that-waits-for-your-system#webpage\"},\"dateModified\":\"2026-10-26T11:51:22.899Z\",\"publisher\":{\"@id\":\"https://docs.mercora.io/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.mercora.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Mercora\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Mercora","nav":{"global":null,"tabs":[{"tab":"Guides","icon":"book-open","pages":[{"title":"Guides","href":""}]},{"tab":"API reference","icon":"code","groups":[{"group":"Overview","icon":"book","pages":[{"title":"Introduction","icon":"code","href":"/api-reference/introduction"}]},{"group":"Hedging","icon":"shield-halved","pages":[{"title":"List hedge books","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /hedge-books","href":"/api-reference/hedge-requests/list-hedge-books"},{"title":"Request a hedge","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /hedge-requests","href":"/api-reference/hedge-requests/request-a-hedge"},{"title":"Get a hedge request","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /hedge-requests/{id}","href":"/api-reference/hedge-requests/get-a-hedge-request"}]},{"group":"Automations","icon":"gears","pages":[{"title":"Start an automation run","description":"Starts a run of an automation whose trigger is the API. The run works in Mercora; anything it would change waits for a person's approval there. 201 a new run, 200 a retry of an external_id already used with the same body, 404 no such automation in this workspace, 409 the automation doesn't run from the API or the external_id was used with another body, 429 the workspace's daily run budget is used up.\n\nScope: `automations`.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /agents/{id}/run","href":"/api-reference/automations/start-an-automation-run"},{"title":"Answer a run that waits for your system","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /agents/{id}/runs/{runId}/callback","href":"/api-reference/automations/answer-a-run-that-waits-for-your-system"}]}]}]},"title":"Answer a run that waits for your system - Mercora","buildId":"dpl_DFJrtvUi8HS5F9nkooKuDJsuD5BM","deploymentId":"dpl_DFJrtvUi8HS5F9nkooKuDJsuD5BM","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-rfhihCWU.js","utils-BmH1XFxk.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-BcNsxPKB.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-BAES3tkd.js","snippetPresets-DCMQBKLP.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","Page-D5fEM6aW.js","ApiExamples-D6l_bzE9.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BOktbnNh.js","shallow-BCs8SgM7.js","getApiPlaygroundDisplay-DEmW5bJB.js","CodeSnippet-CpZOpB9C.js","CodeSnippets-BOBDqibl.js","getPastedJson-DH2JBvmr.js","icon-BBJH-kKh.js","MethodPill-D2Sd5NLC.js","DuplicateIcon-CGgfL2qN.js","createIcon-BKudBBzi.js","DynamicMarkdown-85clUA0i.js","SectionHeading-D0JiMgDx.js","axios-vUo_bRtp.js","Markdown-Cfiy0xZO.js","clsx-rL8ZCCw4.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-aeztFa9U.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BywkCr5C.js"]}