{"uid":"cap_hG0k02oWSTlQFmWBF4BjW","slug":"delx-idempotency-key-1757666d","name":"Delx Idempotency Key","description":"Derive a deterministic namespaced idempotency key from canonical JSON. Use it before an autonomous workflow acts on untrusted input, changes an API, retries a request, or evaluates production reliability. Returns bounded machine-readable JSON for $0.002 USDC via x402 on Base. Execution is deterministic, first-party, local-only, stateless, and does not call an upstream provider; structured validation failures are not billed.","url":"https://api.delx.ai/api/v1/x402/idempotency-key","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"payload":{"description":"JSON value whose canonical representation identifies one logical operation."},"namespace":{"type":"string","default":"default","maxLength":200}}},"responseSchema":{"type":"json","example":{"key":"delx_ca094a4752e182cfcac50a38d65de7c7e4f271ee05c08f26853c75f0ba24b049","schema":"delx/idempotency-key/v1","algorithm":"sha256","namespace":"default","payload_sha256":"f85c6736261be7d990522f91e81634f844ad23c515f3b4029e197ab01a2d18dc"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_jUckdN-SryIoc7cplGYPD","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Derives a deterministic, namespaced idempotency key from canonical JSON to prevent duplicate operations in autonomous workflows.","exampleAgentPrompt":"Before retrying my payment API call, derive a deterministic idempotency key from this JSON payload in the 'payments' namespace: {\"userId\":\"u_123\",\"amount\":50,\"currency\":\"USD\"}.","exampleUseCases":[{"title":"Safe retry before payment API call","prompt":"I'm about to retry a payment request and need a deterministic idempotency key — derive one from this payload in the 'payments' namespace: {\"userId\":\"u_456\",\"amount\":99.99,\"currency\":\"USD\"} so I don't accidentally charge twice."},{"title":"Deduplicating autonomous workflow actions","prompt":"My agent is about to act on untrusted input and I need to make sure it doesn't run the same operation twice — can you compute an idempotency key for this action payload in the 'workflow' namespace: {\"action\":\"send_email\",\"to\":\"alice@example.com\",\"templateId\":\"onboarding-v2\"}?"},{"title":"Stable key for distributed API state","prompt":"Generate a namespaced idempotency key from this JSON under the 'orders' namespace: {\"orderId\":\"ord_789\",\"items\":[\"sku_a\",\"sku_b\"],\"quantity\":3} — I need the same input to always produce the same key across retries."}],"resultDescription":"Returns a bounded machine-readable JSON object containing the deterministic, namespaced idempotency key derived from the canonical representation of the input JSON payload. Structured validation failures are returned as non-billed error responses.","failureModes":["Invalid or non-serializable payload — returns structured validation error without billing","Namespace exceeds 200 character limit — returns validation error","Malformed JSON input — structured error returned, no charge incurred","Payment failure via x402 — request not processed"],"whenToPreferThis":"Choose this endpoint when you need a fully deterministic, reproducible idempotency key derived from a JSON payload without any external state or upstream provider calls. It is ideal for autonomous agents that must deduplicate actions before retrying requests, acting on untrusted input, or calling state-changing APIs. Prefer it over rolling your own hashing logic when you need a namespaced, canonical, and billing-safe key derivation with structured error responses.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T19:02:10.346Z","isFirstParty":false}