Resume Workflow Run
Resume a failed workflow run from where its left off
When a workflow run fails, it’s automatically moved to the DLQ (Dead Letter Queue) where it can be analyzed and resumed. The resume feature allows you to continue a failed workflow run from exactly where it failed, without re-executing successfully completed steps.
This is particularly useful for long-running workflows where you don’t want to lose progress from successful steps when a single step fails.
When you resume a workflow, a fresh workflow run is created to avoid mixing failed and successful run states. All data from successfully executed steps is maintained.
You can overwrite the workflow’s run ID, retries and flow control settings by passing the respective headers in the resume request.
You can make changes to the workflow code as long as these changes come after the failed steps. However, making changes before the failed step will break the code and is not allowed.
For more details, check out Handle workflow route code changes page.
Request
The ID of the DLQ message containing the failed workflow run
Optional. Overwrite the workflow run ID for the resumed workflow. If not provided, the original workflow run ID will be reused with a new timestamp.
Optional. Overwrite the flow control key for the resumed workflow. If not provided, the original workflow run configuration will be reused.
Optional. Overwrite the flow control values for the resumed workflow. If not provided, the original workflow run configuration will be reused.
Optional. Overwrite the retry configuration for the resumed workflow steps.
Response
The ID of the resumed workflow run
Unix timestamp when the resumed workflow run was created