Skip to content

Asset Computer

Hardware and Software details of all the computers in your organization can be tracked under Computer

Attributes

computer_system (JSONObject)
Holds system specific data
show attribute

computer_system (JSONObject)
Holds system specific data

sm_bios_version (string)
System Management Bios version of the computer system

sm_bios_version (string)
System Management Bios version of the computer system

Example 

Sample Content

bios_version (string)
Bios version of the computer system

bios_version (string)
Bios version of the computer system

Example 

Sample Content

service_tag (string)
Unique service tag of the computer system

service_tag (string)
Unique service tag of the computer system

Example 

Sample Content

system_manufacturer (string)
Manufacturer of the computer system

system_manufacturer (string)
Manufacturer of the computer system

Example 

Sample Content

bios_name (string)
Bios name of the computer system

bios_name (string)
Bios name of the computer system

Example 

Sample Content

ram_slots_count (string)read only
RAM slot counts of the computer system

ram_slots_count (string)
RAM slot counts of the computer system

Example 

Sample Content

bios_manufacturer (string)
Name of the company that created the BIOS firmware of the computer system

bios_manufacturer (string)
Name of the company that created the BIOS firmware of the computer system

Example 

Sample Content

bios_date (string)
Bios date of the computer system

bios_date (string)
Bios date of the computer system

Example 

Sample Content

model (string)
Model of the computer system

model (string)
Model of the computer system

Example 

Sample Content

operating_system (JSONObject)
Holds operating system specific data
show attribute

operating_system (JSONObject)
Holds operating system specific data

service_pack (string)
Details of the service packs identified on the computer

service_pack (string)
Details of the service packs identified on the computer

Example 

Sample Content

version (string)
Version of the operating system

version (string)
Version of the operating system

Example 

Sample Content

license_type (string)
License type of the operating system

license_type (string)
License type of the operating system

Example 

Sample Content

build_number (string)
Build number of the operating system

build_number (string)
Build number of the operating system

Example 

Sample Content

language (string)
Language of the operating system

language (string)
Language of the operating system

Example 

Sample Content

os (string)
Name of the operating system

os (string)
Name of the operating system

Example 

Sample Content

keyboard (JSONObject)
Displays properties of the keyboard
show attribute

keyboard (JSONObject)
Displays properties of the keyboard

keyboard_type (string)
Type of the keyboard

keyboard_type (string)
Type of the keyboard

Example 

Sample Content

keyboard_serial_number (string)
Serial number of the keyboard

keyboard_serial_number (string)
Serial number of the keyboard

Example 

Sample Content

keyboard_manufacturer (string)
Manufacturer of the keyboard

keyboard_manufacturer (string)
Manufacturer of the keyboard

Example 

Sample Content

memory (JSONObject)
Displays properties of the storage
show attribute

memory (JSONObject)
Displays properties of the storage

physical_memory (long)
Displays physical memory in bytes

physical_memory (long)
Displays physical memory in bytes

Example 

234759602834500

virtual_memory (long)
Displays virtual memory in bytes

virtual_memory (long)
Displays virtual memory in bytes

Example 

234759602834500

domain (domain)
Domain of the computer

domain (domain)
Domain of the computer

id (long)
Unique identifier to identify the computer

id (long)
Unique identifier to identify the computer

Example 

2134567890

More Attributes Expand all

monitors (workstation_monitor)

Indicates the monitors discovered along with a computer

monitors (workstation_monitor)
Indicates the monitors discovered along with a computer

Example 

{
  "monitors": {
    "name": "test-monitors",
    "id": "234567890123456"
  }
}

is_remote_control_prompt_enabled (boolean)

Boolean value indicating whether the remote control prompt is enabled for the computer or not

is_remote_control_prompt_enabled (boolean)
Boolean value indicating whether the remote control prompt is enabled for the computer or not

comments (string)

Comments added for the computer

comments (string)
Comments added for the computer

Example 

Sample Content

last_logged_user (string)

Last logged in user of the computer

last_logged_user (string)
Last logged in user of the computer

Example 

Sample Content

sound_card (JSONObject)

Displays properties of the sound card
show attribute

sound_card (JSONObject)
Displays properties of the sound card

sound_card_name (string)

Name of the sound card

sound_card_name (string)
Name of the sound card

Example 

Sample Content

customer (customer)

Denotes the customer to which this request belongs

customer (customer)
Denotes the customer to which this request belongs

Example 

{
  "customer": {
    "name": "Customer ABC",
    "id": "2000000040924",
    "is_msp": false
  }
}

Add Asset Computer

This operation helps you add computers.

Url

<service domain|custom domain>/app/<portal>/api/v3/asset_computers

Attributes

