justhtml.sh
justhtml.sh is an HTML document hosting service that lets users and agents publish, share, edit, and discuss HTML documents at stable URLs. Documents can be private, shared via grants or view tokens, or made public.
justhtml.sh exposes one authenticated HTTP API at `https://justhtml.sh/api/v1`, documented by OpenAPI (`https://justhtml.sh/openapi.json` and YAML alternate) and secured with a long-lived Bearer API key obtained through its email code agent-auth flow.
- justhtml.sh HTTP APIdetected
Follow the agent authentication flow: first check for an existing key in JUSTHTML_API_KEY, a local .env (if permitted), or ~/.justhtml/credentials; if none works, ask for consent, POST to auth.md's identity endpoint (/agent/identity) with the human's email, have the human read back the emailed 6-digit code, submit it to /agent/identity/claim/complete, then poll the token endpoint until it returns the long-lived jh_live_... key. Store it securely and send it as a Bearer token. If the code expires, re-mint via /agent/identity/claim; revoke via POST form data to https://justhtml.sh/oauth2/revoke.
Follow the agent authentication flow: register the human's email, have them read back the emailed 6-digit code, complete the claim, then poll the token endpoint for the long-lived jh_live_… key. Store it securely (the examples use JUSTHTML_API_KEY) and send it as a Bearer token.
conventions · 5/8 published
- integrations.json✓https://justhtml.sh/.well-known/integrations.json
- llms.txt✓https://justhtml.sh/llms.txt
- API catalog✗
/.well-known/api-catalog - OpenAPI document✓https://justhtml.sh/openapi.json
- MCP server card✗
/.well-known/mcp/server-card.json - OAuth protected resource✓https://justhtml.sh/.well-known/oauth-protected-resource
- Agent card✗
/.well-known/agent-card.json - Agent skills✓https://justhtml.sh/.well-known/agent-skills/index.json
Publish these signals → /publishing