> ## Documentation Index
> Fetch the complete documentation index at: https://docs.encoreos.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Dead Letter Queue

> Inspect, retry, and discard failed automation executions held in the dead letter queue at /fw/dead-letter-queue.

The Dead Letter Queue screen lists failed automation executions with actions to retry or discard them and is available at `/fw/dead-letter-queue`.

## Overview

This admin screen loads failed execution entries via `useDeadLetterQueue` with filter support (`DLQFilters`). A stats bar (`DLQStatsBar`) shows summary counts by status. Entries have statuses of `pending`, `retried`, `resolved`, or `discarded`. Per-entry and bulk actions (retry and discard) are available. Individual retry and discard use `useDLQRetry` and `useDLQDiscard`; bulk operations use `useDLQBulkRetry` and `useDLQBulkDiscard`. Retry and discard confirmations are presented in dialogs (`DLQRetryDialog`, `DLQDiscardDialog`). Expanding a row opens a detail panel (`DLQDetailPanel`).

## Who it's for

Requires permission: `fw.dead-letter-queue.view` (`FW_PERMISSIONS.DEAD_LETTER_QUEUE_VIEW`). Retry requires `fw.dead-letter-queue.retry`. Discard requires `fw.dead-letter-queue.discard`.

## Before you start

* Hold `fw.dead-letter-queue.view` to access this screen.
* Hold `fw.dead-letter-queue.retry` to retry entries.
* Hold `fw.dead-letter-queue.discard` to discard entries.

## Steps

<Steps>
  <Step title="Open the Dead Letter Queue">Navigate to `/fw/dead-letter-queue`.</Step>
  <Step title="Filter entries">Use `DLQFilters` to narrow by status, automation, or date.</Step>
  <Step title="Expand an entry">Click a row to open `DLQDetailPanel` and inspect the failure details.</Step>
  <Step title="Retry a single entry">Click the retry button on a row and confirm in `DLQRetryDialog`.</Step>
  <Step title="Discard a single entry">Click the discard button and confirm in `DLQDiscardDialog`.</Step>
  <Step title="Bulk retry or discard">Select multiple rows with checkboxes and use the bulk action buttons.</Step>
</Steps>

## Key concepts

* **Dead letter queue** — a holding area for automation executions that failed all retry attempts.
* **DLQ entry statuses** — `pending` (not yet retried), `retried`, `resolved` (succeeded on retry), `discarded`.

## Related

<Columns cols={2}>
  <Card title="Forms & Workflow" icon="diagram-project" href="/fw/overview">
    Forms & Workflow core overview.
  </Card>

  <Card title="Governance & parity" icon="scale-balanced" href="/governance/index">
    Documentation coverage and governance.
  </Card>
</Columns>

<Note>
  This page documents shipped product behavior. It is not medical, legal, or
  billing advice. Verify against your organization's policies and applicable
  regulations before using it for clinical, compliance, or billing decisions.
  Protected health information (PHI) shown in the product is governed by your
  tenant's access controls and is never exposed in this documentation.
</Note>

<Accordion title="Documentation sources">
  * src/routes/fw\.tsx
  * src/cores/fw/pages/DeadLetterQueuePage.tsx
  * src/platform/permissions/constants.ts
</Accordion>