computer_system (JSONObject)
Holds system specific data
show attribute

computer_system (JSONObject)
Holds system specific data

sm_bios_version (string)
System Management Bios version of the computer system

sm_bios_version (string)
System Management Bios version of the computer system

Example 

Sample Content

bios_version (string)
Bios version of the computer system

bios_version (string)
Bios version of the computer system

Example 

Sample Content

service_tag (string)
Unique service tag of the computer system

service_tag (string)
Unique service tag of the computer system

Example 

Sample Content

system_manufacturer (string)
Manufacturer of the computer system

system_manufacturer (string)
Manufacturer of the computer system

Example 

Sample Content

bios_name (string)
Bios name of the computer system

bios_name (string)
Bios name of the computer system

Example 

Sample Content

ram_slots_count (string)read only
RAM slot counts of the computer system

ram_slots_count (string)
RAM slot counts of the computer system

Example 

Sample Content

bios_manufacturer (string)
Name of the company that created the BIOS firmware of the computer system

bios_manufacturer (string)
Name of the company that created the BIOS firmware of the computer system

Example 

Sample Content

bios_date (string)
Bios date of the computer system

bios_date (string)
Bios date of the computer system

Example 

Sample Content

model (string)
Model of the computer system

model (string)
Model of the computer system

Example 

Sample Content

operating_system (JSONObject)
Holds operating system specific data
show attribute

operating_system (JSONObject)
Holds operating system specific data

service_pack (string)
Details of the service packs identified on the computer

service_pack (string)
Details of the service packs identified on the computer

Example 

Sample Content

version (string)
Version of the operating system

version (string)
Version of the operating system

Example 

Sample Content

license_type (string)
License type of the operating system

license_type (string)
License type of the operating system

Example 

Sample Content

build_number (string)
Build number of the operating system

build_number (string)
Build number of the operating system

Example 

Sample Content

language (string)
Language of the operating system

language (string)
Language of the operating system

Example 

Sample Content

os (string)
Name of the operating system

os (string)
Name of the operating system

Example 

Sample Content

keyboard (JSONObject)
Displays properties of the keyboard
show attribute

keyboard (JSONObject)
Displays properties of the keyboard

keyboard_type (string)
Type of the keyboard

keyboard_type (string)
Type of the keyboard

Example 

Sample Content

keyboard_serial_number (string)
Serial number of the keyboard

keyboard_serial_number (string)
Serial number of the keyboard

Example 

Sample Content

keyboard_manufacturer (string)
Manufacturer of the keyboard

keyboard_manufacturer (string)
Manufacturer of the keyboard

Example 

Sample Content

memory (JSONObject)
Displays properties of the storage
show attribute

memory (JSONObject)
Displays properties of the storage

physical_memory (long)
Displays physical memory in bytes

physical_memory (long)
Displays physical memory in bytes

Example 

234759602834500

virtual_memory (long)
Displays virtual memory in bytes

virtual_memory (long)
Displays virtual memory in bytes

Example 

234759602834500

domain (domain)
Domain of the computer

domain (domain)
Domain of the computer

id (long)
Unique identifier to identify the computer

id (long)
Unique identifier to identify the computer

Example 

2134567890

More Attributes Expand all

is_remote_control_prompt_enabled (boolean)

Boolean value indicating whether the remote control prompt is enabled for the computer or not

is_remote_control_prompt_enabled (boolean)
Boolean value indicating whether the remote control prompt is enabled for the computer or not

is_server (boolean)read only

Boolean value indicating whether this workstation is a server or not

is_server (boolean)
Boolean value indicating whether this workstation is a server or not

last_logged_user (string)

Last logged in user of the computer

last_logged_user (string)
Last logged in user of the computer

Example 

Sample Content

sound_card (JSONObject)

Displays properties of the sound card
show attribute

sound_card (JSONObject)
Displays properties of the sound card

sound_card_name (string)

Name of the sound card

sound_card_name (string)
Name of the sound card

Example 

Sample Content

customer (customer)

Denotes the customer to which this request belongs

customer (customer)
Denotes the customer to which this request belongs

Example 

{
  "customer": {
    "name": "Customer ABC",
    "id": "2000000040924",
    "is_msp": false
  }
}


