Updating device host OS release version via API call

Hi! We’re working on implementing various device upgrades via the balenaCloud API. We’re able to successfully upgrade the supervisor release version using the should_be_managed_by__release field as documented here, however we have not found a way to upgrade the host OS release version.

We see an undocumented field should_be_operated_by__release on the device resource, however the field value doesn’t reflect the current host OS release nor does patching this value to an upgraded release version appear to have any affect on the device. I do see that there appears to be some ongoing work related to this field.

Is there currently a way to upgrade the host OS for a device via a balenaCloud API call? If not, are there plans to support this functionality in the future?

Thank you for your time!

Hey there, welcome to the forums and thanks for the great question!

Upgrading the hostOS is not something that is currently supported via the API but it can be done via our SDK using device.startOsUpdate

We are actively working on allowing the hostOS version to be applied via target state like application releases and supervisor releases and we will share more info when we can!

1 Like