Skip to Content
ReferenceAPI referenceSystem

Get the newest release above the running version

GET
/api/v1/system/release-check

Reports the last check against GitHub Releases. status is off with APP_UPDATE_CHECK=false, with SCHEDULER_ENABLED=false, on agents and on local builds. This endpoint never calls GitHub itself.

Authorization

cookiesession<token>

Session cookie authentication.

Response Body

Request fulfilled, document follows

application/json
  1. response

The result of the last check for a newer release. latest is null when none is newer.

checkedAt*|

When the last successful check ran.

latest*|null
status*string

off when this process never checks, pending until a check succeeds, then checked.

Value in"off""pending""checked"
Example Request
curl -X GET 'https://geometrikks.example.com/api/v1/system/release-check'
Example Response200
{  "checkedAt": "2019-08-24T14:15:22Z",  "latest": {    "displayVersion": "string",    "newerReleaseCount": 0,    "newerReleaseCountExact": true,    "publishedAt": "2019-08-24T14:15:22Z",    "url": "string",    "version": "string"  },  "status": "off"}