Sensor Insights Devices

Partially update a device

PATCH
/dm/v1/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

Partially update a device's details

Partially update a device's details

accountname?string

The numeric account name, which must include leading zeros

device?
resourceidentifier?

Device identifiers, one or more are required

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X PATCH "https://example.com/dm/v1/devices" \  -H "Content-Type: application/json" \  -d '{    "accountname": "0000123456-00001",    "device": {      "accountclientid": "null",      "billingaccountid": "0000123456-00001",      "chipset": "The chipset used by the device",      "createdon": "2023-10-02T15:46:34.562Z",      "customdata": {        "additionalProp1": [          100        ],        "additionalProp2": [          100        ],        "additionalProp3": [          100        ]      },      "description": "The number of days to retaing the event data",      "esn": 223372036854775800,      "eventretention": 90,      "fields": {        "additionalProp1": "string",        "additionalProp2": "string",        "additionalProp3": "string"      },      "foreignid": "c1f178d3-eeee-ffff-gggg-0d6b7ae6022a",      "hardwareversion": "1.0",      "iccid": "The 20-digit Integrated Circuit Card ID (SIM card ID)",      "id": "33e21f61-a44a-44c9-b7a0-a63f5d19bd4f",      "imei": 223372036854775,      "imsi": 223372036854775800,      "lastupdated": "2023-10-02T15:46:34.562Z",      "licenses": [        "licenses assigned to the device"      ],      "mac": "The Media Access Control address of the device, listed on the device in the format XX-XX-XX-XX-XX-XX or XX:XX:XX:XX:XX:XX",      "manufacturer": "REOLINK",      "meid": "The 56-bit Mobile Equipment ID",      "msisdn": "The Mobile Station International Subscriber Directory Number. In the USA, this is 1+ a 10-digit phone number",      "name": "User defined name of the record",      "parentdeviceid": "BLE device ID",      "productmodel": "Model name of the device",      "providerid": "Verizon Wireless",      "qrcode": "The Quick Response (QR) code",      "refid": "P3730-1422323050860",      "refidtype": "The type of value represented by `refid`",      "serial": "The device\'s serial number",      "services": [        "configuration"      ],      "sku": "The Stock Keeping Unit (SKU) number",      "softwareversion": "the current device software version",      "state": "success",      "version": "1.0",      "versionid": "337bd2e8-eeee-ffff-gggg-5207992fd395"    },    "resourceidentifier": {      "deveui": "The unique EUI64 address of the device",      "deviceid": "The UUID of the device",      "esn": 223372036854775800,      "iccid": "The 20-digit Integrated Circuit Card ID (SIM card ID)",      "imei": 223372036854775,      "imsi": 223372036854775800,      "mac": "The Media Access Control address of the device, listed on the device in the format XX-XX-XX-XX-XX-XX or XX:XX:XX:XX:XX:XX",      "manufacturer": "REOLINK",      "meid": "The 56-bit Mobile Equipment ID",      "msisdn": "The Mobile Station International Subscriber Directory Number. In the USA, this is 1+ a 10-digit phone number",      "node_uuid": "The UUID of the node the device is associated with",      "qrcode": "The Quick Response (QR) code",      "serial": "The device\'s serial number"    }  }'
{  "accountclientid": "null",  "billingaccountid": "0000123456-00001",  "chipset": "The chipset used by the device",  "createdon": "2023-10-02T15:46:34.562Z",  "customdata": {    "property1": null,    "property2": null  },  "description": "a short description",  "esn": 0,  "fields": {    "additionalProp1": "string",    "additionalProp2": "string",    "additionalProp3": "string"  },  "foreignid": "c1f178d3-eeee-ffff-gggg-0d6b7ae6022a",  "hardwareversion": "1.0",  "iccid": "The 20-digit ICCID",  "id": "string",  "imei": 0,  "imsi": 0,  "lastupdated": "2023-10-02T15:46:34.562Z",  "licenses": [    "string"  ],  "mac": "The Media Access Control (MAC) address",  "manufacturer": "REOLINK",  "meid": "The 56-bit Mobile Equipment ID",  "msisdn": "The Mobile Station International Subscriber Directory Number",  "name": "name of the record",  "parentdeviceid": "a gateway UUID",  "productmodel": "Model name of the device",  "providerid": "Verizon Wireless",  "qrcode": "The Quick Response (QR) code",  "refid": "P3730-1422323050860",  "refidtype": "The type of value represented by `refid`",  "serial": "The device's serial number",  "services": [    "string"  ],  "sku": "The Stock Keeping Unit (SKU) number",  "softwareversion": "the current device software version",  "state": "success",  "version": "1.0",  "versionid": "337bd2e8-eeee-ffff-gggg-5207992fd395",  "eventretention": 90}