For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Dashboard
User GuideDeveloper GuidesAPI Reference
User GuideDeveloper GuidesAPI Reference
    • Overview
  • Runtype API
      • STREAMExecute a flow or agent
      • STREAMApprove or deny a pending approval
      • STREAMContinue a paused execution
      • STREAMResume a paused execution
Dashboard
LogoLogo
Runtype APIDispatch

Resume a paused execution

POST
/v1/dispatch/resume
POST
/v1/dispatch/resume
$curl -X POST https://api.runtype.com/v1/dispatch/resume \
>     -H "Authorization: <apiKey>" \
>     -H "Content-Type: application/json" \
>     -d '{
>  "executionId": "exec_abc123def456",
>  "messages": [
>    {
>      "role": "user",
>      "content": "Please continue processing with this data."
>    }
>  ],
>  "streamResponse": true,
>  "toolOutputs": {
>    "get_user_data": {
>      "email": "jane@example.com",
>      "name": "Jane Doe"
>    }
>  }
>}'
Resumes a paused flow or agent execution by providing tool outputs. Does not count against execution limits.
Was this page helpful?
Previous

Search documentation

Next
Built with

Authentication

AuthorizationBearer
API key or Clerk session token

Request

This endpoint expects an object.
executionIdstringRequired>=1 character
The execution ID to resume
messageslist of objectsOptional
streamResponsebooleanOptional
Whether to stream the response via SSE
toolOutputsmap from strings to anyOptional

Local tool outputs for the paused execution. Key each output by the per-call toolCallId from the flow_await / agent_await event (preferred, and required to disambiguate parallel calls to the same tool), or by tool name (legacy; collapses same-tool parallel calls onto one slot).

Response

Execution resumed (SSE stream or JSON)

object
OR
object
OR
object
OR
object
OR
object
OR
object
OR
object
OR
object
OR
object
OR
object
OR
object
OR
object
OR
object
OR
object
OR
object
OR
object
OR
object
OR
object
OR
object
OR
object
OR
object
OR
object
OR
object
OR
object
OR
object
OR
object
OR
object
OR
object
OR
object
OR
object
OR
object
OR
object
OR
object
OR
object
OR
object
OR
object
OR
object
OR
object
OR
object
OR
object
OR
object
OR
object
OR
object
OR
object
OR
object
OR
object
OR
object
OR
object
OR
object
OR
object
OR
object
OR
object

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
500
Internal Server Error