$ curl <service domain|custom domain>/app/<portal>/api/v3/asset_computers\
      -X POST\
      -H "Accept: application/vnd.manageengine.sdp.v3+json"\
      -H "Authorization: Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"\
      -H "Content-Type: application/x-www-form-urlencoded"\
      -d input_data='{
  "asset_computer": {
    "name": "WS-IND-456",
    "asset_tag": "AT-WS-456",
    "serial_number": "PFRMQ08",
    "product": {
      "name": "Latitude 7440"
    },
    "product_type": {
      "name": "Workstation"
    },
    "vendor": {
      "name": "Dell India Pvt Ltd"
    },
    "site": {
      "name": "Bangalore"
    },
    "user": {
      "email_id": "rita@acme.com"
    },
    "computer_system": {
      "system_manufacturer": "Dell Inc.",
      "model": "Latitude 7440",
      "service_tag": "JX9PMQ8"
    },
    "operating_system": {
      "os": "Windows 11 Enterprise",
      "version": "23H2",
      "build_number": "22631.4317"
    }
  }
}'

// Deluge Sample script
url = "<service domain|custom domain>/app/<portal>/api/v3/asset_computers";
headers = {"Accept":"application/vnd.manageengine.sdp.v3+json",
           "Content-Type": "application/x-www-form-urlencoded",
           "Authorization": "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"};
input_data = {
  "asset_computer": {
    "name": "WS-IND-456",
    "asset_tag": "AT-WS-456",
    "serial_number": "PFRMQ08",
    "product": {
      "name": "Latitude 7440"
    },
    "product_type": {
      "name": "Workstation"
    },
    "vendor": {
      "name": "Dell India Pvt Ltd"
    },
    "site": {
      "name": "Bangalore"
    },
    "user": {
      "email_id": "rita@acme.com"
    },
    "computer_system": {
      "system_manufacturer": "Dell Inc.",
      "model": "Latitude 7440",
      "service_tag": "JX9PMQ8"
    },
    "operating_system": {
      "os": "Windows 11 Enterprise",
      "version": "23H2",
      "build_number": "22631.4317"
    }
  }
};
params = {"input_data": input_data};
response = invokeurl
[
    url: url
    type: POST
    parameters: params
    headers: headers
];
info response;

#Powershell version - 5.1
$url = "<service domain|custom domain>/app/<portal>/api/v3/asset_computers"
$headers = @{ "Accept" = "application/vnd.manageengine.sdp.v3+json"
    "Authorization" = "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"
    "Content-Type" = "application/x-www-form-urlencoded"}
$input_data = @'
{
  "asset_computer": {
    "name": "WS-IND-456",
    "asset_tag": "AT-WS-456",
    "serial_number": "PFRMQ08",
    "product": {
      "name": "Latitude 7440"
    },
    "product_type": {
      "name": "Workstation"
    },
    "vendor": {
      "name": "Dell India Pvt Ltd"
    },
    "site": {
      "name": "Bangalore"
    },
    "user": {
      "email_id": "rita@acme.com"
    },
    "computer_system": {
      "system_manufacturer": "Dell Inc.",
      "model": "Latitude 7440",
      "service_tag": "JX9PMQ8"
    },
    "operating_system": {
      "os": "Windows 11 Enterprise",
      "version": "23H2",
      "build_number": "22631.4317"
    }
  }
}
'@
$data = @{ 'input_data' = $input_data}
$response = Invoke-RestMethod -Uri $url -Method post -Body $data -Headers $headers
$response

#Python version - 3.10
from urllib.error import HTTPError
from urllib.parse import urlencode
from urllib.request import urlopen,Request

url = "<service domain|custom domain>/app/<portal>/api/v3/asset_computers"
headers ={"Accept": "application/vnd.manageengine.sdp.v3+json", 
          "Authorization" : "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx", 
          "Content-Type" : "application/x-www-form-urlencoded"}
input_data = '''{
  "asset_computer": {
    "name": "WS-IND-456",
    "asset_tag": "AT-WS-456",
    "serial_number": "PFRMQ08",
    "product": {
      "name": "Latitude 7440"
    },
    "product_type": {
      "name": "Workstation"
    },
    "vendor": {
      "name": "Dell India Pvt Ltd"
    },
    "site": {
      "name": "Bangalore"
    },
    "user": {
      "email_id": "rita@acme.com"
    },
    "computer_system": {
      "system_manufacturer": "Dell Inc.",
      "model": "Latitude 7440",
      "service_tag": "JX9PMQ8"
    },
    "operating_system": {
      "os": "Windows 11 Enterprise",
      "version": "23H2",
      "build_number": "22631.4317"
    }
  }
}'''
data = urlencode({"input_data":input_data}).encode()
httprequest = Request(url, headers=headers,data=data, method="POST")
try:
    with urlopen(httprequest) as response:
        print(response.read().decode())
except HTTPError as e:
    print(e.read().decode())

