📬 Dead Letter Queue

Capture failed agent tasks, inspect error payloads, and retry via webhook.

Capture a Failure

curl -X POST https://www.agent-utils.com/api/dlq \

-H "x-api-key: au_your_key" \

-H "Content-Type: application/json" \

-d '{

"agentName": "email-agent",

"taskType": "send_email",

"payload": {"to": "user@example.com", "subject": "Welcome"},

"error": "SMTP timeout after 30s",

"retryWebhook": "https://myapp.com/api/retry"

# List all (paginated)

curl https://www.agent-utils.com/api/dlq \

-H "x-api-key: au_your_key"

# Filter by status

curl "https://www.agent-utils.com/api/dlq?status=pending" \

-H "x-api-key: au_your_key"

# Forward original payload to retry webhook

curl -X POST https://www.agent-utils.com/api/dlq/{id}/retry \

-H "x-api-key: au_your_key"

Param	Method	Type	Description
agentName	POST	string	Name of the agent that failed
taskType	POST	string	Type of task that failed
payload	POST	object	Original task input data
error	POST	string	Error message
retryWebhook	POST	string	URL to POST payload on retry
status	GET	query	Filter: pending, retried, resolved, dismissed
page / limit	GET	query	Pagination (default: page=1, limit=20)