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

# Versions

> List a drop's history and promote an older version back to live.

## List versions

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

Returns the retained versions, newest first. How many are kept depends on your
plan — 3 on free, 10 on Plus, 30 on Business.

## Roll back

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

Promoting makes that version live immediately at the same URL. The rollback is
itself recorded as a publish, so nothing is lost and you can roll forward again.

See [updating and rolling back](/publishing/updating-and-rollback) for the
concept and the dashboard equivalent.