DocumentSage

File (.html / .md)

📄

Drop your file here or browse

Path (e.g. reports/q1-sales)

API Key (X-API-Key)

Remembered in this browser (localStorage) — also used to delete pages.

Public Off by default — private pages need login to view

POST /api/upload

Upload an HTML or Markdown file. Same path = overwrite. isPublic defaults to false.

Header/Body	Value
X-API-Key	Your static API key (or use session cookie from login)
file	.html or .md file (multipart)
path	e.g. "reports/summary"
isPublic	"true" or "false" (default false)

# Upload with curl curl -X POST http://localhost:3000/api/upload \ -H "X-API-Key: your-key" \ -F "file=@report.html" \ -F "path=reports/q1" \ -F "isPublic=true" # Response { "url": "http://localhost:3000/view/reports/q1", ... }

DELETE /api/pages/:path

Delete a page + its file. Requires valid session cookie or X-API-Key.

curl -X DELETE http://localhost:3000/api/pages/reports/q1 \ -H "X-API-Key: your-key"

GET /api/pages

List all pages (public only, or all with session cookie). Sorted newest first.

curl http://localhost:3000/api/pages

GET /view/:path

Shareable page URL. HTML is served as-is (full page); Markdown opens the client-side viewer. 404 if not found, login redirect if private + unauthenticated.

curl -L http://localhost:3000/view/reports/q1

GET /api/raw/:path

Raw file bytes used by the Markdown renderer. 404 if not found, 403 if private + unauthenticated.

curl http://localhost:3000/api/raw/reports/q1

POST /api/auth/login

Login with admin password. Sets persistent JWT cookie.

curl -X POST http://localhost:3000/api/auth/login \ -H "Content-Type: application/json" \ -d '{"password":"admin"}'

Loading…

Upload Document