{"uid":"cap_wy6I93Sda50XaD4TRUbF7","slug":"saylor-innovations-guide-library-cloudflare-tunnel-troubleshooting-07dc35ba","name":"Saylor Innovations Guide Library – Cloudflare Tunnel Troubleshooting","description":"Troubleshoot Cloudflare Tunnel - 1033 and 502 causes, ingress rules, Docker localhost trap, CNAME to cfargotunnel, token vs credentials","url":"https://saylorinnovations.com/api/kb/cloudflare-tunnel-troubleshooting?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"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string","const":"json"},"example":{"type":"object","required":["id","t","c","body"],"properties":{"c":{"type":"string","description":"Category of the guide"},"t":{"type":"string","description":"Title of the guide"},"id":{"type":"string","description":"Identifier of the record"},"body":{"type":"string","description":"Main body text"},"price":{"type":["number","null"],"description":"Price"},"license":{"type":"string","description":"License identifier"}}}}}}},"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_yzGwoUG9uUppeM6LmVQ1z","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":"Returns a structured knowledge-base guide covering Cloudflare Tunnel error codes (1033, 502), ingress rule configuration, Docker localhost pitfalls, CNAME setup for cfargotunnel, and token vs credentials file differences.","exampleAgentPrompt":"I'm getting a 1033 error and sometimes a 502 from my Cloudflare Tunnel — can you pull up the troubleshooting guide that covers ingress rules, the Docker localhost trap, CNAME setup for cfargotunnel, and the difference between token and credentials file?","exampleUseCases":[{"title":"Fixing Cloudflare Tunnel 1033 error","prompt":"My Cloudflare Tunnel is throwing a 1033 error and I can't figure out why — can you get me the guide explaining what causes 1033 and how to fix it?"},{"title":"Docker localhost pitfall in Cloudflare Tunnel","prompt":"I set up a Cloudflare Tunnel in Docker but my service isn't reachable — I think it's something to do with using localhost inside the container. Can you fetch the guide that explains the Docker localhost trap and how to configure it correctly?"},{"title":"CNAME and credentials vs token setup","prompt":"I need to understand whether to use a tunnel token or a credentials file, and how to point my CNAME record to cfargotunnel.com — can you pull the Cloudflare Tunnel troubleshooting guide that covers those topics?"}],"resultDescription":"A JSON object containing a unique guide identifier, title, category tag (e.g. 'cloudflare', 'networking'), the full body text of the troubleshooting guide, an optional price field, and a license identifier — giving the agent a complete, human-readable reference article on Cloudflare Tunnel issues.","failureModes":["Payment not included or insufficient — endpoint requires $0.01 USDC via x402 protocol; returns 402 Payment Required","Network or upstream error on saylorinnovations.com — may return 502 or 503 with no guide body","Guide content temporarily unavailable — response may return with empty or null body field","Malformed request (wrong method or missing required fields) — returns 400 Bad Request"],"whenToPreferThis":"Choose this endpoint when an agent needs a concise, structured reference article specifically about Cloudflare Tunnel diagnostics — especially error 1033, 502s, ingress rule misconfiguration, Docker networking quirks, CNAME records for cfargotunnel, or the token-vs-credentials distinction. Prefer it over general web search when you want a reliable, pre-vetted technical guide returned as structured JSON rather than raw HTML, and when the $0.01 per-call cost is acceptable.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-21T07:24:19.025Z","isFirstParty":false,"canonicalSlug":"saylor-innovations-guide-library-cloudflare-tunnel-troubleshooting-07dc35ba"}