balena-io/Upload Balena release asset

Uploads a build artifact to a balena release

Trust Signals

Scorecard Score: not yet scored
Maintenance Recency: Activelast commit Feb 19, 2026
License: Apache 2.0

Pinned Snippet

workflow.ymlSHA-pinned

uses: balena-io/upload-balena-release-asset@52cceb8fc25e0bfdb433b92567a434d1a5baecda # v0.1.6

tags can be moved; commit SHAs can't. why a SHA?

Inputs

name	description	required	default
balena-token	Your balenaCloud API token	yes	—
release-id	The release id this asset belongs to	yes	—
path	A file, directory or wildcard pattern that describes what to upload	yes	—
key-prefix	A prefix to prepend to the asset key for the uploaded files. By default the slugified file name with relative paht is used as key. If a key-prefix is provided, the slugified file name will be appended to it.	—	""
balena-host	Domain for the backend services to upload your asset	—	balena-cloud.com
overwrite	If true, an asset with a matching release asset key will be deleted before a new one is uploaded. If false, the action will fail if an asset for the given release asset key already exists. Does not fail if the release asset key does not exist.	—	false
if-no-files-found	The desired behavior if no files are found using the provided path. Available Options: warn: Output a warning but do not fail the action error: Fail the action with an error message ignore: Do not output any warnings or errors, the action does not fail	—	warn
chunk-size	The size of the chunks to split the file into when uploading. If the file is smaller than this size, it will be uploaded in one go.	—	134217728
parallel-chunks	The number of parallel chunks to upload at the same time.	—	4

Outputs

name	description
release-assets	The list of assets that were uploaded to the release. This is a JSON array of objects with the following properties: - id: The unique identifier for the release_asset - url: The download URL for the asset - key: The asset key used for the upload