{"uid":"cap_He8wXybLMigTUjkbNDHi0","slug":"dead-letter-audit-c3973ec0","name":"Dead Letter Audit","description":"Triage a dead letter queue. Groups entries by failure reason, names the dominant cause when one accounts for most of the queue, and separates retryable failures from permanent ones so you know whether replaying will work or fail again. Reports the same item failing more than once, and entries stating no reason at all, which cannot be triaged by anybody.","url":"https://api.zfinia.com/x402/v1/dead-letter-batch-audit?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"entries":{"type":"array","items":{"type":"object"},"maxItems":2000,"minItems":1},"id_field":{"type":"string","maxLength":256},"reason_field":{"type":"string","maxLength":256},"retryable_reasons":{"type":"array","items":{"type":"string","maxLength":256},"maxItems":100,"minItems":1}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.13","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.13/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.13","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.13","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_peif2emBsM1B2g1_FBaHQ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.13","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Triages a dead letter queue by grouping entries by failure reason, identifying dominant causes, separating retryable from permanent failures, and flagging duplicate failures and reason-less entries.","exampleAgentPrompt":"Can you triage my dead letter queue? Here are up to 2000 entries — the message ID is in the 'messageId' field, the failure reason is in 'errorReason', and retryable reasons include 'timeout' and 'throttled'. I want to know the dominant cause, what's safe to replay, and which entries have no reason at all.","exampleUseCases":[{"title":"Pre-replay DLQ safety check","prompt":"Before I replay my entire dead letter queue, can you audit these 850 entries for me? The ID field is 'msgId', the reason field is 'failureReason', and I consider 'TIMEOUT' and 'SERVICE_UNAVAILABLE' retryable. Tell me if replaying is safe or if most failures are permanent."},{"title":"Incident root cause triage","prompt":"We had a major event processing outage and now our DLQ has thousands of entries. Can you group these 1,500 dead letter messages by failure reason, name the dominant cause if one is responsible for most of them, and flag any that have no reason recorded? The ID field is 'eventId' and the reason field is 'error'."},{"title":"Routine DLQ health audit","prompt":"Run a weekly audit on my dead letter queue — here are 300 entries where the message ID is 'id' and the failure reason is 'dlqReason'. Retryable reasons are 'transient_error' and 'rate_limit'. Show me duplicates and anything with no reason so I know what needs manual investigation."}],"resultDescription":"Returns a structured breakdown of the dead letter queue: entries grouped by failure reason, identification of the dominant cause if one accounts for most of the queue, a split between retryable and permanent failures, a list of messages that failed more than once, and a list of entries with no failure reason that cannot be triaged.","failureModes":["Empty entries array or missing required fields returns validation error","id_field or reason_field referencing a non-existent property in entries yields empty or null groupings","retryable_reasons list not matching any actual reasons results in all failures classified as permanent","Entries array exceeding 2000 items rejected","Malformed entry objects may be skipped or cause partial results"],"whenToPreferThis":"Use this endpoint when you have a populated dead letter queue and need to decide whether to replay it, identify the root cause of failures, or separate actionable from unactionable entries before manual intervention. It is purpose-built for DLQ triage rather than general log analysis — prefer it over generic analytics tools when failure reason classification and retry-safety determination are the primary goals.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T18:39:59.739Z","isFirstParty":false,"canonicalSlug":"dead-letter-audit-c3973ec0"}