Uploads

Firmware file upload endpoints

Upload firmware

post

Upload a firmware binary file to the server.

The file type is determined by the type form field:

• FIRMWARE — OTA firmware binary (.bin, .zip, .tar, .gz, .hs, .xz, .bz2, .tar.gz, .ota.bin.gz, .bin.gz, .bin.hs, .yml, .yaml)

The maximum file size is 10 MB.

Authentication: Use an OAuth2 Bearer token in the Authorization header.

Authorizations

bearerAuth

AuthorizationstringRequired

OAuth2 Bearer token obtained from authentication endpoint

Body

multipart/form-data

upfilestring · binaryRequired

The firmware file to upload

typestring · enumOptional

Upload file type. Must be FIRMWARE.

Example: FIRMWAREPossible values:

Responses

200

File uploaded successfully. Returns the server path to the uploaded file.

application/json

stringOptional

400

Bad request — invalid or missing file data

application/json

403

Forbidden — authentication failed, plan does not support uploads, or upload limit reached

application/json

429

Too many requests

500

Internal server error

application/json

post

/api/upload

HTTPcURLJavaScriptPython

POST /api/upload HTTP/1.1
Host: blynk.cloud
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: multipart/form-data
Accept: */*
Content-Length: 37

{
  "upfile": "binary",
  "type": "FIRMWARE"
}

/uploads/fw_abc123def456.bin