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

id
created_at
belongs_to__application
is_created_by__user
raw_version
semver
semver_major
semver_minor
semver_patch
semver_prerelease
semver_build
revision
variant
commit
composition
status
source
build_log
start_timestamp
end_timestamp
update_timestamp
is_invalidated
release_version
contract

Examples

Get all releases for a fleet

curl -X GET \
"https://api.balena-cloud.com/v6/release?\$filter=belongs_to__application%20eq%20<FLEET ID>" \
-H  "Content-Type: application/json"  \
-H "Authorization: Bearer <AUTH_TOKEN>" 

Get the release raw_version field

The raw_version field is returned only when explicitly requested with $select.

curl -X GET \
"https://api.balena-cloud.com/v6/release(<ID>)?\$select=raw_version" \
-H  "Content-Type: application/json"  \
-H "Authorization: Bearer <AUTH_TOKEN>" 

Get a release ID given a specific fleet and version

curl -X GET \
"https://api.balena-cloud.com/v6/release?\$filter=belongs_to__application%20eq%20<FLEET ID>%20and%20raw_version%20eq%20'<RAW VERSION>'&\$select=id" \
-H  "Content-Type: application/json"  \
-H "Authorization: Bearer <AUTH_TOKEN>" 

Get a release ID given a specific fleet and commit

curl -X GET \
"https://api.balena-cloud.com/v6/release?\$filter=belongs_to__application%20eq%20<FLEET ID>%20and%20commit%20eq%20'<COMMIT HASH>'&\$select=id" \
-H  "Content-Type: application/json"  \
-H "Authorization: Bearer <AUTH_TOKEN>"