Updating and rolling back - htmldrop

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:

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.