{
  "response_status": [{ "status_code": 2000, "status": "success" }],
  "asset_computer": {
    "id"            : "12000000099001",
    "name"          : "WS-IND-456",
    "asset_tag"     : "AT-WS-456",
    "serial_number" : "PFRMQ08",
    "computer_system": { "system_manufacturer": "Dell Inc.", "model": "Latitude 7440", "service_tag": "JX9PMQ8" },
    "operating_system": { "os": "Windows 11 Enterprise", "version": "23H2", "build_number": "22631.4317" },
    "created_time"  : { "value": "1747312033000", "display_value": "May 15, 2026 06:30 PM" }
  }
}

Edit Asset Computer

This operation helps you Edit computers.

Url

<service domain|custom domain>/app/<portal>/api/v3/asset_computers/{id}

Attributes

computer_system (JSONObject)
Holds system specific data
show attribute

computer_system (JSONObject)
Holds system specific data

sm_bios_version (string)
System Management Bios version of the computer system

sm_bios_version (string)
System Management Bios version of the computer system

Example 

Sample Content

bios_version (string)
Bios version of the computer system

bios_version (string)
Bios version of the computer system

Example 

Sample Content

service_tag (string)
Unique service tag of the computer system

service_tag (string)
Unique service tag of the computer system

Example 

Sample Content

system_manufacturer (string)
Manufacturer of the computer system

system_manufacturer (string)
Manufacturer of the computer system

Example 

Sample Content

bios_name (string)
Bios name of the computer system

bios_name (string)
Bios name of the computer system

Example 

Sample Content

ram_slots_count (string)read only
RAM slot counts of the computer system

ram_slots_count (string)
RAM slot counts of the computer system

Example 

Sample Content

bios_manufacturer (string)
Name of the company that created the BIOS firmware of the computer system

bios_manufacturer (string)
Name of the company that created the BIOS firmware of the computer system

Example 

Sample Content

bios_date (string)
Bios date of the computer system

bios_date (string)
Bios date of the computer system

Example 

Sample Content

model (string)
Model of the computer system

model (string)
Model of the computer system

Example 

Sample Content

operating_system (JSONObject)
Holds operating system specific data
show attribute

operating_system (JSONObject)
Holds operating system specific data

service_pack (string)
Details of the service packs identified on the computer

service_pack (string)
Details of the service packs identified on the computer

Example 

Sample Content

version (string)
Version of the operating system

version (string)
Version of the operating system

Example 

Sample Content

license_type (string)
License type of the operating system

license_type (string)
License type of the operating system

Example 

Sample Content

build_number (string)
Build number of the operating system

build_number (string)
Build number of the operating system

Example 

Sample Content

language (string)
Language of the operating system

language (string)
Language of the operating system

Example 

Sample Content

os (string)
Name of the operating system

os (string)
Name of the operating system

Example 

Sample Content

keyboard (JSONObject)
Displays properties of the keyboard
show attribute

keyboard (JSONObject)
Displays properties of the keyboard

keyboard_type (string)
Type of the keyboard

keyboard_type (string)
Type of the keyboard

Example 

Sample Content

keyboard_serial_number (string)
Serial number of the keyboard

keyboard_serial_number (string)
Serial number of the keyboard

Example 

Sample Content

keyboard_manufacturer (string)
Manufacturer of the keyboard

keyboard_manufacturer (string)
Manufacturer of the keyboard

Example 

Sample Content

memory (JSONObject)
Displays properties of the storage
show attribute

memory (JSONObject)
Displays properties of the storage

physical_memory (long)
Displays physical memory in bytes

physical_memory (long)
Displays physical memory in bytes

Example 

234759602834500

virtual_memory (long)
Displays virtual memory in bytes

virtual_memory (long)
Displays virtual memory in bytes

Example 

234759602834500

domain (domain)
Domain of the computer

domain (domain)
Domain of the computer

id (long)
Unique identifier to identify the computer

id (long)
Unique identifier to identify the computer

Example 

2134567890

More Attributes Expand all

monitors (workstation_monitor)

Indicates the monitors discovered along with a computer

monitors (workstation_monitor)
Indicates the monitors discovered along with a computer

Example 

{
  "monitors": {
    "name": "test-monitors",
    "id": "234567890123456"
  }
}

is_remote_control_prompt_enabled (boolean)

Boolean value indicating whether the remote control prompt is enabled for the computer or not

is_remote_control_prompt_enabled (boolean)
Boolean value indicating whether the remote control prompt is enabled for the computer or not

is_server (boolean)read only

Boolean value indicating whether this workstation is a server or not

is_server (boolean)
Boolean value indicating whether this workstation is a server or not

last_logged_user (string)

Last logged in user of the computer

last_logged_user (string)
Last logged in user of the computer

Example 

Sample Content

sound_card (JSONObject)

Displays properties of the sound card
show attribute

sound_card (JSONObject)
Displays properties of the sound card

sound_card_name (string)

Name of the sound card

sound_card_name (string)
Name of the sound card

