Triggers, cron, and timezone

Workflows run when a trigger fires. You can start them from external events, on a schedule, or by hand.

Event types

• push — A commit was pushed to a linked repository.
• pull_request — A pull or merge request was opened, updated, or merged.
• issue — An issue or ticket was created or updated in a linked provider.
• cron — A time-based schedule fired.
• manual — A user clicked Run in the Evolve UI.

Condition operators

Add conditions to a trigger so the workflow only runs when the payload matches. Supported operators include:

• equals — event.action == 'opened'
• contains — event.branch contains 'main'
• startsWith — event.branch startsWith 'release/'
• matches — event.title matches '.*urgent.*'

Cron schedules

Cron triggers use standard five-field expressions. The timezone is set per trigger and must be a valid IANA timezone such as America/New_York or UTC.

Examples: 0 9 * * 1 runs at 9 a.m. every Monday. */15 * * * * runs every 15 minutes.

Preview your schedule

In the workflow builder, the cron editor calls the preview endpoint to show the next five fire times before you save. If the expression or timezone is invalid, the save returns a 400 with the reason instead of silently failing.