{"uid":"cap_C4YBoRLhtbuSMVzJWKndI","slug":"dev-reference-http-method-lookup-0daa6a8c","name":"Dev Reference: HTTP Method Lookup","description":"Whether an HTTP method is safe and idempotent (IANA registry), what it is for, and request-body semantics.","url":"https://dev-reference.x402tookit.com/http-method?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["method"],"properties":{"method":{"type":"string","description":"Method name such as GET, PATCH or PROPFIND"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"asOf":{"type":["null","string"]},"safe":{"type":["boolean","null"]},"method":{"type":["null","string"]},"source":{"type":["null","string"]},"purpose":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"summary":{"type":["null","string"]},"verdict":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"reference":{"type":["null","string"]},"disclaimer":{"type":["null","string"]},"idempotent":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"registered":{"type":["boolean","null"]},"bodySemantics":{"type":["null","string"]},"cacheableByDefault":{"type":["boolean","null"]}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_so7ysG47yGxdOOujnJBmQ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns whether an HTTP method is safe and idempotent per IANA registry, its purpose, and request-body semantics.","exampleAgentPrompt":"Is the PATCH HTTP method safe and idempotent, and can it include a request body? I want to know what IANA says about it.","exampleUseCases":[{"title":"Verify idempotency before retry logic","prompt":"I'm building a retry handler and need to know whether PUT is idempotent according to IANA — also tell me if it allows a request body."},{"title":"Explain PROPFIND to a junior developer","prompt":"Can you look up the PROPFIND HTTP method and explain what it's for, whether it's safe, and what the deal is with sending a body with it?"},{"title":"Audit custom HTTP method usage","prompt":"We're using PATCH in our API and someone asked if it's safe to call multiple times without side effects — can you check whether PATCH is safe and idempotent per the IANA registry?"}],"resultDescription":"Returns a structured object containing: whether the method is registered with IANA, whether it is safe, whether it is idempotent, whether responses are cacheable by default, the method's purpose, body semantics (allowed/forbidden/meaningful), a summary explanation, reasons for the verdict, a reference URL, and a disclaimer about degraded data if applicable.","failureModes":["Unknown or unregistered HTTP method returns registered=false with null safety/idempotency fields","Misspelled method name returns no match or degraded result","IANA registry temporarily unavailable may return degraded=true with stale data","Missing required 'method' query parameter results in an error response"],"whenToPreferThis":"Use this endpoint when an agent or developer needs authoritative, IANA-grounded information about an HTTP method's safety, idempotency, or body semantics — especially for non-standard methods like PROPFIND, REPORT, or LOCK. Prefer it over general LLM knowledge when accuracy and a citable reference are important.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T13:11:15.247Z","isFirstParty":false,"canonicalSlug":"dev-reference-http-method-lookup-0daa6a8c"}