Kylon Developer Docs

This walkthrough builds a workflow that reacts to row changes. Use a workflow — not a follow-up — whenever the automation is recurring, triggered, or reusable. Full flags are in the workflow reference.

1. Create the workflow

kylon workspace workflow create \
  --scope-workspace <workspace_id> \
  --scope-channel <channel_id> \
  --name "Escalate P0 rows" ...

2. Wire the trigger

Workflows can run on a schedule, on inbound webhooks, or on row changes. For a row-change trigger, point it at the table whose rows should start a run.

3. Trigger and inspect

Run it manually to verify, then inspect the run:

kylon workspace workflow trigger <workflow_id>
kylon workspace workflow list --scope-channel <channel_id>

Each run produces a durable, inspectable record. Pause, resume, or archive the workflow with the same subcommand.

When not to use a workflow

If you only need to remind or check back once, create a follow-up instead — do not stand up a workflow for a one-shot ping.