Fetch Latest Version of App

This API endpoint retrieves the latest version of a specific app based on the provided parameters.

Endpoint:

GET /apps/latest?app_name=<app_name>&channel=stable&platform=linux&arch=amd64&owner=admin

Query Parameters:

app_name: (Required) The name of the app you want to fetch.

channel: (Optional) The release channel (e.g., stable, beta).

platform: (Optional) The platform (e.g., linux, darwin).

arch: (Optional) The architecture (e.g., amd64, arm64).

package: (Optional) The package type (e.g., deb, rpm, dmg).

owner: Name of your admin user.

Important Behavior:

Channel Parameter:
- If channels have been pre-defined, the channel parameter becomes mandatory.
Single URL Redirection:
- If the response contains only one URL, the API will automatically redirect the request to download the build at that URL. This simplifies the process when only one option is available.

Flexible Responses Based on Parameters:

The API responds dynamically based on the parameters you provide. For example, the request:

GET /apps/latest?app_name=secondapp&channel=stable&platform=linux&arch=amd64&owner=admin

returns a list of available builds:

{
    "stable": {
        "linux": {
            "amd64": {
                "deb": {
                    "url": "https://<bucket_name>.s3.amazonaws.com/secondapp/stable/linux/amd64/secondapp-0.0.3.deb"
                },
                "rpm": {
                    "url": "https://<bucket_name>.s3.amazonaws.com/secondapp/stable/linux/amd64/secondapp-0.0.3.rpm"
                }
            }
        }
    }
}

If you further specify the package parameter like so:

GET /apps/latest?app_name=secondapp&channel=stable&platform=linux&arch=amd64&package=deb&owner=admin

the API will redirect directly to the .deb package download URL:

https://<bucket_name>.s3.amazonaws.com/secondapp/stable/linux/amd64/secondapp-0.0.3.deb

Omitting Platform and Arch:

If you omit specific parameters such as platform or arch, the API will return all builds available under that channel. For example, this request:

GET /apps/latest?app_name=secondapp&channel=stable&owner=admin

might return:

{
    "stable": {
        "linux": {
            "amd64": {
                "deb": {
                    "url": "https://<bucket_name>.s3.amazonaws.com/secondapp/stable/linux/amd64/secondapp-0.0.3.deb"
                },
                "rpm": {
                    "url": "https://<bucket_name>.s3.amazonaws.com/secondapp/stable/linux/amd64/secondapp-0.0.3.rpm"
                }
            }
        },
        "darwin": {
            "arm64": {
                "dmg": {
                    "url": "https://<bucket_name>.s3.amazonaws.com/secondapp/stable/darwin/arm64/secondapp-0.0.3.dmg"
                }
            },
            "amd64": {
                "pkg": {
                    "url": "https://<bucket_name>.s3.amazonaws.com/secondapp/stable/darwin/amd64/secondapp-0.0.3.pkg"
                }
            }
        }
    }
}

The API will provide all available builds depending on what is uploaded in the specified channel, platform, and architecture.

Fetch Latest Version of App​

Fetch Latest Version of App