---
title: argusctl dlq
description: Incident-webhook dead-letter queue: list failed deliveries, re-arm a row for retry.
---

# argusctl dlq



{/* AUTO-GENERATED by scripts/generate-cli-reference.mjs from `argusctl introspect --json`.
    Do not edit by hand. Regenerate with: pnpm generate:cli */}

> Generated from argusctl v0.1.0 on 2026-06-09. Run `argusctl introspect --json` for the machine-readable tree.

## `argusctl dlq`

Incident-webhook dead-letter queue: list failed deliveries, re-arm a row for retry.

```bash
argusctl dlq <subcommand>
```

### `argusctl dlq ls`

List webhook DLQ rows. --status filters pending | delivered | abandoned (default: all).

```bash
argusctl dlq ls [options]
```

| Option             | Description                               |
| ------------------ | ----------------------------------------- |
| `--status <state>` | filter: pending \| delivered \| abandoned |
| `--limit <n>`      | max rows (1-500)                          |
| `--offset <n>`     | pagination offset                         |
| `--api <url>`      | API base URL                              |
| `--token <pat>`    | PAT to use                                |
| `--json`           | JSON output                               |
| `--fields <list>`  | comma-separated fields to include         |

### `argusctl dlq retry`

Re-arm a DLQ row (next\_retry\_at=now, clears abandoned). Re-arms only: the drainer must run to re-deliver.

```bash
argusctl dlq retry <id> [options]
```

| Argument | Required |
| -------- | -------- |
| `id`     | yes      |

| Option            | Description                               |
| ----------------- | ----------------------------------------- |
| `--dry-run`       | print the planned call without sending it |
| `--api <url>`     | API base URL                              |
| `--token <pat>`   | PAT to use                                |
| `--json`          | JSON output                               |
| `--fields <list>` | comma-separated fields to include         |

## Examples

```bash
argusctl dlq ls --status pending
argusctl dlq retry <id>
```


---

For a semantic overview of all documentation, see [/sitemap.md](/sitemap.md)

For an index of all available documentation, see [/llms.txt](/llms.txt)

For agent-facing discovery, including API and MCP surfaces, see [/agents.md](/agents.md)