Example 

Sample Content

customer (customer)

Denotes the customer to which this request belongs

customer (customer)
Denotes the customer to which this request belongs

Example 

{
  "customer": {
    "name": "Customer ABC",
    "id": "2000000040924",
    "is_msp": false
  }
}


$ curl <service domain|custom domain>/app/<portal>/api/v3/asset_computers/{id}\
      -X PUT\ 
      -H "Accept: application/vnd.manageengine.sdp.v3+json"\
      -H "Authorization: Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"\
      -H "Content-Type: application/x-www-form-urlencoded"\
      -d input_data='{
  "asset_computer": {
    "operating_system": {
      "os": "Windows 11 Enterprise",
      "version": "23H2",
      "build_number": "22631.4317",
      "service_pack": "-"
    },
    "computer_system": {
      "threads_per_core": 2,
      "logical_cpu_count": 16,
      "total_cpu_cores": 8
    }
  }
}'

// Deluge Sample script
url = "<service domain|custom domain>/app/<portal>/api/v3/asset_computers/{id}";
headers = {"Accept":"application/vnd.manageengine.sdp.v3+json",
           "Content-Type": "application/x-www-form-urlencoded",
           "Authorization": "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"};
input_data = {
  "asset_computer": {
    "operating_system": {
      "os": "Windows 11 Enterprise",
      "version": "23H2",
      "build_number": "22631.4317",
      "service_pack": "-"
    },
    "computer_system": {
      "threads_per_core": 2,
      "logical_cpu_count": 16,
      "total_cpu_cores": 8
    }
  }
};
params = {"input_data": input_data};
response = invokeurl
[
    url: url
    type: PUT
    parameters: params
    headers: headers
];
info response;

#Powershell version - 5.1
$url = "<service domain|custom domain>/app/<portal>/api/v3/asset_computers/{id}"
$headers = @{"Accept": "application/vnd.manageengine.sdp.v3+json", 
          "Authorization" : "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx", 
          "Content-Type" : "application/x-www-form-urlencoded"}
$input_data = @'
{
  "asset_computer": {
    "operating_system": {
      "os": "Windows 11 Enterprise",
      "version": "23H2",
      "build_number": "22631.4317",
      "service_pack": "-"
    },
    "computer_system": {
      "threads_per_core": 2,
      "logical_cpu_count": 16,
      "total_cpu_cores": 8
    }
  }
}
'@
$data = @{ 'input_data' = $input_data}
$response = Invoke-RestMethod -Uri $url -Method put -Body $data -Headers $headers
$response

#Python version - 3.10
from urllib.error import HTTPError
from urllib.parse import urlencode
from urllib.request import urlopen,Request

url = "<service domain|custom domain>/app/<portal>/api/v3/asset_computers/{id}"
headers ={"Accept": "application/vnd.manageengine.sdp.v3+json", 
          "Authorization" : "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx", 
          "Content-Type" : "application/x-www-form-urlencoded"}
input_data = '''{
  "asset_computer": {
    "operating_system": {
      "os": "Windows 11 Enterprise",
      "version": "23H2",
      "build_number": "22631.4317",
      "service_pack": "-"
    },
    "computer_system": {
      "threads_per_core": 2,
      "logical_cpu_count": 16,
      "total_cpu_cores": 8
    }
  }
}'''
data = urlencode({"input_data":input_data}).encode()
httprequest = Request(url, headers=headers,data=data, method="PUT")
try:
    with urlopen(httprequest) as response:
        print(response.read().decode())
except HTTPError as e:
    print(e.read().decode())

{
  "response_status": [{ "status_code": 2000, "status": "success" }],
  "asset_computer": {
    "id"             : "12000000099001",
    "operating_system": { "os": "Windows 11 Enterprise", "version": "23H2", "build_number": "22631.4317" },
    "computer_system": { "threads_per_core": 2, "logical_cpu_count": 16, "total_cpu_cores": 8 },
    "last_updated_time": { "value": "1747312500000", "display_value": "May 15, 2026 06:38 PM" }
  }
}

Get Asset Computer

This operation helps you Get computers.

Url

<service domain|custom domain>/app/<portal>/api/v3/asset_computers/{id}

Attributes

computer_system (JSONObject)
Holds system specific data
show attribute

computer_system (JSONObject)
Holds system specific data

sm_bios_version (string)
System Management Bios version of the computer system

sm_bios_version (string)
System Management Bios version of the computer system

Example 

Sample Content

bios_version (string)
Bios version of the computer system

bios_version (string)
Bios version of the computer system

Example 

Sample Content

service_tag (string)
Unique service tag of the computer system

service_tag (string)
Unique service tag of the computer system

Example 

Sample Content

