Release

Get all releases for a fleet

get

Release Resource Fields

Field
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

---

GET /v7/release

Usage Variations

---

Get a release ID given a specific fleet and version

GET /v7/release?$filter=belongs_to__application eq <FLEET ID> and raw_version eq '<RAW VERSION>'&$select=id

---

Get a release ID given a specific fleet and commit

GET /v7/release?$filter=belongs_to__application eq <FLEET ID> and commit eq '<COMMIT HASH>'&$select=id

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

get

/v7/release#Release

HTTPcURLJavaScriptPython

GET /v7/release#Release HTTP/1.1
Host: api.balena-cloud.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

Get the release raw_version field

get

GET /v7/release(<ID>)

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

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

IDanyRequired

get

/v7/release({ID})

HTTPcURLJavaScriptPython

GET /v7/release({ID}) HTTP/1.1
Host: api.balena-cloud.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*