Ask a Device to Report its Firmware

`PUT /firmware/{acc}/async/{deviceId}`

This endpoint allows a user to request the device management server to send a message to the device and request that it report it’s running firmware. This message is asynchronous since it will depend on the device. User can run the POST/devices/{acc] API later to see what has been reported.

Request Components

HTTP Request

`PUT https://thingspace.verizon.com/api/fota/v3/firmware/{acc}/async/{deviceId}`

Resource Path and Query Parameters

Parameter Name	Data Type	Description
acc required	string	Account identifier.
deviceId required	string	The identifier of the device being queried

Header Parameters

The request header must contain a current ThingSpace authorization token and a current VZ-M2M-session token.

Parameter Name	Data Type	Description
Authorization required	string	HTTP Authorization request header containing a valid Bearer token.
VZ-M2M-Token required	string	A valid session token returned by a Connectivity Management POST /session/login request.
Content-Type required	string	Must be `application/json`.

Request Body

None

Example Request

curl PUT https://thingspace.verizon.com/api/fota/v3/firmware/{account identifier}/async/{device identifier}  
-H 'VZ-M2M-Token: {M2M token}' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer {bearer token}' \

Success Responses

Status 200

Parameter Name	Data Type	Description
accountName	string	The account identifier
requestId	string	The system assigned identifier for the request

Please note that to get this information run POST/devices/{acc]

Failure Responses

Status 400

All error messages are returned in this format:

 {
   "errorCode": "error code string",
   "errorMessage": "error message string"
}

Error codes and messages are listed on the Error Messages page, along with explanations and suggestions for corrective actions.