Download public balenaOS images through API

Product support
1

Hi Balena Team

When experimenting with the API endpoint to download public balenaOS images, I think I found a small documentation or API typo.

The example includes a fileType=.gz parameter in the query, however, I always get the following error:
fileType parameter must be one of: .img, .gz, .zip

Even after changing the fileType to .img or .zip, the query did not succeed.

When changing the parameter key to filetype (all lower), I was able to download an OS in all three filetypes.

Please check if the docs or the API requires a small change, this could possibly save others some time :slight_smile:

Kind regards

Robbe

2

Adding to that, using the List the supported balenaOS versions for a device type endpoint for the generic-amd64 device type, the first 2 elements of the list are 2025.7.0 and 2024.7.1. These can’t be downloaded and are not in the list when adding a device through the BalenaCloud UI.

Are those official releases? The don’t seem to match the semver notation used in all other releases?