Manual triggers
Manual triggers run workflows on-demand through the UI or API. They require explicit user action to start a workflow. Use manual triggers for testing, one-off tasks, administrative actions, or workflows that require a human decision to start.
To define a manual trigger, use the following syntax:
triggers:
- type: manual
This allows you to run a workflow manually by:
- Clicking Run in the Workflows UI
- Calling the workflow execution API, either directly or from an external system
Manual triggers can accept input parameters, which you can reference in any step. When you define inputs at the workflow level, users are prompted to provide values when they run the workflow.
name: Manual Processing Workflow
inputs:
- name: environment
type: string
required: true
default: "staging"
description: "Target environment for processing"
- name: batchSize
type: number
required: false
default: 100
description: "Number of records to process"
- name: dryRun
type: boolean
required: false
default: true
description: "Run in test mode without making changes"
triggers:
- type: manual
steps:
- name: validateInputs
type: console
with:
message: |
Starting workflow with:
- Environment: {{ inputs.environment }}
- Batch Size: {{ inputs.batchSize }}
- Dry Run: {{ inputs.dryRun }}