execute_workflow - Calseta

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

Parameter	Type	Required	Description
`workflow_uuid`	string	Yes	UUID of the workflow to execute
`alert_uuid`	string	No	Alert context for the execution
`indicator_uuid`	string	No	Indicator context for the execution
`reason`	string	Yes	Why the agent wants to execute this workflow
`confidence`	float	Yes	Agent’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