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

FieldDescriptionExample
Timer IDUnique identifier of scheduled event to cancel (must match ID from Run later){{scheduleTimerId}}

Exit Points

ExitWhen
PassAlways (stage cannot fail - succeeds even if schedule not found)

How It Works

When executed, the stage:

  1. Resolves Timer ID - Evaluates the schedule ID variable from flow
  2. Appends operator ID - Constructs full key with operator isolation
  3. Deletes schedule - Removes scheduled event from queue
  4. 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)

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)

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

Was this article helpful?