Skip to main content

Running Workflows

Once you've set up a project with a team, agents, and a workflow, you're ready to execute it.

Manual Execution​

Open a workflow and click Run. This creates a new Workflow Run and starts execution immediately.

The run page shows:

  • Overall status — pending, running, completed, stopped, or error.
  • Stage progress — which stage is currently executing and which have completed.
  • Stage results — the output from each stage as it completes.
  • Timing — when the run started, how long each stage took.

Scheduled Execution​

Use Triggers to run workflows automatically:

  1. Open a workflow and create a new trigger.
  2. Define a schedule — natural language ("every Monday at 9am EST") or cron expression.
  3. Set a timezone and optional start/end dates.
  4. The workflow runs automatically on schedule.

Use Fire Now to trigger a scheduled workflow immediately without waiting for the next scheduled time.

External Triggers​

Workflows can be triggered programmatically via the API:

POST /api/v1/trigger

This lets external systems — CI/CD pipelines, monitoring alerts, other applications — kick off workflows on demand. See API for details.

Monitoring Runs​

Browse all runs for a project from the project page, or filter by workflow. Each run is a complete record of the execution — status, timing, and per-stage results.

Runs in an error state show which stage failed and the error details, helping you diagnose and fix issues.

Stopping a Run​

Running workflows can be stopped from the run detail page. This halts execution at the current stage.