> ## 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.

# Updating and rolling back

> Every upload is a version. Publishing again never loses the old copy.

Publishing to an existing drop creates a new version and makes it live
immediately. The URL never changes, so a link you shared last week keeps working
and simply shows the newer content.

## Rolling back

Open the drop in the dashboard, find the version you want in the history, and
promote it. It becomes live at once — a rollback is itself a normal publish, so
nothing is destroyed and you can roll forward again.

Via the API:

```bash theme={null}
curl -X POST https://htmldrop.app/api/v1/sites/{site_id}/versions/{version_id}/promote \
  -H "Authorization: Bearer $HTMLDROP_API_TOKEN"
```

## How many versions are kept

| Plan     | Versions retained |
| -------- | ----------------- |
| Free     | 3                 |
| Plus     | 10                |
| Business | 30                |

Once the limit is reached, the oldest version is dropped as a new one arrives.
Being over a limit never deletes a live drop — caps apply when you add, not
retroactively.

## Updating from an agent

Publishing to the same slug is an update, so this works as you would expect:

> Update my portfolio and republish

The agent calls `htmldrop_publish` with the existing slug, and the live URL stays
the same.