Firmware V1

Schedule a firmware upgrade

POST
/fota/v1/upgrades

Schedules a firmware upgrade for devices.

Authorization

thingspace_oauth VZ-M2M-Token
AuthorizationBearer <token>

This is the ThingSpace token, from Credentials and Tokens is used

In: header

VZ-M2M-Token<token>

M2M Session Token (How to generate an M2M session token?)

In: header

Request Body

application/json

Details of the firmware upgrade request.

Details of the firmware upgrade request.

accountName*string

Account identifier in "##########-#####".

firmwareName*string

The name of the firmware image that will be used for the upgrade, from a GET /firmware response.

firmwareTo*string

The name of the firmware version that will be on the devices after a successful upgrade.

startDate*string

The date that the upgrade begins.

Formatdate
endDate*string

The date that the upgrade ends.

Formatdate
deviceList*array<string>

The IMEIs of the devices.

Response Body

application/json

application/json

curl -X POST "https://example.com/fota/v1/upgrades" \  -H "Content-Type: application/json" \  -d '{    "accountName": "0402196254-00001",    "firmwareName": "FOTA_Verizon_Model-A_01To02_HF",    "firmwareTo": "VerizonFirmwareVersion-02",    "startDate": "2018-04-01",    "endDate": "2018-04-05",    "deviceList": [      "990003425730535",      "990000473475989"    ]  }'
{  "id": "e3a8d88a-04c6-4ef3-b039-89b62f91e962",  "accountName": "0242078689-00001",  "firmwareName": "FOTA_Verizon_Model-A_01To02_HF",  "firmwareTo": "VerizonFirmwareVersion-02",  "startDate": "2018-04-01",  "status": "RequestPending",  "deviceList": [    {      "deviceId": "990003425730535",      "status": "RequestPending"    },    {      "deviceId": "990000473475989",      "status": "RequestPending"    }  ]}