system_manufacturer (string)
Manufacturer of the computer system

system_manufacturer (string)
Manufacturer of the computer system

Example 

Sample Content

bios_name (string)
Bios name of the computer system

bios_name (string)
Bios name of the computer system

Example 

Sample Content

ram_slots_count (string)read only
RAM slot counts of the computer system

ram_slots_count (string)
RAM slot counts of the computer system

Example 

Sample Content

bios_manufacturer (string)
Name of the company that created the BIOS firmware of the computer system

bios_manufacturer (string)
Name of the company that created the BIOS firmware of the computer system

Example 

Sample Content

bios_date (string)
Bios date of the computer system

bios_date (string)
Bios date of the computer system

Example 

Sample Content

model (string)
Model of the computer system

model (string)
Model of the computer system

Example 

Sample Content

operating_system (JSONObject)
Holds operating system specific data
show attribute

operating_system (JSONObject)
Holds operating system specific data

service_pack (string)
Details of the service packs identified on the computer

service_pack (string)
Details of the service packs identified on the computer

Example 

Sample Content

version (string)
Version of the operating system

version (string)
Version of the operating system

Example 

Sample Content

license_type (string)
License type of the operating system

license_type (string)
License type of the operating system

Example 

Sample Content

build_number (string)
Build number of the operating system

build_number (string)
Build number of the operating system

Example 

Sample Content

language (string)
Language of the operating system

language (string)
Language of the operating system

Example 

Sample Content

os (string)
Name of the operating system

os (string)
Name of the operating system

Example 

Sample Content

keyboard (JSONObject)
Displays properties of the keyboard
show attribute

keyboard (JSONObject)
Displays properties of the keyboard

keyboard_type (string)
Type of the keyboard

keyboard_type (string)
Type of the keyboard

Example 

Sample Content

keyboard_serial_number (string)
Serial number of the keyboard

keyboard_serial_number (string)
Serial number of the keyboard

Example 

Sample Content

keyboard_manufacturer (string)
Manufacturer of the keyboard

keyboard_manufacturer (string)
Manufacturer of the keyboard

Example 

Sample Content

memory (JSONObject)
Displays properties of the storage
show attribute

memory (JSONObject)
Displays properties of the storage

physical_memory (long)
Displays physical memory in bytes

physical_memory (long)
Displays physical memory in bytes

Example 

234759602834500

virtual_memory (long)
Displays virtual memory in bytes

virtual_memory (long)
Displays virtual memory in bytes

Example 

234759602834500

domain (domain)
Domain of the computer

domain (domain)
Domain of the computer

id (long)
Unique identifier to identify the computer

id (long)
Unique identifier to identify the computer

Example 

2134567890

More Attributes Expand all

monitors (workstation_monitor)

Indicates the monitors discovered along with a computer

monitors (workstation_monitor)
Indicates the monitors discovered along with a computer

Example 

{
  "monitors": {
    "name": "test-monitors",
    "id": "234567890123456"
  }
}

is_remote_control_prompt_enabled (boolean)

Boolean value indicating whether the remote control prompt is enabled for the computer or not

is_remote_control_prompt_enabled (boolean)
Boolean value indicating whether the remote control prompt is enabled for the computer or not

is_server (boolean)read only

Boolean value indicating whether this workstation is a server or not

is_server (boolean)
Boolean value indicating whether this workstation is a server or not

last_logged_user (string)

Last logged in user of the computer

last_logged_user (string)
Last logged in user of the computer

Example 

Sample Content

sound_card (JSONObject)

Displays properties of the sound card
show attribute

sound_card (JSONObject)
Displays properties of the sound card

sound_card_name (string)

Name of the sound card

sound_card_name (string)
Name of the sound card

Example 

Sample Content

customer (customer)

Denotes the customer to which this request belongs

customer (customer)
Denotes the customer to which this request belongs

Example 

{
  "customer": {
    "name": "Customer ABC",
    "id": "2000000040924",
    "is_msp": false
  }
}


$ curl -G <service domain|custom domain>/app/<portal>/api/v3/asset_computers/{id}\
      -X GET\
      -H "Accept: application/vnd.manageengine.sdp.v3+json"\
      -H "Authorization: Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"\
      -H "Content-Type: application/x-www-form-urlencoded"

// Deluge Sample script
url = "<service domain|custom domain>/app/<portal>/api/v3/asset_computers/{id}";
headers = {"Accept":"application/vnd.manageengine.sdp.v3+json",
           "Content-Type": "application/x-www-form-urlencoded",
           "Authorization": "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"};          
response = invokeurl
[
    url: url
    type: GET
    headers: headers
];
info response;

