htmldrop

API

Everything you can do in the dashboard, agents can do with one HTTP call. Pass your API key as a Bearer token. Get one from Settings or by calling the signup endpoint below.

POST/api/v1/signup

Agents can sign up without a browser. No auth required. Returns the API key for the new account. password must be 8+ characters.

curl -X POST https://htmldrop.xyz/api/v1/signup \
  -H "Content-Type: application/json" \
  -d '{"email": "agent@example.com", "password": "a-strong-password"}'
{
  "email": "agent@example.com",
  "plan": "free",
  "api_key": "hd_4f2c9a...",
  "note": "Store this API key securely..."
}
POST/api/v1/artifacts

html is required (max 2 MB). slug and title are optional; password requires the Pro plan.

curl -X POST https://htmldrop.xyz/api/v1/artifacts \
  -H "Authorization: Bearer hd_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "html": "<!doctype html><h1>Quarterly report</h1>",
    "title": "Q2 Report",
    "slug": "q2-report",
    "password": "optional-secret"
  }'
{
  "id": "5f0c...",
  "slug": "q2-report",
  "title": "Q2 Report",
  "url": "https://htmldrop.xyz/a/q2-report",
  "protected": true,
  "views": 0,
  "size_bytes": 42,
  "created_at": "2026-06-10T12:00:00Z",
  "updated_at": "2026-06-10T12:00:00Z"
}
GET/api/v1/artifacts

Returns metadata for all of your artifacts (no HTML bodies).

curl https://htmldrop.xyz/api/v1/artifacts \
  -H "Authorization: Bearer hd_your_api_key"
GET/api/v1/artifacts/{slug}

Fetch a single artifact, including its HTML source.

curl https://htmldrop.xyz/api/v1/artifacts/q2-report \
  -H "Authorization: Bearer hd_your_api_key"
PUT/api/v1/artifacts/{slug}

Send any of html, title, password. Set "password": null to remove protection.

curl -X PUT https://htmldrop.xyz/api/v1/artifacts/q2-report \
  -H "Authorization: Bearer hd_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"html": "<!doctype html><h1>Updated</h1>"}'
DELETE/api/v1/artifacts/{slug}

The URL stops resolving immediately.

curl -X DELETE https://htmldrop.xyz/api/v1/artifacts/q2-report \
  -H "Authorization: Bearer hd_your_api_key"

Limits and errors

  • Free plan: 100 artifacts. Pro ($7.99/mo): 1,000 plus password protection.
  • Max artifact size: 2 MB of HTML.
  • Errors return JSON {"error": "message"} with status 400, 401, 403, 404, 409, or 413.
  • Published pages are served at https://htmldrop.xyz/a/{slug}; raw HTML for fetching at https://htmldrop.xyz/raw/{slug}.