{"uid":"cap_OjVLSfxio-Iqy7zO5N1gF","slug":"publish-page-markdown-html-to-url-d8ce1236","name":"Publish Page (Markdown/HTML to URL)","description":"Send Markdown (or HTML) and get back a URL that renders as a real page — headings, tables, code blocks, mobile-readable, no scripts and no external requests. The other half of an agent's output problem: file-slot is for bytes it will fetch back, this is for the report somebody has to read. Retention 1-30 days. Published on the storage origin, never on 402.com.tr.","url":"https://402.com.tr/api/x402/file-publish","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"},"pathParams":{"type":"object"},"queryParams":{"type":"object","required":["text"],"properties":{"text":{"type":"string","description":"Markdown or HTML to publish"},"title":{"type":"string","description":"Page title (optional)"},"format":{"type":"string","description":"md (default) or html"},"ttlDays":{"type":"string","description":"Retention in days (optional)"}}}},"additionalProperties":false}}},"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_I9G6lP6AojadvBoMDm-7I","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":"Renders Markdown or HTML as a clean, mobile-readable web page and returns a shareable URL, with configurable retention of 1–30 days.","exampleAgentPrompt":"Take this markdown report and publish it as a readable web page I can share with the team — keep it live for 7 days and title it 'Q3 Analysis Summary'.","exampleUseCases":[{"title":"Share agent research report","prompt":"I just finished compiling this market research in markdown — can you publish it as a proper web page with the title 'Competitor Landscape 2025' and keep it up for 14 days so I can share the link with stakeholders?"},{"title":"Publish code documentation","prompt":"Convert this markdown documentation with code blocks and tables into a shareable URL — title it 'API Quickstart Guide' and make it available for 30 days."},{"title":"Deliver one-off HTML briefing","prompt":"I have an HTML summary I need to send to a client as a link rather than an attachment — can you publish it as a page for 3 days with the title 'Weekly Briefing'?"}],"resultDescription":"Returns a URL pointing to a rendered, mobile-friendly web page displaying the submitted Markdown or HTML content — with proper headings, tables, and code block formatting. The page loads with no external scripts or third-party requests. It remains accessible for the specified retention period (1–30 days, default if unset).","failureModes":["Missing 'text' query parameter returns an error — the content body is required","Invalid 'format' value (not 'md' or 'html') may cause rendering issues","TTL value outside 1–30 days range may be rejected or clamped","Very large text payloads may be truncated or rejected","Page expires after retention period — URL becomes inaccessible","Payment failure (insufficient USDC balance) prevents page creation"],"whenToPreferThis":"Use this endpoint when an agent needs to produce a human-readable, shareable URL from structured text output — especially markdown reports, summaries, or documentation — without needing a persistent CMS or file download. Prefer this over file-slot endpoints when the output is meant to be read in a browser by a person rather than fetched programmatically. Ideal for ephemeral deliverables like briefings, audit reports, or agent-generated summaries with a defined shelf life.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T11:14:12.484Z","isFirstParty":false}