1. Reference
  2. API
  3. Resources
Improve this doc
Detailed information for resources

balenaCloud API Resources

Note: We recently renamed applications to fleets and are in the process of updating our API resources. Application resources continue to function correctly and can be used to work with fleets. Find out more about the changes here.

Available fields

Examples

Download private or ESR balenaOS images

In order to download an ESR or private balenaOS image, you need to provide your bearer token. The `deviceType` and `version` parameters are required. Add an `--output` flag to provide a path for the image to be downloaded.

curl -X GET \
"https://api.balena-cloud.com/download?deviceType=<DEVICE NAME>&version=<BALENAOS VERSION>&fileType=.zip'" \
-H  "Content-Type: application/json"  \
-H "Authorization: Bearer <AUTH_TOKEN>"

Download public balenaOS images

Same as above but the auth header is optional to use. The `deviceType` and `version` parameters are required. These releases also available for download on balena.io/os and the dashboard.

curl -X GET \
"https://api.balena-cloud.com/download?deviceType=<DEVICE NAME>&version=<BALENAOS VERSION>&fileType=.gz'" \
-H  "Content-Type: application/json"  \
-H "Authorization: Bearer <AUTH_TOKEN>"