#Powershell version - 5.1
$url = "<service domain|custom domain>/app/<portal>/api/v3/asset_computers/{id}"
$headers = @{ "Accept" = "application/vnd.manageengine.sdp.v3+json"
    "Authorization" = "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"
    "Content-Type" = "application/x-www-form-urlencoded"}  
$response = Invoke-RestMethod -Uri $url -Method get -Headers $headers 
$response

#Python version - 3.8
#This script requires requests module installed in python.
from urllib.error import HTTPError
from urllib.parse import urlencode
from urllib.request import urlopen,Request

url = "<service domain|custom domain>/app/<portal>/api/v3/asset_computers/{id}"
headers ={"Accept": "application/vnd.manageengine.sdp.v3+json", 
          "Authorization" : "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx", 
          "Content-Type" : "application/x-www-form-urlencoded"}
httprequest = Request(url, headers=headers)
try:
    with urlopen(httprequest) as response:
        print(response.read().decode())
except HTTPError as e:
    print(e.read().decode())

{
  "response_status": [{ "status_code": 2000, "status": "success" }],
  "asset_computer": {
    "id"            : "12000000099001",
    "name"          : "WS-IND-456",
    "is_server"     : false,
    "vm_type"       : 0,
    "operating_system": { "os": "Windows 11 Enterprise", "version": "23H2", "build_number": "22631.4317" },
    "computer_system": { "threads_per_core": 2, "logical_cpu_count": 16, "total_cpu_cores": 8 },
    "memory":           { "physical_memory": 17179869184, "virtual_memory": 19327352832 },
    "processors":       [ { "id": "12000000099001", "name": "Intel Core i7-1365U" } ],
    "hard_disks":       [ { "id": "12000000099002", "model_number": "NVMe KIOXIA KXG80" } ],
    "logical_drives":   [ { "id": "12000000099003", "drive_name": "C:" } ],
    "software":         [ { "id": "12000000099004", "name": "Microsoft Office" } ],
    "user":             { "id": "12000000099005", "email_id": "rita@acme.com" },
    "site":             { "id": "12000000099006", "name": "Bangalore" },
    "state":            { "id": "12000000099007", "name": "In Use" }
  }
}

Get List Asset Computer

This operation helps you Get List of computers.

Url

<service domain|custom domain>/app/<portal>/api/v3/asset_computers

Attributes

computer_system (JSONObject)
Holds system specific data
show attribute

computer_system (JSONObject)
Holds system specific data

service_tag (string)
Unique service tag of the computer system

service_tag (string)
Unique service tag of the computer system

Example 

Sample Content

model (string)
Model of the computer system

model (string)
Model of the computer system

Example 

Sample Content

id (long)
Unique identifier to identify the computer

id (long)
Unique identifier to identify the computer

Example 

2134567890

name (string)
No Description

name (string)
A text in a plain format. No rich text or new line characters allowed.

Example 

Sample Content

last_logged_user (string)
Last logged in user of the computer

last_logged_user (string)
Last logged in user of the computer

Example 

Sample Content

customer (customer)

Denotes the customer to which this request belongs

customer (customer)
Denotes the customer to which this request belongs

Example 

{
  "customer": {
    "name": "Customer ABC",
    "id": "2000000040924",
    "is_msp": false
  }
}


$ curl -G <service domain|custom domain>/app/<portal>/api/v3/asset_computers\
      -X GET\ 
      -H "Accept: application/vnd.manageengine.sdp.v3+json"\
      -H "Authorization: Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"\
      -H "Content-Type: application/x-www-form-urlencoded"\
      --data-urlencode input_data='{
  "list_info": {
    "row_count": 50,
    "start_index": 1,
    "sort_field": "last_updated_time",
    "sort_order": "desc",
    "get_total_count": true,
    "search_criteria": [
      {
        "field": "operating_system.os",
        "condition": "contains",
        "value": "Windows 11"
      },
      {
        "field": "computer_system.system_manufacturer",
        "condition": "is",
        "value": "Dell Inc.",
        "logical_operator": "AND"
      }
    ]
  }
}'

// Deluge Sample script
url = "<service domain|custom domain>/app/<portal>/api/v3/asset_computers";
headers = {"Accept":"application/vnd.manageengine.sdp.v3+json",
           "Content-Type": "application/x-www-form-urlencoded",
           "Authorization": "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"};
input_data = {
  "list_info": {
    "row_count": 50,
    "start_index": 1,
    "sort_field": "last_updated_time",
    "sort_order": "desc",
    "get_total_count": true,
    "search_criteria": [
      {
        "field": "operating_system.os",
        "condition": "contains",
        "value": "Windows 11"
      },
      {
        "field": "computer_system.system_manufacturer",
        "condition": "is",
        "value": "Dell Inc.",
        "logical_operator": "AND"
      }
    ]
  }
};
params = {"input_data":input_data};           
response = invokeurl
[
    url: url
    type: GET
    parameters:params
    headers: headers
];
info response;

