API overview
REST API for publishing and managing HTMLDrop pages programmatically.
Last updated June 2, 2026
HTMLDrop exposes a versioned REST API at /api/v1/* for automation, CI/CD pipelines, and AI tool integrations.
Base URL
https://htmldrop.in/api/v1
Use your production or staging host when testing locally.
Authentication
All v1 endpoints require a signed-in account. Pass an API key as a Bearer token:
Authorization: Bearer hd_live_…
Create keys in Settings. Session cookies also work for same-user tooling.
The API is free during early access for all signed-in users. When billing launches, API access will move to Pro — see Plans & limits.
Versioning
Breaking changes ship under a new path (/api/v2/*). Non-breaking additions may appear on v1 without a version bump.
OpenAPI
Machine-readable spec: /openapi.yaml
Endpoints
| Method | Path | Description |
|---|---|---|
| POST | /pages | Publish a page |
| GET | /pages | List your pages |
| GET | /pages/[slug] | Get page metadata |
| PATCH | /pages/[slug] | Update page content |
| DELETE | /pages/[slug] | Delete a page |
| GET/PATCH | /pages/[slug]/settings | Password and expiry |
| GET | /pages/[slug]/analytics | View counts |
AI endpoints (/ai/*) are planned but not enabled yet.