# Live trigger operations

> Inspect polling activity and captured events, sync sources, and replay an event.

Source: https://docs.generalinput.com/cli/resource/workflow/trigger-activity



```sh
geni workflow trigger-activity wf_123 --limit 20 --json
geni workflow trigger-activity wf_123 --cursor "2026-09-22T12:00:00Z"
geni workflow trigger-sync wf_123
geni workflow trigger-sync wf_123 --trigger-id trig_123
geni workflow trigger-replay item_123 --kind poll_item --workflow wf_123 --trigger incoming-mail
```

`trigger-activity` returns poll source state and errors, recent filter decisions, and captured event payloads. `--limit` accepts 1–100 rows per source/page; the default is 20. Use the returned captured-event `cursor` for the next page. `--search <text>` filters captured events.

`trigger-sync` polls active sources immediately. New records may trigger real workflow executions. Use a trigger **row id** from the activity response to sync one source; omit `--trigger-id` for all active sources. Paused sources remain paused.

`trigger-replay` starts a real execution from a captured item, preserving its payload and source trigger. Supply the `id` and `kind` (`poll_item` or `execution`) returned by `trigger-activity`. If multiple workflow triggers share that poll source, `--trigger` selects the node id from `workflow.json`. Replaying can repeat external actions.

All commands accept `--dir <path>` for resource id resolution and `--json`. Activity and sync take an optional workflow id positional; replay takes `--workflow <id>`. Read access permits inspection, edit access permits sync, and run access permits replay.