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.
The following example shows the basic syntax for a manual trigger:
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 external systems
Manual triggers can accept input parameters that are available throughout the workflow execution. Define inputs at the workflow level to prompt users for 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 }}