Reliability of Failure Function

Understand how Upstash Workflow retries a failing failure function and how to inspect and rerun failed executions from the DLQ dashboard.

The failure function is executed whenever a workflow run fails.

In some cases, the failure function itself may throw an error. When this happens, it will be retried according to the workflow run’s retry configuration. If all retry attempts also fail, the failure function execution is marked as failed.

You can view and filter workflow runs with failed failure function executions in the DLQ dashboard.

You can filter DLQ entries by failure function state

From the DLQ dashboard, you can retry the failure function.

You can filter DLQ entries by failure function state

You can perform this action programmatically as well:

import { Client } from "@upstash/workflow";

const client = new Client({ token: "<QSTASH_TOKEN>" });

const response = await client.dlq.retryFailureFunction({
  dlqId: "dlq-12345" // The ID of the DLQ message to retry
});