Skip to content
ajan.io

Docs menu

On this page

Delay

Add a pause to your workflow execution between 1 second and 24 hours.

Overview

The Delay node pauses workflow execution for a specified duration. All subsequent nodes wait until the delay period completes before continuing. Perfect for polling, waiting for external processes, rate limiting, or implementing retry logic.

Configuration

Delay Duration: Set the pause time between 1 second and 24 hours (default: 5 seconds)

Options:

  • Seconds (1-86400)
  • Minutes (1-1440)
  • Hours (1-24)

When to Use Delay

Perfect for:

  • Polling an API until a process completes
  • Waiting for external systems to process data
  • Rate limiting to avoid API throttling
  • Adding retry delays after errors
  • Scheduling follow-up actions
  • Implementing exponential backoff

Not ideal for:

  • Long-term scheduling (use Scheduled Trigger instead)
  • Delays longer than 24 hours
  • Time-based triggers (use Scheduled Trigger)

Example Use Cases

Retry with Backoff

text
HTTP Request: Call API
β†’ [On Error] β†’ Delay: 5 seconds
β†’ HTTP Request: Retry API call
β†’ [On Error] β†’ Delay: 15 seconds
β†’ HTTP Request: Final retry

Waiting for Processing

text
Action: Submit document for processing
β†’ Delay: 1 minute
β†’ HTTP Request: Fetch processed document
β†’ Agent: Analyze results

How It Works

  1. Workflow reaches the Delay node
  2. Execution pauses for the specified duration
  3. After the delay, workflow continues to the next node
  4. All subsequent nodes wait for the delay to complete

Use with Loops

Delays are especially useful inside loops to control execution rate:

text
Loop: Process 100 items
  Variable: item

  β†’ HTTP Request: Process {{item.id}}
  β†’ Delay: 1 second  (prevents rate limiting)

Without delay: 100 API calls in \~10 seconds (may hit rate limits)\ With 1-second delay: 100 API calls in \~100 seconds (stays under limits)

Limitations

  • Minimum delay: 1 second
  • Maximum delay: 24 hours
  • No cancellation: Once a delay starts, it cannot be interrupted
  • Workflow must stay active: The workflow continues running during the delay

Cost Considerations

Delays themselves are free, but:

  • Workflow execution time includes the delay period
  • Long delays keep the workflow "running"
  • Consider if a scheduled workflow restart would be more efficient

Best Practices

Long delays keep workflows running and can impact costs. Use Scheduled Triggers for delays over a few hours.

Workflows have execution time limits. Very long delays may cause the workflow to timeout.

Start with shorter delays and increase gradually if needed. Don't poll more frequently than necessary.

Add a comment to the delay node explaining why the pause is needed - your future self will thank you.

Next Steps