Automation isn’t always a smooth process - sometimes workflows fail due to transient issues like temporary API outages, expired authentications, or incorrect input data. Keragon makes it easy to recover from these failures through both automatic retries and manual retry options.
Automatic Retry Mechanism
Keragon includes a built-in automatic retry system:
-
When a step in a workflow fails, Keragon automatically retries it up to 5 times before marking the workflow as failed.
-
These retries use the exact same inputs and configurations as the original attempt.
-
If all retries fail, the workflow will appear in the Runs page with a failed status, and you can proceed with manual recovery if needed.
Manually Retrying Failed Workflow Runs
if a workflow run still fails after the automatic retries, you can manually retry the failed run:
How to Retry a Failed Run
-
Navigate to the Runs page in your Keragon workspace.
-
Locate the failed workflow run.
-
Click the Retry button next to the failed run.
-
A new workflow run will be created and added to the Runs page.
✅ Important: The manual retry starts from the failed step only, using the current configuration of that step. Previous successful steps will not be re-executed.
When Can You Retry a Workflow Run?
-
The workflow must not have structural changes (e.g., no new steps added or existing steps deleted).
-
You can update the configuration of the failed step (e.g., authentication, input mappings, or fixed data).
-
If structural changes have been made, you’ll need to trigger the workflow from the beginning instead of using the retry function.
Example Use Case
-
A workflow failed while trying to send an email because the authentication token expired.
-
You update the authentication credentials in the failed step.
-
Click Retry—Keragon will retry the email step using the updated authentication without re-running earlier steps.