Skip to main content

Check Latest Version of application

Check if there is a newer version of a specific application available.

Endpoint

GET /checkVersion?app_name=<app_name>&version=<version>

Query Parameters

ParameterTypeRequiredDescription
app_namestringName of the app to check
versionstringCurrent version of the app
channelstringChannel (e.g., stable, beta)
platformstringPlatform (e.g., linux, windows)
archstringArchitecture (e.g., amd64, arm64)
ownerstringName of your admin user

Example Request

curl -X GET --location 'http://localhost:9000/checkVersion?app_name=secondapp&version=0.0.1&channel=stable&platform=linux&arch=amd64&owner=admin'

Response

Success Response (200 OK)

{
"update_available": true,
"update_url_deb": "https://<bucket_name>.s3.amazonaws.com/secondapp/stable/linux/amd64/secondapp-0.0.2.deb",
"update_url_rpm": "https://<bucket_name>.s3.amazonaws.com/secondapp/stable/linux/amd64/secondapp-0.0.2.rpm",
"changelog": "### Changelog\n\n- Added new feature X\n- Fixed bug Y",
"critical": true,
"is_intermediate_required": true
}

Response Fields

FieldTypeDescription
update_availablebooleanIndicates whether a newer version is available
update_url_debstringDirect download URL for the .deb package
update_url_rpmstringDirect download URL for the .rpm package
changelogstringChangelog content for the latest version (in markdown format)
criticalbooleanIndicates if this is a critical update that should be applied immediately
is_intermediate_requiredbooleanIndicates if an intermediate version must be installed before latest version

Notes

  • This endpoint is designed for client applications to check for updates
  • The update_available field helps clients determine if they need to update
  • Download URLs are provided for different package formats
  • The owner parameter is required for proper access control
  • Version comparison is done automatically by the API
  • Critical updates should be prioritized and applied as soon as possible
  • Intermediate versions may be required for major version jumps or breaking changes