Sign in
latestSwagger 2.02026-08-1095121164.0 KB

94758829689e

sites

List Upstream Updates

Lists available upstream update commits for a site. Returns commits that are available from the upstream but not yet applied to the site.

get/v0/sites/{site_id}/upstream-updates

Path parameters

site_idstring required

Site UUID

Query parameters

base_branchstring

Base branch reference for comparison

Response

behindinteger required

Number of commits behind the upstream

environmentsobject

Per-environment upstream status

has_codeboolean required

Whether the site has code (vs empty repository)

Example response

{
  "behind": 4,
  "commits": [
    {
      "author": "Jane Developer",
      "datetime": "2025-01-15 14:30:00",
      "hash": "abc123def456",
      "message": "Update dependencies"
    }
  ],
  "environments": {
    "dev": {
      "is_up_to_date_with_upstream": true
    },
    "live": {
      "is_up_to_date_with_upstream": false
    },
    "test": {
      "is_up_to_date_with_upstream": false
    }
  },
  "has_code": true
}