Skip to main content

​
execute_workflow

Triggers execution of a workflow. When the workflow has approval_mode set to "always" or "agent_only", creates a pending approval request instead of executing immediately.

​
Parameters

ParameterTypeRequiredDescription
workflow_uuidstringYesUUID of the workflow to execute
alert_uuidstringNoAlert context for the execution
indicator_uuidstringNoIndicator context for the execution
reasonstringYesWhy the agent wants to execute this workflow
confidencefloatYesAgent’s confidence score (0.0 to 1.0)
MCP tool calls are always treated as trigger_source: agent. The reason and confidence fields are required because the approval gate needs this context to present to human reviewers.

​
Return Value

{
  "status": "queued",
  "workflow_run_uuid": "run-xyz789-..."
}
Or, if approval is required: 
{
  "status": "pending_approval",
  "approval_request_uuid": "apr-abc123-...",
  "expires_at": "2025-01-15T11:00:00Z"
}

​
Required Scope

workflows:execute