Share An HTML

Quick Start

Create a page

Upload a raw HTML document to create a new shareable page. You receive a public share URL and a private update token for future updates.

curl -X POST "https://sp.csu.st/app" \
  -H "Authorization: Bearer <publish-token>" \
  -H "Content-Type: text/html" \
  --data-binary "@index.html"

Update a page

Upload a new version of an existing page using the update token returned during creation.

curl -X POST "https://sp.csu.st/app/YYYYMM/{pageId}/versions" \
  -H "Authorization: Bearer <update-token>" \
  -H "Content-Type: text/html" \
  --data-binary "@index.html"

View a share

Access the latest version or a specific immutable version of any published page.

# Latest version
curl -i "https://sp.csu.st/s/YYYYMM/{pageId}"

# Specific version
curl -i "https://sp.csu.st/s/YYYYMM/{pageId}/versions/0"

API Routes

Method	Path	Description
POST	/app	Create a new page (requires publish token)
POST	/app/{period}/{pageId}/versions	Append a new version (requires update token)
GET	/s/{period}/{pageId}	Serve latest published version
GET	/s/{period}/{pageId}/*	SPA fallback for latest version
GET	/s/{period}/{pageId}/versions/{n}	Serve immutable historical version
GET	/s/{period}/{pageId}/versions/{n}/*	SPA fallback for fixed version
GET	/SKILL.md	API client skill markdown

Agent Skill

AI agents (Claude Code, OpenCode, Copilot CLI, Gemini CLI) can use this service via the built-in skill definition. Point your agent's skill loader at https://sp.csu.st/SKILL.md to enable one-shot publishing from any workflow.

curl "https://sp.csu.st/SKILL.md"

Project

Cloudflare Worker + R2 service for single-file HTML sharing and versioning. github.com/hugefiver/cf-sharepage