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

Approve or deny a pending approval

POST
/v1/dispatch/approve
POST
/v1/dispatch/approve
$curl -X POST https://api.runtype.com/v1/dispatch/approve \
> -H "Authorization: <apiKey>" \
> -H "Content-Type: application/json" \
> -d '{
> "approvalId": "appr_xyz789",
> "decision": "approved",
> "executionId": "exec_abc123def456",
> "reason": "Tool execution verified and safe to proceed",
> "streamResponse": true
>}'

Submits an approval decision for a paused execution awaiting human-in-the-loop approval.

Was this page helpful?
Previous

Continue a paused execution

Next
Built with

Authentication

AuthorizationBearer
API key or Clerk session token

Request

This endpoint expects an object.
approvalIdstringRequired>=1 character
decisionenumRequired
Allowed values:
executionIdstringRequired>=1 character
reasonstringOptional
streamResponsebooleanOptional

Response

Approval processed (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