{"uid":"cap_ltoPYJxPA_oCwySuetpF7","slug":"x402-http-error-decoder-c77111e4","name":"x402/HTTP Error Decoder","description":"Decode any x402/HTTP error into structured recovery instructions. POST /decode-error {\"status\": 402} or {\"status\": \"timeout\"}. Returns meaning, action, retries, backoff, and fix.","url":"https://code-toll-production.up.railway.app/decode-error?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"properties":{}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_WMqbG_bMCZcNwTyvHY-aX","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Decodes x402 and HTTP error codes into structured recovery instructions including meaning, recommended action, retry strategy, backoff, and fix.","exampleAgentPrompt":"I got a 402 status code back from an API call — can you decode what that means and give me the exact steps to recover, including whether I should retry and how long to wait?","exampleUseCases":[{"title":"Recovering from x402 payment error","prompt":"My agent just hit a 402 error when calling a paid API endpoint. Can you decode that error and tell me what it means, what action to take, and whether I should retry?"},{"title":"Debugging a timeout in an agentic workflow","prompt":"One of my API calls came back with a timeout error and I'm not sure how to handle it. Can you decode that into structured recovery steps — what it means, how many times to retry, and what backoff to use?"},{"title":"Understanding x402 errors for agent error handling","prompt":"I'm building an agent that calls x402-gated APIs and I need to handle errors gracefully. Can you decode a 402 status and give me the meaning, action, retry count, backoff, and exact fix I should implement?"}],"resultDescription":"Returns a structured JSON object containing: the human-readable meaning of the error, a recommended action to take, retry count guidance, backoff strategy, and a concrete fix description to resolve the issue.","failureModes":["Missing or invalid status field returns a 400 bad request error","Unrecognized error codes may return a generic or null fix","Service unavailability on Railway hosting may cause 502/503 responses","Malformed JSON body causes parsing failure"],"whenToPreferThis":"Use this endpoint when your agent encounters x402 or HTTP errors and needs structured, actionable recovery instructions rather than raw documentation lookup. Especially valuable in agentic workflows using the x402 payment protocol where automated retry and backoff logic needs to be derived from error responses.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-24T12:32:22.679Z","isFirstParty":false,"canonicalSlug":"x402-http-error-decoder-c77111e4"}