Skip to content
OTA-Pulse Docs

Upload Firmware File

POST
/api/firmware/{firmware_id}/upload

Upload a Mender artifact (.mender file) for firmware deployment.

Only pre-built Mender artifacts are accepted. To create a Mender artifact from a raw firmware image, use the mender-artifact CLI tool locally:

mender-artifact write rootfs-image \
    -t radxa-cm5-io \
    -n release-v1.0.0 \
    -f firmware.ext4 \
    -o firmware-v1.0.0.mender

Args: file: The .mender artifact file to upload

Authorizations

Parameters

Path Parameters

firmware_id
required
string format: uuid

Query Parameters

organization_id
required
string format: uuid

Request Body required

object
file
required
string format: binary

Responses

200

Successful Response

Firmware response

object
checksum
required
Any of:
string
checksum_type
required
string
created_at
required
string format: date-time
description
Any of:
string
download_count
required
integer
failure_count
required
integer
file_path
Any of:
string
file_size
required
Any of:
integer
hardware_versions
required
Array<string>
id
required
string format: uuid
install_count
required
integer
is_mandatory
required
boolean
is_mender_artifact
boolean
min_version
required
Any of:
string
name
Any of:
string
<= 255 characters
organization_id
required
string format: uuid
release_notes
Any of:
string
released_at
required
Any of:
string format: date-time
rollout_percentage
required
number
status
required

Firmware status

string
Allowed values: draft testing released deprecated
version
required
string
<= 100 characters
version_code
required
Any of:
integer

422

Validation Error

object
detail
Array<object>
object
loc
required
Array
msg
required
string
type
required
string