latestOpenAPI 3.1.02026-08-08423062.6 KB

6e0ac03e39e5

HTML

Create HTML page

Stores HTML or markdown content and returns a shareable link. Reuse existing owner token to group entities under one owner. Also accepts raw text/* (HTML, Markdown, YAML, XML, CSV, code) and application/octet-stream bodies — see /llms-full.txt.

post/api/html

Query parameters

nsstring

Namespace. Default: public. Pages in 'public' without password appear in gallery. Custom namespace is created automatically

tagsstring

Comma-separated tags

ttlstring

Time to live in days (1-30, default 15). Page auto-deletes after expiry. Accepts '15', '15d' or '15 days'

formatstring

Content format. 'html' (default) — stored verbatim. 'markdown' / 'md' — rendered to styled HTML via github-markdown-css. Code/text languages stored and served raw with format-specific MIME (text/csv, application/json, text/xml, text/plain) plus X-Content-Type-Options: nosniff: yaml, json, xml, csv, tsv, log, toml, ini, sql, sh, bat, env, javascript, typescript, tsx, jsx, css, properties, docker, txt

Headers

X-Passwordstring

Access password. Empty = public page visible in gallery. With password = hidden from gallery, viewers must enter password or pass ?p= in URL

X-Owner-Tokenstring

Reuse existing owner token to group entities under one owner. If omitted, a new token is generated

User-Agentstring

Request body

contentstring

HTML or markdown content to publish

filenamestring

Optional original filename used as the tab title fallback and download basename. Trimmed; rejected if it contains path separators or control characters, length > 200, or bare name shorter than 4 chars

showTopBarboolean

Per-content toggle for the frontend top toolbar. null = use global default (app.ui.show-top-bar-default)

Response

Page created