Create Firmware

POST

/api/firmware

curl --request POST \
  --url 'https://example.com/api/firmware?organization_id=2489E9AD-2EE2-8E00-8EC9-32D5F69181C0' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "description": "example", "hardware_versions": [ "example" ], "is_mandatory": false, "min_version": "example", "name": "example", "release_notes": "example", "version": "example", "version_code": 1 }'

Create a new firmware version (without file upload)

Authorizations

• HTTPBearer

Parameters

Query Parameters

organization_id

required

Organization Id

string format: uuid

Request Body^required

Media type application/json

FirmwareCreate

Firmware creation (file uploaded separately)

object

description

Any of:

string

string

null

null

hardware_versions

Any of:

Array<string>

Array<string>

null

null

is_mandatory

Is Mandatory

boolean

min_version

Any of:

string

string

null

null

name

Any of:

string

string

<= 255 characters

null

null

release_notes

Any of:

string

string

null

null

version

required

Version

string

<= 100 characters

version_code

Any of:

integer

integer

null

null

Responses

201

Successful Response

Media type application/json

FirmwareResponse

Firmware response

object

checksum

required

Any of:

string

string

null

null

checksum_type

required

Checksum Type

string

created_at

required

Created At

string format: date-time

description

Any of:

string

string

null

null

download_count

required

Download Count

integer

failure_count

required

Failure Count

integer

file_path

Any of:

string

string

null

null

file_size

required

Any of:

integer

integer

null

null

hardware_versions

required

Hardware Versions

Array<string>

id

required

Id

string format: uuid

install_count

required

Install Count

integer

is_mandatory

required

Is Mandatory

boolean

is_mender_artifact

Is OTA artifact (deprecated)

Deprecated alias for is_ota_artifact. Use is_ota_artifact.

boolean

is_ota_artifact

Is Ota Artifact

boolean

min_version

required

Any of:

string

string

null

null

name

Any of:

string

string

<= 255 characters

null

null

organization_id

required

Organization Id

string format: uuid

release_notes

Any of:

string

string

null

null

released_at

required

Any of:

string

string format: date-time

null

null

rollout_percentage

required

Rollout Percentage

number

signature_status

Any of:

string

string

null

null

status

required

FirmwareStatus

Firmware status

string

Allowed values: draft testing released deprecated

version

required

Version

string

<= 100 characters

version_code

required

Any of:

integer

integer

null

null

Example

{
  "is_mender_artifact": false,
  "is_ota_artifact": false,
  "status": "draft"
}

422

Validation Error

Media type application/json

HTTPValidationError

object

detail

Detail

Array<object>

ValidationError

object

ctx

Context

object

input

Input

loc

required

Location

Array

msg

required

Message

string

type

required

Error Type

string

Example ^generated

{
  "detail": [
    {
      "ctx": {},
      "input": "example",
      "loc": [
        "example"
      ],
      "msg": "example",
      "type": "example"
    }
  ]
}