Evidence artifact · rollback trigger matrix
A rollback plan belongs before cutover.
“We can switch it back if something breaks” is not a rollback plan. A usable plan names the source state to preserve, the triggers that stop the cutover, the switching order, the owner, and the evidence that proves recovery.
The matrix below is a synthetic example. Actual triggers and actions are scoped per workflow.
Rollback trigger matrix
Decide in advance what makes “go back” the correct action.
| Observed condition | Decision | Way-back action | Evidence after recovery |
|---|---|---|---|
| Blocking parity case fails | Do not cut over | Keep source as production owner; fix candidate | Source still handles accepted traffic |
| Missing or duplicate business write | Stop / rollback | Return ownership to preserved source path | Counts and affected records reconciled |
| Critical destination API failure beyond threshold | Rollback if threshold is breached | Restore source routing in documented order | Expected source executions resume |
| Intentional difference is not approved | No-go | Keep candidate inactive | Gap remains explicit and unresolved |
Minimum rollback packet
What remains available, what is frozen, and what must not be deleted or downgraded yet.
Which platform owns triggers, webhooks, schedules and writes before, during and after cutover.
The exact dependency order for redirecting traffic and restoring the source path.
The observable facts that prove the source path is safely handling production again.
Reversible cutover sequence
Record the exact n8n version/configuration and unresolved gaps.
Source path, trigger ownership, credentials and recovery checks are still available as planned.
Production changes happen only after the acceptance evidence is reviewed.
Use the agreed monitoring signals and rollback triggers, not intuition.
Only after the replacement is accepted and the business chooses to retire the source path.
Related evidence
Know the way back first
Check whether a reversible migration is realistic for your workflow.
The Fit Check is free and comes before paid work or production credential handling.