📬 Dead Letter Queue

Dead Letter Queue for AI Agents

Catch failed tasks. Inspect payloads. Retry with one click.

What it does

When an agent task fails, catch the error payload and original input in a dead letter queue. Inspect failures, debug payloads, and retry.

Why agents need this

Get started in 30 seconds

One API call. No SDK. No configuration.

cURL

curl -X POST https://www.agent-utils.com/v1/dlq \
  -H "x-agent-id: data-pipeline" -H "x-api-key: agutil_agt_…" \
  -H "content-type: application/json" \
  -d '{
    "payload": {"fileId": "abc123", "rows": 5000},
    "error": "Column count mismatch: expected 12, got 15"
  }'

Python

import requests

resp = requests.post(
    "https://www.agent-utils.com/v1/dlq",
    headers={
        "x-agent-id": "data-pipeline",
        "x-api-key": "agutil_agt_…",
        "content-type": "application/json",
    },
    json={
        "payload": {"fileId": "abc123", "rows": 5000},
        "error": "Column count mismatch: expected 12, got 15",
    },
)
dlq_id = resp.json()["data"]["id"]

JavaScript

const res = await fetch("https://www.agent-utils.com/v1/dlq", {
  method: "POST",
  headers: {
    "x-agent-id": "data-pipeline",
    "x-api-key": "agutil_agt_…",
    "content-type": "application/json",
  },
  body: JSON.stringify({
    payload: { fileId: "abc123", rows: 5000 },
    error: "Column count mismatch: expected 12, got 15",
  }),
});

Use cases

API call failures

Agent calls an external API that returns 500 and captures the request plus error for retry

Data validation errors

Agent output fails downstream validation and is saved for human review

Timeout recovery

Long-running agent task times out and partial state is captured for resumption

Multi-step pipeline failures

Step 3 of 5 fails and the exact input plus error is captured for targeted retry

AgentUtils vs. alternatives

Traditional tools like AWS SQS DLQ, RabbitMQ Dead Letter, Apache Kafka DLQ require SDK integration, credential management, and infrastructure setup. AgentUtils replaces all of that with a single HTTP call.

AgentUtilsAlternatives
Setup time30 secondsHours to days
SDK requiredNo (REST API)Yes
Credentials to manage1 API keyMultiple keys/tokens
InfrastructureZero-configProvision + configure

Related tools

All AgentUtils tools

Start building for free

500 free API calls per month. No credit card required.