drop
Remove a record from the chain entirely.
The drop filter discards every record it sees. It has no options.
It's almost always placed inside a condition branch — the condition
selects which records get dropped.
Minimal example
Drop cancelled orders:
filters:
- type: condition
expression: "status == 'cancelled'"
then:
- type: dropHow "drop" differs from remove
| Filter | What it drops |
|---|---|
drop | The whole record. Downstream stages never see it. |
remove | One or more fields from the record. The record itself continues. |
They're complementary, not interchangeable.
When to use it alone
Putting drop outside a condition is technically valid — it'll drop
every record. That's a useful debugging shortcut for "execute the
input and filters but produce no output", but it's mostly equivalent
to --dry-run (which also avoids the network round-trip on the output
side).
filters:
- type: drop # nothing reaches the outputFor production use, always pair drop with a condition.