{"uid":"cap_jGyYEN55UuRLYAgw6ZsOL","slug":"event-idempotency-audit-6b2fcb3c","name":"Event Idempotency Audit","description":"Find out whether a batch can be deduplicated. Reports events carrying no id at all, ids that repeat with an identical payload - a redelivery a consumer must be idempotent about - and, separately, ids that repeat with a different payload, which means the id is not identifying the event. Volatile fields such as a delivery timestamp can be excluded from the comparison without being excluded from the duplicate detection.","url":"https://api.zfinia.com/x402/v1/event-idempotency-audit?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"events":{"type":"array","items":{"type":"object"},"maxItems":2000,"minItems":1},"id_field":{"type":"string","maxLength":256},"ignore_pointers":{"type":"array","items":{"type":"string","maxLength":512},"maxItems":100,"minItems":1}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.11","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.11/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.11","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.11","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_8dBAJ-XsnLE_Bk1s7Solv","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.11","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Analyzes a batch of events to identify missing IDs, duplicate IDs with identical payloads (redeliveries), and duplicate IDs with different payloads (ID collisions).","exampleAgentPrompt":"Can you audit this batch of webhook events for idempotency issues? Use 'event_id' as the ID field, and ignore the 'delivered_at' timestamp when comparing payloads for duplicates.","exampleUseCases":[{"title":"Webhook redelivery detection before processing","prompt":"I have a batch of up to 500 webhook events I'm about to process — can you check them for idempotency problems using 'id' as the ID field, ignoring the 'timestamp' field so transient delivery metadata doesn't count as a difference?"},{"title":"Kafka consumer deduplication audit","prompt":"Here's a batch of Kafka messages I pulled from a topic — audit them for duplicate event IDs using 'messageId' as the ID field, and tell me which ones are true redeliveries versus which ones have conflicting payloads for the same ID."},{"title":"Event pipeline quality check for missing IDs","prompt":"Before I replay these 1200 events into our pipeline, check them for any events that are missing an 'event_id' field entirely, plus flag any ID collisions where the same ID appears with different payloads."}],"resultDescription":"Returns a structured report categorizing events into three groups: events with no ID in the specified field, events whose ID repeats with an identical payload (safe redeliveries requiring consumer idempotency), and events whose ID repeats with a different payload (ID collision — the ID is not uniquely identifying the event). Volatile fields specified via JSON Pointer paths are excluded from payload comparison but not from duplicate detection.","failureModes":["Batch exceeds 2000 events — request rejected","id_field not found in any event — may return all events as missing IDs","Invalid JSON Pointer syntax in ignore_pointers — request rejected or pointers silently ignored","Empty events array — rejected due to minItems constraint","Payment failure or insufficient USDC balance — 402 response before processing"],"whenToPreferThis":"Choose this endpoint when you need to programmatically classify idempotency issues in a batch of events before processing or replaying them, especially when you want to distinguish true redeliveries from ID collision bugs. It is more nuanced than a simple deduplication step because it separately identifies missing IDs, safe redeliveries, and unsafe ID reuse — and allows you to exclude volatile delivery metadata fields from payload comparison without removing them from duplicate detection altogether.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T18:38:23.802Z","isFirstParty":false,"canonicalSlug":"event-idempotency-audit-6b2fcb3c"}