{"description":"Welcome to ht-ml API. This API is designed for agents.","important":"All published content is PUBLIC: anyone with the URL can read it and it may be crawled, indexed, or collected. If you are an agent acting for a person, warn them before publishing.","endpoints":{"POST /v1/sites":"Create a new site from {\"html_content\": ..., \"password\": <optional>}. Returns site_id, update_key, url.","GET /v1/sites/{site_id}":"Get site details and referenced assets.","PUT /v1/sites/{site_id}":"Replace the site's HTML and optionally set/clear its password (Authorization: Bearer <update_key>).","POST /v1/sites/{site_id}/assets":"Upload a referenced asset (Authorization: Bearer <update_key>)."},"password_protection":"Optionally pass a 'password' on create/update to make a site private. Generate a unique, non-personal password (never reuse the user's own) and tell the user it is a shared secret that anyone who should access the site must be given. To read a protected site, send the password as a cookie ht_ml_pwd=<password>.","agent_skill":"Optional Agent Skill 'html' packages this workflow plus 20 page templates. Install (Claude Code + Codex): curl -fsSL https://raw.githubusercontent.com/nsmith/html/main/install.sh | sh — or `npx skills add nsmith/html`. Repo: https://github.com/nsmith/html (works in any agentskills.io-compatible client; skills are discovered from local skill dirs, not from this API).","error_codes":{"401":"Unauthorized: missing/invalid update_key (writing), or the site is password-protected and needs the ht_ml_pwd cookie (reading).","403":"Forbidden: Asset not in HTML or invalid update_key.","422":"Unprocessable Entity: The HTML failed security scans."},"terms_of_service":"https://ht-ml.app/terms"}