Loading

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 }}