Releases

List releases

List reverse-chronological deployment attempts for a project.

GET/api/v1/projects/{projectID}/releases

Authentication: REST bearer token required.

Parameters

projectIDUUIDrequired

PathThe project UUID.

cursorstringoptional

QueryThe opaque next_cursor from the previous response.

limitintegeroptional

QueryNumber of releases to return, from 1 to 100. Defaults to 20.

Responses

200

A cursor-paginated release page.

400

The request is invalid or contains an unsupported value.

401

The bearer token is missing, invalid, or expired.

404

The requested resource does not exist for this account.

cURL

curl --fail-with-body --request GET \
  --url "https://api.sitedropper.com/api/v1/projects/${PROJECT_ID}/releases?limit=20" \
  --header "Authorization: Bearer $SITEDROPPER_TOKEN"

Response · 200

{
  "releases": [
    {
      "id": "aa9e57c2-2705-4477-a77c-3638029aca10",
      "project_id": "8d7748aa-3e9d-44d5-85f9-928f20a19c62",
      "version_id": "5596d13a-6b40-4d5b-813f-07083d830941",
      "version_number": 3,
      "status": "succeeded",
      "stage": "ready",
      "active": true,
      "runtime": "static",
      "framework": "static",
      "url": "https://preview-a13f9c.apps.sitedropper.com",
      "source_checksum": "sha256:13d8…91cc",
      "created_at": "2026-08-20T22:31:00Z",
      "finished_at": "2026-08-20T22:36:00Z"
    }
  ],
  "next_cursor": "MjA"
}