akili dlq

Manage the dead letter queue (DLQ). When data product executions fail, the failed records are sent to the DLQ for inspection and replay. Use these commands to diagnose failures, replay individual or batches of entries, and purge old entries.

Commands

akili dlq list

List DLQ entries, optionally filtered by product.

Flags:

Flag	Short	Default	Description
--product			Filter by product name or ID

Examples:

# List all DLQ entries for the tenant
akili dlq list

# Filter by product
akili dlq list --product daily-orders

# As JSON
akili dlq list --json

---

akili dlq get <id>

Inspect a single DLQ entry with full details including the error message, payload, and replay count.

Arguments:

Argument	Type	Required	Description
id	string	yes	DLQ entry ID

Examples:

# Inspect a DLQ entry
akili dlq get dlq-abc-123

# As JSON to see full payload
akili dlq get dlq-abc-123 --json

---

akili dlq replay <id>

Replay a single DLQ entry, re-executing the failed record.

Arguments:

Argument	Type	Required	Description
id	string	yes	DLQ entry ID

Flags:

Flag	Short	Default	Description
--use-current-version		false	Replay using the current product version instead of the original

Examples:

# Replay a DLQ entry with original version
akili dlq replay dlq-abc-123

# Replay using the latest product version
akili dlq replay dlq-abc-123 --use-current-version

---

akili dlq replay-batch

Replay multiple DLQ entries in a single operation.

Flags:

Flag	Short	Default	Description
--ids			Comma-separated list of DLQ entry IDs (required)
--use-current-version		false	Replay using the current product version

Examples:

# Replay multiple entries
akili dlq replay-batch --ids dlq-abc-123,dlq-def-456,dlq-ghi-789

# Replay with current version
akili dlq replay-batch --ids dlq-abc-123,dlq-def-456 --use-current-version

---

akili dlq purge <id>

Purge (permanently delete) a single DLQ entry.

Arguments:

Argument	Type	Required	Description
id	string	yes	DLQ entry ID

Examples:

# Purge a single entry
akili dlq purge dlq-abc-123

---

akili dlq purge-all

Bulk purge DLQ entries older than a specified number of days. Requires the --confirm flag.

Flags:

Flag	Short	Default	Description
--older-than-days			Purge entries older than this many days (required)
--confirm		false	Confirm the bulk purge (required)

Examples:

# Purge entries older than 30 days
akili dlq purge-all --older-than-days 30 --confirm

# Without --confirm, the command will fail:
akili dlq purge-all --older-than-days 30
# ERROR: Use --confirm to purge DLQ entries older than 30 days