> ## Documentation Index
> Fetch the complete documentation index at: https://docs.htmldrop.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Anonymous drops

> Publish without an account: two endpoints, no credentials.

## Publish HTML

```bash theme={null}
curl -F "file=@page.html" https://htmldrop.app/api/v1/drops
```

`multipart/form-data` with a single `file` field. Returns:

```json theme={null}
{
  "url": "https://wandering-fox-42.htmldrop.app",
  "id": "v7r6ihmnv4mn",
  "slug": "wandering-fox-42"
}
```

## Publish Markdown

```bash theme={null}
curl -X POST https://htmldrop.app/api/v1/drops-md \
  -H "Content-Type: application/json" \
  -d '{"title":"Release notes","markdown":"# 1.2\n\nShipped."}'
```

| Field      | Required | Notes                          |
| ---------- | -------- | ------------------------------ |
| `markdown` | yes      | CommonMark source              |
| `title`    | no       | Page title and dashboard label |

## List the drops for this browser

```bash theme={null}
curl https://htmldrop.app/api/v1/drops --cookie-jar jar --cookie jar
```

Anonymous ownership is carried by a signed cookie, so this returns the drops made
by that browser. It is what the homepage uses to show you your own drops when you
return.

## Limits

* **2 MB** per upload
* **7 days** lifetime, on a fixed clock
* Single `.html` or `.md` files only — folders and `.zip` need an account
* Per-IP and per-session caps apply to prevent bulk abuse

<Tip>
  Sign up from the same browser and these drops are claimed into your account
  automatically, keeping their URLs.
</Tip>