#Powershell version - 5.1
$url = "<service domain|custom domain>/app/<portal>/api/v3/asset_computers"
$headers = @{ "Accept" = "application/vnd.manageengine.sdp.v3+json"
    "Authorization" = "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"
    "Content-Type" = "application/x-www-form-urlencoded"}
$input_data = @'{
  "list_info": {
    "row_count": 50,
    "start_index": 1,
    "sort_field": "last_updated_time",
    "sort_order": "desc",
    "get_total_count": true,
    "search_criteria": [
      {
        "field": "operating_system.os",
        "condition": "contains",
        "value": "Windows 11"
      },
      {
        "field": "computer_system.system_manufacturer",
        "condition": "is",
        "value": "Dell Inc.",
        "logical_operator": "AND"
      }
    ]
  }
}'@
$data = @{ 'input_data' = $input_data}    
$response = Invoke-RestMethod -Uri $url -Method get -Body $data -Headers $headers 
$response

#Python version - 3.8
#This script requires requests module installed in python.
from urllib.error import HTTPError
from urllib.parse import urlencode
from urllib.request import urlopen,Request

url = "<service domain|custom domain>/app/<portal>/api/v3/asset_computers"
headers ={"Accept": "application/vnd.manageengine.sdp.v3+json", 
          "Authorization" : "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx", 
          "Content-Type" : "application/x-www-form-urlencoded"}
input_data = '''{
  "list_info": {
    "row_count": 50,
    "start_index": 1,
    "sort_field": "last_updated_time",
    "sort_order": "desc",
    "get_total_count": true,
    "search_criteria": [
      {
        "field": "operating_system.os",
        "condition": "contains",
        "value": "Windows 11"
      },
      {
        "field": "computer_system.system_manufacturer",
        "condition": "is",
        "value": "Dell Inc.",
        "logical_operator": "AND"
      }
    ]
  }
}'''       
url += "?" + urlencode({"input_data":input_data})
httprequest = Request(url, headers=headers)
try:
    with urlopen(httprequest) as response:
        print(response.read().decode())
except HTTPError as e:
    print(e.read().decode())

{
  "response_status": [{ "status_code": 2000, "status": "success" }],
  "list_info": { "has_more_rows": true, "start_index": 1, "row_count": 50, "total_count": 184 },
  "asset_computers": [
    { "id": "12000000099001", "name": "WS-IND-456", "service_tag": "JX9PMQ8",
      "operating_system": { "os": "Windows 11 Enterprise" } },
    { "id": "12000000099045", "name": "WS-IND-471", "service_tag": "8FRMD12",
      "operating_system": { "os": "Windows 11 Pro" } }
  ]
}

Delete Asset Computer

This operation helps you delete computers.

Url

<service domain|custom domain>/app/<portal>/api/v3/asset_computers/{id}


$ curl <service domain|custom domain>/app/<portal>/api/v3/asset_computers/{id}\
      -X DELETE\ 
      -H "Accept: application/vnd.manageengine.sdp.v3+json"\
      -H "Authorization: Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"\
      -H "Content-Type: application/x-www-form-urlencoded"

// Deluge Sample script
url = "<service domain|custom domain>/app/<portal>/api/v3/asset_computers/{id}";
headers = {"Accept":"application/vnd.manageengine.sdp.v3+json",
           "Content-Type": "application/x-www-form-urlencoded",
           "Authorization": "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"};
response = invokeurl
[
    url: url
    type: DELETE
    headers: headers
];
info response;

#Powershell version - 5.1
$url = "<service domain|custom domain>/app/<portal>/api/v3/asset_computers/{id}"
$headers = @{ "Accept" = "application/vnd.manageengine.sdp.v3+json"
    "Authorization" = "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"
    "Content-Type" = "application/x-www-form-urlencoded"}
$response = Invoke-RestMethod -Uri $url -Method delete -Headers $headers
$response

#Python version - 3.10
from urllib.error import HTTPError
from urllib.request import urlopen,Request

url = "<service domain|custom domain>/app/<portal>/api/v3/asset_computers/{id}"
headers ={"Accept": "application/vnd.manageengine.sdp.v3+json", 
          "Authorization" : "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx", 
          "Content-Type" : "application/x-www-form-urlencoded"}
httprequest = Request(url, headers=headers,method="DELETE")
try:
    with urlopen(httprequest) as response:
        print(response.read().decode())
except HTTPError as e:
    print(e.read().decode())

{
  "response_status": {
    "status_code": 2000,
    "status": "success"
  }
}