Edit Device Attribute

Category Filter

Edit Device Attribute

Edit device attributes like Device Name, Description, Ownership and more for devices.

Argument	Type	Description
Update_in_bulk	Boolean type	Update attributes of devices in bulk.
Update_single_device	Boolean type	Update attributes of a single device.

Note: Please note that Update_in_bulk and Update_single_device can’t be set true simultaneously.

If Update_in_bulk is set to true, the following fields can be configured.

Argument	Type	Description
Device_ID	Array	Mandatory. Specify the list of device IDs.
Device_name	Character	Optional. Specify the device name of the devices.
Asset_Tag	Character	Optional. Specify the asset tag of the devices.
Department	Character	Optional. Specify the department of the devices.
Device_Notes	Character	Optional. Specify the device notes to be added to the devices.
Description	Character	Optional. Specify the description of the devices.
Ownership	Integer	Optional. Specify the ownership of the devices. Choose 1 for Personal and 2 for Corporate.
Device_name_append_number	Boolean	Optional. If set true, append number is added to device name.
Asset_tag_append_number	Boolean	Optional. If set true, append number is added to asset tag.
Department_append_number	Boolean	Optional. If set true, append number is added to department.
Asset_tag_starting_number	Integer	Mandatory when Asset_tag_append_number is set true. Specify the starting number.
Department_starting_number	Integer	Mandatory when Depatment_append_number is set true. Specify the starting number.
Device_name_starting_number	Integer	Mandatory when Device_name_append_number is set true. Specify the starting number.
Use_suffix_for_DeviceNotes	Boolean	Optional. If set true, suffix will be added to device notes.
Use_suffix_for_Description	Boolean	Optional. If set true, suffix will be added to description.
Suffix_devicenotes	Integer	Mandatory when Use_suffix_for_DeviceNotes is set to true. Specify the starting number of the suffix.
Suffix_description	Integer	Mandatory when Use_suffix_for_Description is set to true. Specify the starting number of the suffix.

If Update_single_device is set true, specify the following parameters.

Argument	Type	Description
deviceID	Integer	Mandatory. Specify the Device ID of the device.
device_name	Character	Optional. Specify the device name of the device.
asset_tag	Character	Optional. Specify the asset tag of the device.
department	Character	Optional. Specify the department of the device.
device_notes	Character	Optional. Specify the device notes to be added to the device.
description	Character	Optional. Specify the description of the device.
ownership	Integer	Optional. Specify the ownership of the device. Choose 1 for Personal and 2 for Corporate.

curl

HTTP Request:

POST https://<portal>.hexnodemdm.com/api/v1/devices/
headers:-
Authorization: <api key>
Content-Type: application/json
Sample Post Data:-
[{
"Update_in_bulk": true ,
"Update_single_device": false,
"Device_ID":[1,2],
"Device_name ":"name", 
"Asset_Tag": "tag", 
"Department": "dept", 
"Device_Notes":"notes", 
"Ownership": 1, 
"Device_name_append_number":false, 
"Asset_tag_append_number":false, 
"Use_suffix_for_DeviceNotes":false, 
"Use_suffix_for_Description": false,
}] 


POST https://<portal>.hexnodemdm.com/api/v1/devices/
Authorization: api key
Content-Type: application/json
Sample Post Data:-
{
"Update_in_bulk": false ,
"Update_single_device": true,
"devicedata":[ 
   { "deviceID":1,
     "device_name ":"name", 
     "asset_tag": "tag", 
     "department": "dept", 
     "device_notes":"notes", 
     "ownership": 1, 
     "description": "des"} ]
}

POST https://<portal>.hexnodemdm.com/api/v1/devices/

headers:-

Authorization: <api key>

Content-Type: application/json

Sample Post Data:-

[{

"Update_in_bulk": true ,

"Update_single_device": false,

"Device_ID":[1,2],

"Device_name ":"name",

"Asset_Tag": "tag",

"Department": "dept",

"Device_Notes":"notes",

"Ownership": 1,

"Device_name_append_number":false,

"Asset_tag_append_number":false,

"Use_suffix_for_DeviceNotes":false,

"Use_suffix_for_Description": false,

}]

POST https://<portal>.hexnodemdm.com/api/v1/devices/

Authorization: api key

Content-Type: application/json

Sample Post Data:-

{

"Update_in_bulk": false ,

"Update_single_device": true,

"devicedata":[

{ "deviceID":1,

"device_name ":"name",

"asset_tag": "tag",

"department": "dept",

"device_notes":"notes",

"ownership": 1,

"description": "des"} ]

}

Shell Command:

curl -X POST -H 'Authorization: <your API key>' -H 'Content-Type: application/json' -d 
'{"Update_in_bulk": false ,"Update_single_device": true,"devicedata":[ 
{ "deviceID":1,"device_name ":"name", "asset_tag": "tag", "department": "dept", "device_notes":"notes", 
"ownership": 1, "description": "des"} ]}' https://<portal>.hexnodemdm.com/api/v1/devices/

curl -X POST -H 'Authorization:' -H 'Content-Type: application/json' -d '{"Update_in_bulk": true ,"Update_single_device": false,"Device_ID":[1,2],"Device_name ":"name", "Asset_Tag": "tag", "Department": "dept", "Device_Notes":"notes", "Ownership": 1, "Device_name_append_number":false, "Asset_tag_append_number":false, "Use_suffix_for_DeviceNotes":false, "Use_suffix_for_Description": false}' https://<portal>.hexnodemdm.com/api/v1/devices/

curl -X POST -H 'Authorization: <your API key>' -H 'Content-Type: application/json' -d

'{"Update_in_bulk": false ,"Update_single_device": true,"devicedata":[

{ "deviceID":1,"device_name ":"name", "asset_tag": "tag", "department": "dept", "device_notes":"notes",

"ownership": 1, "description": "des"} ]}' https://<portal>.hexnodemdm.com/api/v1/devices/

curl -X POST -H 'Authorization:' -H 'Content-Type: application/json' -d '{"Update_in_bulk": true ,"Update_single_device": false,"Device_ID":[1,2],"Device_name ":"name", "Asset_Tag": "tag", "Department": "dept", "Device_Notes":"notes", "Ownership": 1, "Device_name_append_number":false, "Asset_tag_append_number":false, "Use_suffix_for_DeviceNotes":false, "Use_suffix_for_Description": false}' https://<portal>.hexnodemdm.com/api/v1/devices/

HTTP Response:

Device Name, Asset Tag, Department, Description, Device Notes, and Ownership changed successfully!

1	Device Name, Asset Tag, Department, Description, Device Notes, and Ownership changed successfully!