thingspace_oauth vz-m2m-session_token This is where the ThingSpace token, from Getting Started is used
In: header
The VZ-M2M session token from Getting Started
In: header
application/json
Partially update a device's details
TypeScript Definitions
Use the request body type in TypeScript.
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": [ 0 ], "property2": [ 0 ] }, "description": "a short description", "esn": 223372036854775800, "fields": { "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" }, "foreignid": "c1f178d3-eeee-ffff-gggg-0d6b7ae6022a", "hardwareversion": "1.0", "iccid": "The 20-digit ICCID", "id": "string", "imei": 223372036854775, "imsi": 223372036854775800, "lastupdated": "2023-10-02T15:46:34.562Z", "licenses": [ "licenses assigned to the device" ], "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": [ "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", "eventretention": 90}{ "error": "bad_request", "error_description": "The request is missing content.", "cause": "Request is missing required body content"}{ "error": "Error name or code", "error_description": "A longer error description.", "cause": "A cause for the error"}{ "error": "forbidden", "error_description": "The data does not belong to the provided billing account.", "cause": "Requested service is forbidden"}{ "error": "not_found", "error_description": "Requested information is not registered.", "cause": "Requested service not found"}{ "error": "Error name or code", "error_description": "A longer error description.", "cause": "A cause for the error"}{ "error": "Error name or code", "error_description": "A longer error description.", "cause": "A cause for the error"}{ "error": "Error name or code", "error_description": "A longer error description.", "cause": "A cause for the error"}{ "error": "internal_server_error", "error_description": "Failed to create record.", "cause": "Requested service failed due to internal error"}{ "error": "Error name or code", "error_description": "A longer error description.", "cause": "A cause for the error"}The numeric account name, which must include leading zeros
Device identifiers, one or more are required