BrewPage is a free, no-registration instant hosting service for HTML pages, Markdown documents, AI-agent artifacts, files, and multi-file static sites. It also offers a namespaced key-value store and a JSON document store. The REST API returns short, shareable HTTPS links (https://brewpage.app/{ns}/{id}) and an owner token used to update or delete content in place. BrewPage is designed to be AI-agent friendly: it provides an MCP server (brewpage-mcp), a Claude Code skill (brewdoc:publish), and a llms.txt manifest, and it requires a self-identifying User-Agent header on every request.
URL: Visit APIs.json URL
Run: Capabilities Using Naftiko
- Hosting, Markdown, HTML, AI Artifacts, File Hosting, Developer Tools
- Created: 2026-05-16
- Modified: 2026-05-16
The BrewPage REST API. Publish HTML, Markdown, files, and multi-file sites; store key-value pairs and JSON documents; browse the public gallery; check ownership; and submit abuse reports. Endpoints live under /api/ and short links live at /{ns}/{id}. Identical functionality is also available at brewdata.app.
Human URL: https://brewpage.app/api
- Hosting, HTML, Markdown, AI Artifacts, File Hosting, Developer Tools
- Documentation
- APIReference
- OpenAPI
- Authentication
- JSONSchema
- JSONSchema
- JSONSchema
- JSONSchema
- JSONSchema
- JSONStructure
- JSONStructure
- Example
- Example
- Example
- Example
- Example
- Documentation
- APIReference
- Portal
- GettingStarted
- Quickstart
- Authentication
- SDK
- Plans
- RateLimits
- FinOps
- SpectralRules
- Vocabulary
- NaftikoCapability
- NaftikoCapability
- JSON-LD
| Name | Description |
|---|---|
| Instant HTML Hosting | POST raw HTML or a JSON body to /api/html and receive a 10-char short URL at /{ns}/{id} with no signup. |
| Markdown Rendering | Pass format=markdown to publish Markdown that BrewPage renders to styled HTML at view time. |
| Multi-File Site Hosting | Upload a ZIP archive or files+paths multipart to /api/sites; entry point auto-detected (index.html preferred); 20 MB / 100 files / 5 MB each. |
| File Hosting | Upload binary or text files via /api/files (5 MB max). Images, PDFs, video, and audio display inline; ?dl=1 forces download. |
| Key-Value Store | 1000-key namespaced KV stores via /api/kv with per-key PUT/GET/DELETE and per-store enumeration. |
| JSON Document Store | 10,000-document collections via /api/json with PUT-in-place semantics on stable short URLs. |
| Update In Place | PUT to /api/html, /api/json, and /api/kv replaces content while keeping the short URL — agents can iterate without breaking shared links. |
| Owner Token Grouping | Save the ownerToken returned at creation and reuse it via X-Owner-Token to group resources under one owner and scope list endpoints. |
| Password Protection | Set X-Password (min 4 chars) at creation to require the same header (or ?p=...) for reads; passworded items are excluded from the gallery and sitemap. |
| Public Gallery | GET /api/gallery surfaces content posted to the default public namespace without a password — searchable, social-bot friendly, OG-image generated. |
| OpenGraph Preview Images | Per-content 1200×630 PNG at /preview/{ns}/{id}.png plus an /preview-html stub for social media unfurlers. |
| Short Link Resolver | GET /{ns}/{id} returns the hosted content; GET /{ns}/{id}/{sub} resolves sub-paths inside multi-file sites. |
| Idempotent Owner Re-POST | A byte-identical POST /api/html to public/ within 24h returns the existing id (X-Existing-Resource header set) so retries do not duplicate gallery entries. |
| Abuse Reports | POST /api/reports lets readers report inappropriate or harmful content for moderation. |
| Random Namespace Suggestion | GET /api/namespace/random returns a fresh, collision-free kebab-case namespace suggestion. |
| Platform Stats | GET /api/stats exposes platform-wide usage statistics; GET /api/sitemap.xml exposes a dynamic sitemap of public content. |
| AI-Agent Friendly | llms.txt and llms-full.txt manifests, an MCP server, a Claude Code skill, and required identifying User-Agent headers make BrewPage first-class for autonomous agents. |
| Name | Description |
|---|---|
| Share AI-Agent Output | Drop a Markdown report, generated HTML page, or JSON artifact and share a short URL with a teammate or end user. |
| Iterate On A Stable Link | Use PUT to refine content at the same short URL across multiple agent iterations without breaking previously shared links. |
| Stand Up A One-Off Microsite | Upload a ZIP of a static site (docs, demo, status page) and get a 30-day-max hosted URL with relative links between files. |
| Ephemeral File Drop | Send a PDF, image, or archive (≤5 MB) to a recipient who shouldn't need to sign up — URL expires automatically. |
| Scratch KV Storage For Agents | Use /api/kv as a free, server-side scratchpad for feature flags, session state, or memoized tool outputs (≤1000 keys per store). |
| Public Knowledge Drop | Post to the default public namespace and let the gallery + sitemap + OG image expose your content to search engines and social. |
| Password-Gated Share | Apply X-Password to a hosted page or file for lightweight access control without user accounts. |
| Name | Description |
|---|---|
| Model Context Protocol (MCP) | Official MCP server brewpage-mcp exposes BrewPage to any LLM/agent (Claude, Codex, Gemini, Cursor) via the Model Context Protocol. |
| Claude Code | Claude Code skill brewdoc:publish lets users publish from inside Claude Code via a slash command (claude-brewcode marketplace). |
| IndexNow | BrewPage submits public content to IndexNow for search engine discovery; PUT-based republish is recommended to preserve quota. |
| OpenGraph / Social Bots | Every short URL exposes /preview/{ns}/{id}.png (1200×630) and a /preview-html/{ns}/{id} OG stub for link unfurling. |
| Prism.js | Client-side syntax highlighting for known code/data file previews (JSON, XML, SVG, HTML, CSS, JS, TS, YAML, TOML, Markdown). |
| llms.txt | BrewPage publishes a /llms.txt and /llms-full.txt manifest for LLM-friendly discovery of the API surface. |
| Name | Description |
|---|---|
| Hosted Web Page | Free HTML/Markdown publishing with short URL, OG images, and password gating. |
| Hosted Files And Sites | 5 MB files and 20 MB multi-file sites with TTL up to 30 days. |
| Agent State And Documents | KV stores (1000 keys) and JSON collections (10,000 docs) for stateful agent workflows. |
| AI-Agent Integration | MCP server, Claude Code skill, llms.txt manifests, and identifying User-Agent contract. |
Machine-readable API specifications organized by format.
- BrewPage HTML Page Schema
- BrewPage File Schema
- BrewPage KV Store Schema
- BrewPage JSON Document Schema
- BrewPage Site Schema
- Create HTML Example
- Create Markdown Example
- Upload File Example
- Upload Site Example
- Upsert KV Example
Naftiko capabilities organized as shared per-API definitions composed into customer-facing workflows.
- BrewPage Hosting — REST adapter for the full BrewPage API surface (HTML, Files, Sites, KV, JSON, Discovery, Reports)
| Workflow | APIs Combined | Tools | Persona |
|---|---|---|---|
| Agent Artifact Publishing | brewpage | 11 | AI Agent / Developer / Content Author |
- BrewPage Vocabulary — Unified taxonomy mapping 14 resources, 12 actions, 6 capability goals, and the BrewPage primitives (namespace, shortId, ownerToken, ttl, password, userAgent)
- BrewPage Spectral Rules — 21 rules enforcing BrewPage title, server, path, operation, parameter, schema, response, and TTL conventions
FN: Kin Lane
Email: info@apievangelist.com