geni workflow preview-filter
Test a published or local filter without running the workflow body.
geni workflow preview-filter [id] --payload '{"total":500}' --trigger incoming-order
geni workflow preview-filter [id] --draft --dir ./my-workflow --payload '{}'Runs filter.ts once and returns its skip or run decision, reason, transformed input, trigger identity and logs. The published filter is used by default; --draft uploads the local directory and previews it before publishing. Credentials and consts come from the saved workflow's config.
Published previews require run access. Draft previews require edit access.
This uses live credentials, databases and stores. Dedup state written by the filter persists, so the second preview can return a different decision. The workflow body does not run.
| Flag | Purpose |
|---|---|
--payload <json> | Event JSON object; defaults to {}. |
--trigger <key> | Trigger node id from workflow.json. Select it for a workflow with multiple triggers. |
--draft | Preview local files rather than the published filter. |
--dir <path> | Directory for id resolution and local files. Defaults to cwd. |
--json | Machine-readable output. |
A preview that cannot reach a decision exits with code 9. After a run decision, pass its returned input to geni workflow test; if input is omitted, use the original payload. Manual tests exercise the body and bypass the filter.