Cancel run later
Overview
Cancel run later deletes a previously scheduled event by its unique key. Use this stage to prevent a scheduled task from running after it's been queued with Run later.
Configuration
Required Fields
| Field | Description | Example |
|---|---|---|
| Timer ID | Unique identifier of scheduled event to cancel (must match ID from Run later) | {{scheduleTimerId}} |
Exit Points
| Exit | When |
|---|---|
| Pass | Always (stage cannot fail - succeeds even if schedule not found) |
How It Works
When executed, the stage:
- Resolves Timer ID - Evaluates the schedule ID variable from flow
- Appends operator ID - Constructs full key with operator isolation
- Deletes schedule - Removes scheduled event from queue
- Returns success - Always routes to Pass (even if nothing was deleted)
Key behavior: Always succeeds even if schedule not found - idempotent operation.
Common Use Cases
1. Order Cancellation with Schedule Cleanup
Cancel order and prevent scheduled processing.
- Update database: Mark order cancelled
- Cancel run later: {{preventscheduleTimerId}} (prevent auto-processing)
- Add To Response:
orderStatusβcancelled - Return true
Result: Order cancelled + scheduled processing prevented.
2. Conditional Cancellation
Only cancel if status indicates cancellation.
- Route Flow: {{status}} Equal
cancelled- Pass:
- Cancel run later: {{scheduleTimerId}}
- Return true
- Fail: Return true (no cancellation needed)
- Pass:
Result: Only cancel if status is marked cancelled.
3. Retry Schedule Cleanup
Cancel future retries if current attempt succeeds.
- Call API: {{Retry}} (retry attempt)
- Route Flow: {{success}} Equal
true- Pass:
- Cancel run later: {{retryneeded}} (no more retries needed)
- Return true
- Fail: Return false (retry will happen as scheduled)
- Pass:
Result: Cancel future retries if current attempt succeeds.
Related Stages
- Run later: Creates the scheduled event that this stage cancels
- Save Data: Store Timer ID for later cancellation
- Fetch Data: Retrieve Timer ID when ready to cancel
- Route Flow: Add conditional logic before cancellation