Firmware V1

Change the device list for a scheduled upgrade

PUT
/fota/v1/upgrades/{accountName}/upgrade/{upgradeId}

Add or remove devices from a scheduled upgrade.

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

Path Parameters

accountName*string

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

upgradeId*string

The UUID of the upgrade, returned by POST /upgrades when the upgrade was scheduled.

Request Body

*/*

List of devices to add or remove.

List of devices to add or remove.

type*FirmwareTypeList

Possible values are append or remove

Value in

  • "append"
  • "remove"
deviceList*array<string>

The IMEIs of the devices.

Response Body

application/json

application/json

curl -X PUT "https://example.com/fota/v1/upgrades/0242078689-00001/upgrade/e3a8d88a-04c6-4ef3-b039-89b62f91e962" \  -H "Content-Type: */*" \  -d '<type>append</type>  <deviceList>15-digit IMEI</deviceList>  <deviceList>15-digit IMEI</deviceList>'
{  "accountName": "0000123456-00001",  "id": "60b5d639-ccdc-4db8-8824-069bd94c95bf",  "deviceList": [    {      "deviceId": "15-digit IMEI",      "status": "AddDeviceSucceed",      "Reason": "Device added Successfully"    },    {      "deviceId": "15-digit IMEI",      "status": "AddDeviceSucceed",      "Reason": "Device added Successfully"    }  ]}