Sites

List the versions of a site

The history of a site, newest first: every deploy that changed its files (including partial deploys, imports, approved deploys, rollbacks and promoted previews) is a version with who made it, through which client, its message and the changed paths. Previews are in the list too (preview: true, with preview_url). Versions older than the plan's retention period are removed, unless they have a label or are a checkpoint (auto_label "before big change"). auto_label also marks versions that stayed live for at least 24 hours and were not rolled back ("stable"). Included on every plan; the plan sets the retention period and the number of labels.

get/sites/{id}/versions

Request

  • Base URL: https://api.hypamoon.com/api/v1
  • URL: https://api.hypamoon.com/api/v1/sites/{id}/versions
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://app.hypamoon.com/oauth/authorize, token URL https://api.hypamoon.com/oauth/token, scopes: sites:read)

Path parameters

idstring uuid required

The id of the site.

Query parameters

limitinteger

How many versions per page (default 20).

cursorinteger

The next_cursor of the previous page.

Response

The versions, newest first.

object'list' required
has_moreboolean required
next_cursorinteger nullable required

Send as cursor for the next page.

retention_daysinteger required

How long the plan keeps versions.

labels_maxinteger required

How many labeled versions a site can have on this plan.

Changes

No recorded changes to this operation across all 1 revision of this API.