<service domain|custom domain>/app/<portal>/api/v3/workstations
Workstation
Hardware and Software details of all the computers in your organization can be tracked under Workstations
Attributes
id (long)
Unique identifier to identify the workstation
name (string)
Unique name to identify the asset
product (product)
Product of the asset
state (asset_state)
State of the asset
asset_tag (string)
Asset tag used to identify the asset
state_history_comments (string)
No Description
More Attributes Expand all
product_depreciation (depreciation_detail)read only
Depreciation details configured for the asset’s product
is_depreciation_configured (boolean)read only
Boolean value indicating whether this asset depreciation is configured or not
Add Workstation
This operation helps you Add workstations.
Mandatory Fields :- name, product, state
Url
Attributes
id (long)
Unique identifier to identify the workstation
name (string)
Unique name to identify the asset
product (product)
Product of the asset
state (asset_state)
State of the asset
asset_tag (string)
Asset tag used to identify the asset
state_history_comments (string)
No Description
More Attributes Expand all
product_depreciation (depreciation_detail)read only
Depreciation details configured for the asset’s product
is_depreciation_configured (boolean)read only
Boolean value indicating whether this asset depreciation is configured or not
$ curl <service domain|custom domain>/app/<portal>/api/v3/workstations\
-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='{
"workstation": {
"workstation_udf_fields": {
"udf_ref1": {
"name": "192.0.2.1",
"id": "2221800016751680"
},
"udf_boolean1": false,
"udf_long1": "1877020651204658",
"udf_date1": {
"display_value": "Nov 10, 2016 11:44 AM",
"value": "1478758440000"
},
"udf_double1": "test-udf_double1",
"udf_char1": "test-udf_char1",
"deptheadid": {
"name": "192.0.2.1",
"id": "1882559950905575"
}
},
"suggested_owner": {
"name": "Lincoln",
"id": "1576435717654644"
},
"state": {
"name": "In Use",
"id": "2227520503256240"
},
"barcode": "test-barcode",
"asset_tag": "test-asset_tag",
"vm_platform": {
"name": "test-name",
"id": "2375686055527457"
},
"domain": {
"name": "test-name",
"id": "2150528100870116"
},
"udf_fields": {
"udf_ref1": {
"name": "192.0.2.1",
"id": "1699535057056217"
},
"udf_boolean1": false,
"udf_long1": "2474532897768885",
"udf_date1": {
"value": "1478758440000"
},
"udf_double1": "test-udf_double1",
"udf_char1": "test-udf_char1",
"deptheadid": {
"name": "192.0.2.1",
"id": "1769393692135813"
}
},
"name": "192.0.2.1",
"vm_host": {
"name": "test-name",
"id": "2347687042276338",
"barcode": "test-barcode"
},
"monitors": [
{
"index": 47,
"serial_number": "test-serial_number",
"monitor_type": "test-monitor_type",
"max_resolution": "test-max_resolution",
"manufacturer": "test-manufacturer"
}
],
"memory": {
"virtual_memory": "2415209697727068",
"physical_memory": "1900704386906217"
},
"last_logged_user": "test-last_logged_user",
"is_remote_control_prompt_enabled": false,
"retain_user_site": false,
"sound_card": {
"sound_card_name": "test-sound_card_name"
},
"acquisition_date": {
"value": "1478758440000"
},
"is_server": false,
"vm_type": 48,
"vendor": {
"name": "test-name",
"id": "2252562519390563"
},
"operating_system": {
"os": "test-os",
"product_id": "test-product_id",
"service_pack": "test-service_pack",
"build_number": "test-build_number",
"version": "test-version"
},
"purchase_cost": 1343434.4333,
"department": {
"name": "Administration",
"id": "2317251330783073"
},
"keyboard": {
"keyboard_manufacturer": "test-keyboard_manufacturer",
"keyboard_serial_number": "test-keyboard_serial_number",
"keyboard_type": "test-keyboard_type"
},
"product": {
"name": "test-name",
"id": "1890883035203100"
},
"comments": "test-comments",
"expiry_date": {
"value": "1478758440000"
},
"used_by_asset": {
"name": "192.0.2.1",
"id": "2115306165709380",
"barcode": "test-barcode"
},
"serial_number": "test-serial_number",
"warranty_expiry": {
"value": "1478758440000"
},
"site": {
"name": "Custom Site",
"id": "1637524175711377"
},
"computer_system": {
"system_manufacturer": "test-system_manufacturer",
"service_tag": "test-service_tag",
"bios_date": "test-bios_date",
"model": "test-model",
"bios_version": "test-bios_version"
},
"location": "test-location",
"is_loanable": false,
"user": {
"name": "Lincoln",
"id": "1585943060442963"
},
"state_history_comments": "test-state_history_comments"
}
}''
// Deluge Sample script
url = "<service domain|custom domain>/app/<portal>/api/v3/workstations";
headers = {"Accept":"application/vnd.manageengine.sdp.v3+json",
"Content-Type": "application/x-www-form-urlencoded",
"Authorization": "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"};
input_data = {
"workstation": {
"workstation_udf_fields": {
"udf_ref1": {
"name": "192.0.2.1",
"id": "2221800016751680"
},
"udf_boolean1": false,
"udf_long1": "1877020651204658",
"udf_date1": {
"display_value": "Nov 10, 2016 11:44 AM",
"value": "1478758440000"
},
"udf_double1": "test-udf_double1",
"udf_char1": "test-udf_char1",
"deptheadid": {
"name": "192.0.2.1",
"id": "1882559950905575"
}
},
"suggested_owner": {
"name": "Lincoln",
"id": "1576435717654644"
},
"state": {
"name": "In Use",
"id": "2227520503256240"
},
"barcode": "test-barcode",
"asset_tag": "test-asset_tag",
"vm_platform": {
"name": "test-name",
"id": "2375686055527457"
},
"domain": {
"name": "test-name",
"id": "2150528100870116"
},
"udf_fields": {
"udf_ref1": {
"name": "192.0.2.1",
"id": "1699535057056217"
},
"udf_boolean1": false,
"udf_long1": "2474532897768885",
"udf_date1": {
"value": "1478758440000"
},
"udf_double1": "test-udf_double1",
"udf_char1": "test-udf_char1",
"deptheadid": {
"name": "192.0.2.1",
"id": "1769393692135813"
}
},
"name": "192.0.2.1",
"vm_host": {
"name": "test-name",
"id": "2347687042276338",
"barcode": "test-barcode"
},
"monitors": [
{
"index": 47,
"serial_number": "test-serial_number",
"monitor_type": "test-monitor_type",
"max_resolution": "test-max_resolution",
"manufacturer": "test-manufacturer"
}
],
"memory": {
"virtual_memory": "2415209697727068",
"physical_memory": "1900704386906217"
},
"last_logged_user": "test-last_logged_user",
"is_remote_control_prompt_enabled": false,
"retain_user_site": false,
"sound_card": {
"sound_card_name": "test-sound_card_name"
},
"acquisition_date": {
"value": "1478758440000"
},
"is_server": false,
"vm_type": 48,
"vendor": {
"name": "test-name",
"id": "2252562519390563"
},
"operating_system": {
"os": "test-os",
"product_id": "test-product_id",
"service_pack": "test-service_pack",
"build_number": "test-build_number",
"version": "test-version"
},
"purchase_cost": 1343434.4333,
"department": {
"name": "Administration",
"id": "2317251330783073"
},
"keyboard": {
"keyboard_manufacturer": "test-keyboard_manufacturer",
"keyboard_serial_number": "test-keyboard_serial_number",
"keyboard_type": "test-keyboard_type"
},
"product": {
"name": "test-name",
"id": "1890883035203100"
},
"comments": "test-comments",
"expiry_date": {
"value": "1478758440000"
},
"used_by_asset": {
"name": "192.0.2.1",
"id": "2115306165709380",
"barcode": "test-barcode"
},
"serial_number": "test-serial_number",
"warranty_expiry": {
"value": "1478758440000"
},
"site": {
"name": "Custom Site",
"id": "1637524175711377"
},
"computer_system": {
"system_manufacturer": "test-system_manufacturer",
"service_tag": "test-service_tag",
"bios_date": "test-bios_date",
"model": "test-model",
"bios_version": "test-bios_version"
},
"location": "test-location",
"is_loanable": false,
"user": {
"name": "Lincoln",
"id": "1585943060442963"
},
"state_history_comments": "test-state_history_comments"
}
}';
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/workstations"
$headers = @{ "Accept" = "application/vnd.manageengine.sdp.v3+json"
"Authorization" = "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"
"Content-Type" = "application/x-www-form-urlencoded"}
$input_data = @'
{
"workstation": {
"workstation_udf_fields": {
"udf_ref1": {
"name": "192.0.2.1",
"id": "2221800016751680"
},
"udf_boolean1": false,
"udf_long1": "1877020651204658",
"udf_date1": {
"display_value": "Nov 10, 2016 11:44 AM",
"value": "1478758440000"
},
"udf_double1": "test-udf_double1",
"udf_char1": "test-udf_char1",
"deptheadid": {
"name": "192.0.2.1",
"id": "1882559950905575"
}
},
"suggested_owner": {
"name": "Lincoln",
"id": "1576435717654644"
},
"state": {
"name": "In Use",
"id": "2227520503256240"
},
"barcode": "test-barcode",
"asset_tag": "test-asset_tag",
"vm_platform": {
"name": "test-name",
"id": "2375686055527457"
},
"domain": {
"name": "test-name",
"id": "2150528100870116"
},
"udf_fields": {
"udf_ref1": {
"name": "192.0.2.1",
"id": "1699535057056217"
},
"udf_boolean1": false,
"udf_long1": "2474532897768885",
"udf_date1": {
"value": "1478758440000"
},
"udf_double1": "test-udf_double1",
"udf_char1": "test-udf_char1",
"deptheadid": {
"name": "192.0.2.1",
"id": "1769393692135813"
}
},
"name": "192.0.2.1",
"vm_host": {
"name": "test-name",
"id": "2347687042276338",
"barcode": "test-barcode"
},
"monitors": [
{
"index": 47,
"serial_number": "test-serial_number",
"monitor_type": "test-monitor_type",
"max_resolution": "test-max_resolution",
"manufacturer": "test-manufacturer"
}
],
"memory": {
"virtual_memory": "2415209697727068",
"physical_memory": "1900704386906217"
},
"last_logged_user": "test-last_logged_user",
"is_remote_control_prompt_enabled": false,
"retain_user_site": false,
"sound_card": {
"sound_card_name": "test-sound_card_name"
},
"acquisition_date": {
"value": "1478758440000"
},
"is_server": false,
"vm_type": 48,
"vendor": {
"name": "test-name",
"id": "2252562519390563"
},
"operating_system": {
"os": "test-os",
"product_id": "test-product_id",
"service_pack": "test-service_pack",
"build_number": "test-build_number",
"version": "test-version"
},
"purchase_cost": 1343434.4333,
"department": {
"name": "Administration",
"id": "2317251330783073"
},
"keyboard": {
"keyboard_manufacturer": "test-keyboard_manufacturer",
"keyboard_serial_number": "test-keyboard_serial_number",
"keyboard_type": "test-keyboard_type"
},
"product": {
"name": "test-name",
"id": "1890883035203100"
},
"comments": "test-comments",
"expiry_date": {
"value": "1478758440000"
},
"used_by_asset": {
"name": "192.0.2.1",
"id": "2115306165709380",
"barcode": "test-barcode"
},
"serial_number": "test-serial_number",
"warranty_expiry": {
"value": "1478758440000"
},
"site": {
"name": "Custom Site",
"id": "1637524175711377"
},
"computer_system": {
"system_manufacturer": "test-system_manufacturer",
"service_tag": "test-service_tag",
"bios_date": "test-bios_date",
"model": "test-model",
"bios_version": "test-bios_version"
},
"location": "test-location",
"is_loanable": false,
"user": {
"name": "Lincoln",
"id": "1585943060442963"
},
"state_history_comments": "test-state_history_comments"
}
}'
'@
$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/workstations"
headers ={"Accept": "application/vnd.manageengine.sdp.v3+json",
"Authorization" : "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx",
"Content-Type" : "application/x-www-form-urlencoded"}
input_data = '''{
"workstation": {
"workstation_udf_fields": {
"udf_ref1": {
"name": "192.0.2.1",
"id": "2221800016751680"
},
"udf_boolean1": false,
"udf_long1": "1877020651204658",
"udf_date1": {
"display_value": "Nov 10, 2016 11:44 AM",
"value": "1478758440000"
},
"udf_double1": "test-udf_double1",
"udf_char1": "test-udf_char1",
"deptheadid": {
"name": "192.0.2.1",
"id": "1882559950905575"
}
},
"suggested_owner": {
"name": "Lincoln",
"id": "1576435717654644"
},
"state": {
"name": "In Use",
"id": "2227520503256240"
},
"barcode": "test-barcode",
"asset_tag": "test-asset_tag",
"vm_platform": {
"name": "test-name",
"id": "2375686055527457"
},
"domain": {
"name": "test-name",
"id": "2150528100870116"
},
"udf_fields": {
"udf_ref1": {
"name": "192.0.2.1",
"id": "1699535057056217"
},
"udf_boolean1": false,
"udf_long1": "2474532897768885",
"udf_date1": {
"value": "1478758440000"
},
"udf_double1": "test-udf_double1",
"udf_char1": "test-udf_char1",
"deptheadid": {
"name": "192.0.2.1",
"id": "1769393692135813"
}
},
"name": "192.0.2.1",
"vm_host": {
"name": "test-name",
"id": "2347687042276338",
"barcode": "test-barcode"
},
"monitors": [
{
"index": 47,
"serial_number": "test-serial_number",
"monitor_type": "test-monitor_type",
"max_resolution": "test-max_resolution",
"manufacturer": "test-manufacturer"
}
],
"memory": {
"virtual_memory": "2415209697727068",
"physical_memory": "1900704386906217"
},
"last_logged_user": "test-last_logged_user",
"is_remote_control_prompt_enabled": false,
"retain_user_site": false,
"sound_card": {
"sound_card_name": "test-sound_card_name"
},
"acquisition_date": {
"value": "1478758440000"
},
"is_server": false,
"vm_type": 48,
"vendor": {
"name": "test-name",
"id": "2252562519390563"
},
"operating_system": {
"os": "test-os",
"product_id": "test-product_id",
"service_pack": "test-service_pack",
"build_number": "test-build_number",
"version": "test-version"
},
"purchase_cost": 1343434.4333,
"department": {
"name": "Administration",
"id": "2317251330783073"
},
"keyboard": {
"keyboard_manufacturer": "test-keyboard_manufacturer",
"keyboard_serial_number": "test-keyboard_serial_number",
"keyboard_type": "test-keyboard_type"
},
"product": {
"name": "test-name",
"id": "1890883035203100"
},
"comments": "test-comments",
"expiry_date": {
"value": "1478758440000"
},
"used_by_asset": {
"name": "192.0.2.1",
"id": "2115306165709380",
"barcode": "test-barcode"
},
"serial_number": "test-serial_number",
"warranty_expiry": {
"value": "1478758440000"
},
"site": {
"name": "Custom Site",
"id": "1637524175711377"
},
"computer_system": {
"system_manufacturer": "test-system_manufacturer",
"service_tag": "test-service_tag",
"bios_date": "test-bios_date",
"model": "test-model",
"bios_version": "test-bios_version"
},
"location": "test-location",
"is_loanable": false,
"user": {
"name": "Lincoln",
"id": "1585943060442963"
},
"state_history_comments": "test-state_history_comments"
}
}''''
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())
{
"workstations": [
{
"total_cost": 1343434.4333,
"type": {
"name": "Asset",
"id": "1958727453334707"
},
"last_updated_by": {
"email_id": "lincoln@zmail.com",
"is_technician": false,
"sms_mail": "linc123@xys_sms.co",
"phone": "test-phone",
"name": "Lincoln",
"mobile": "test-mobile",
"id": "1682973096994392",
"photo_url": "test-photo_url",
"is_vip_user": false
},
"workstation_udf_fields": {
"udf_ref1": {
"name": "192.0.2.1",
"id": "1588235647417553"
},
"udf_boolean1": false,
"udf_long1": "1724661932683369",
"udf_date1": {
"display_value": "Nov 10, 2016 11:44 AM",
"value": "1478758440000"
},
"udf_double1": "test-udf_double1",
"udf_char1": "test-udf_char1",
"deptheadid": {
"name": "192.0.2.1",
"id": "2334421164257081"
}
},
"suggested_owner": {
"email_id": "lincoln@zmail.com",
"is_technician": false,
"sms_mail": "linc123@xys_sms.co",
"phone": "test-phone",
"name": "Lincoln",
"mobile": "test-mobile",
"id": "1590081718811869",
"photo_url": "test-photo_url",
"is_vip_user": false
},
"id": "2048883098647743",
"state": {
"name": "In Use",
"description": "test-description",
"id": "2323881018668183"
},
"barcode": "test-barcode",
"product_depreciation": {
"useful_life": "2465576209550676",
"id": "2126483417459223",
"depreciation_percent": 1343434.4333,
"salvage_value": 1343434.4333
},
"operational_cost": 1343434.4333,
"asset_tag": "test-asset_tag",
"created_time": {
"display_value": "Nov 10, 2016 11:44 AM",
"value": "1478758440000"
},
"vm_platform": {
"name": "test-name",
"id": "2341727926320467"
},
"created_by": {
"email_id": "lincoln@zmail.com",
"is_technician": false,
"sms_mail": "linc123@xys_sms.co",
"phone": "test-phone",
"name": "Lincoln",
"mobile": "test-mobile",
"id": "1588735281882515",
"photo_url": "test-photo_url",
"is_vip_user": false
},
"last_updated_time": {
"display_value": "Nov 10, 2016 11:44 AM",
"value": "1478758440000"
},
"purchase_order": "test-purchase_order",
"domain": {
"name": "test-name",
"id": "1622390625709285"
},
"udf_fields": {
"udf_ref1": {
"name": "192.0.2.1",
"id": "1710471709899362"
},
"udf_boolean1": false,
"udf_long1": "1562036011012714",
"udf_date1": {
"display_value": "Nov 10, 2016 11:44 AM",
"value": "1478758440000"
},
"udf_double1": "test-udf_double1",
"udf_char1": "test-udf_char1",
"deptheadid": {
"name": "192.0.2.1",
"id": "1805569008468864"
}
},
"name": "192.0.2.1",
"is_depreciation_configured": false,
"vm_host": {
"name": "test-name",
"id": "2277724770880822",
"barcode": "test-barcode"
},
"is_depreciation_calculated": false,
"region": {
"name": "test-name",
"id": "2018409421081495"
},
"monitors": [
{
"index": 7,
"serial_number": "test-serial_number",
"monitor_type": "test-monitor_type",
"max_resolution": "test-max_resolution",
"manufacturer": "test-manufacturer"
}
],
"loan": {
"start_time": {
"display_value": "Nov 10, 2016 11:44 AM",
"value": "1478758440000"
},
"id": "1826972352173524",
"returned_time": {
"display_value": "Nov 10, 2016 11:44 AM",
"value": "1478758440000"
},
"barcode": "test-barcode",
"due_by_time": {
"display_value": "Nov 10, 2016 11:44 AM",
"value": "1478758440000"
},
"loan_id": {
"display_value": "CH 44",
"value": "44"
}
},
"memory": {
"virtual_memory": "2124453954636124",
"physical_memory": "2108359588095250"
},
"last_logged_user": "test-last_logged_user",
"is_remote_control_prompt_enabled": false,
"retain_user_site": false,
"sound_card": {
"sound_card_name": "test-sound_card_name"
},
"acquisition_date": {
"display_value": "Nov 10, 2016 11:44 AM",
"value": "1478758440000"
},
"is_server": false,
"vm_type": 46,
"current_cost": 1343434.4333,
"mac_address": "test-mac_address",
"vendor": {
"name": "test-name",
"description": "test-description",
"id": "1499817464643175"
},
"operating_system": {
"os": "test-os",
"product_id": "test-product_id",
"service_pack": "test-service_pack",
"build_number": "test-build_number",
"version": "test-version"
},
"purchase_cost": 1343434.4333,
"department": {
"name": "Administration",
"id": "1526011278713431"
},
"keyboard": {
"keyboard_manufacturer": "test-keyboard_manufacturer",
"keyboard_serial_number": "test-keyboard_serial_number",
"keyboard_type": "test-keyboard_type"
},
"is_in_contract": false,
"product": {
"part_no": "test-part_no",
"name": "test-name",
"id": "2286143374781565",
"manufacturer": "test-manufacturer"
},
"comments": "test-comments",
"asset_depreciation": {
"useful_life": "1704335819861106",
"id": "1679999731500251",
"depreciation_percent": 1343434.4333,
"salvage_value": 1343434.4333
},
"expiry_date": {
"display_value": "Nov 10, 2016 11:44 AM",
"value": "1478758440000"
},
"used_by_asset": {
"name": "192.0.2.1",
"id": "1608091521582883",
"barcode": "test-barcode"
},
"serial_number": "test-serial_number",
"warranty_expiry": {
"display_value": "Nov 10, 2016 11:44 AM",
"value": "1478758440000"
},
"ip_address": "test-ip_address",
"site": {
"deleted": false,
"name": "Custom Site",
"id": "2072251730595606"
},
"product_type": {
"image": "test-image",
"name": "WorkStation",
"id": "2257618932059085"
},
"computer_system": {
"system_manufacturer": "test-system_manufacturer",
"service_tag": "test-service_tag",
"bios_date": "test-bios_date",
"model": "test-model",
"bios_version": "test-bios_version"
},
"discovered_serial_number": "test-discovered_serial_number",
"location": "test-location",
"is_loaned": false,
"is_loanable": false,
"category": {
"name": "IT",
"description": "test-description",
"id": "2447596431136977"
},
"user": {
"email_id": "lincoln@zmail.com",
"is_technician": false,
"sms_mail": "linc123@xys_sms.co",
"phone": "test-phone",
"name": "Lincoln",
"mobile": "test-mobile",
"id": "2001293235211055",
"photo_url": "test-photo_url",
"is_vip_user": false
},
"last_success_audit": {
"description": "test-description",
"id": "2045297806970204",
"time": {
"display_value": "Nov 10, 2016 11:44 AM",
"value": "1478758440000"
},
"status": "test-status"
},
"state_history_comments": "test-state_history_comments",
"last_audit": {
"description": "test-description",
"id": "2141685357304071",
"time": {
"display_value": "Nov 10, 2016 11:44 AM",
"value": "1478758440000"
},
"status": "test-status"
}
}
],
"response_status": {
"status_code": 2000,
"status": "success"
},
"workstation": {
"total_cost": 1343434.4333,
"type": {
"name": "Asset",
"id": "1746667739715764"
},
"last_updated_by": {
"email_id": "lincoln@zmail.com",
"is_technician": false,
"sms_mail": "linc123@xys_sms.co",
"phone": "test-phone",
"name": "Lincoln",
"mobile": "test-mobile",
"id": "1861562250272504",
"photo_url": "test-photo_url",
"is_vip_user": false
},
"workstation_udf_fields": {
"udf_ref1": {
"name": "192.0.2.1",
"id": "2221800016751680"
},
"udf_boolean1": false,
"udf_long1": "1877020651204658",
"udf_date1": {
"display_value": "Nov 10, 2016 11:44 AM",
"value": "1478758440000"
},
"udf_double1": "test-udf_double1",
"udf_char1": "test-udf_char1",
"deptheadid": {
"name": "192.0.2.1",
"id": "1882559950905575"
}
},
"suggested_owner": {
"email_id": "lincoln@zmail.com",
"is_technician": false,
"sms_mail": "linc123@xys_sms.co",
"phone": "test-phone",
"name": "Lincoln",
"mobile": "test-mobile",
"id": "1576435717654644",
"photo_url": "test-photo_url",
"is_vip_user": false
},
"id": "2296638469027836",
"state": {
"name": "In Use",
"description": "test-description",
"id": "2227520503256240"
},
"barcode": "test-barcode",
"product_depreciation": {
"useful_life": "1852462575766637",
"id": "2225340867744958",
"depreciation_percent": 1343434.4333,
"salvage_value": 1343434.4333
},
"operational_cost": 1343434.4333,
"asset_tag": "test-asset_tag",
"created_time": {
"display_value": "Nov 10, 2016 11:44 AM",
"value": "1478758440000"
},
"vm_platform": {
"name": "test-name",
"id": "2375686055527457"
},
"created_by": {
"email_id": "lincoln@zmail.com",
"is_technician": false,
"sms_mail": "linc123@xys_sms.co",
"phone": "test-phone",
"name": "Lincoln",
"mobile": "test-mobile",
"id": "1963221620880045",
"photo_url": "test-photo_url",
"is_vip_user": false
},
"last_updated_time": {
"display_value": "Nov 10, 2016 11:44 AM",
"value": "1478758440000"
},
"purchase_order": "test-purchase_order",
"domain": {
"name": "test-name",
"id": "2150528100870116"
},
"udf_fields": {
"udf_ref1": {
"name": "192.0.2.1",
"id": "1699535057056217"
},
"udf_boolean1": false,
"udf_long1": "2474532897768885",
"udf_date1": {
"display_value": "Nov 10, 2016 11:44 AM",
"value": "1478758440000"
},
"udf_double1": "test-udf_double1",
"udf_char1": "test-udf_char1",
"deptheadid": {
"name": "192.0.2.1",
"id": "1769393692135813"
}
},
"name": "192.0.2.1",
"is_depreciation_configured": false,
"vm_host": {
"name": "test-name",
"id": "2347687042276338",
"barcode": "test-barcode"
},
"is_depreciation_calculated": false,
"region": {
"name": "test-name",
"id": "2332503806385646"
},
"monitors": [
{
"index": 47,
"serial_number": "test-serial_number",
"monitor_type": "test-monitor_type",
"max_resolution": "test-max_resolution",
"manufacturer": "test-manufacturer"
}
],
"loan": {
"start_time": {
"display_value": "Nov 10, 2016 11:44 AM",
"value": "1478758440000"
},
"id": "1898442900546648",
"returned_time": {
"display_value": "Nov 10, 2016 11:44 AM",
"value": "1478758440000"
},
"barcode": "test-barcode",
"due_by_time": {
"display_value": "Nov 10, 2016 11:44 AM",
"value": "1478758440000"
},
"loan_id": {
"display_value": "CH 44",
"value": "44"
}
},
"memory": {
"virtual_memory": "2415209697727068",
"physical_memory": "1900704386906217"
},
"last_logged_user": "test-last_logged_user",
"is_remote_control_prompt_enabled": false,
"retain_user_site": false,
"sound_card": {
"sound_card_name": "test-sound_card_name"
},
"acquisition_date": {
"display_value": "Nov 10, 2016 11:44 AM",
"value": "1478758440000"
},
"is_server": false,
"vm_type": 48,
"current_cost": 1343434.4333,
"mac_address": "test-mac_address",
"vendor": {
"name": "test-name",
"description": "test-description",
"id": "2252562519390563"
},
"operating_system": {
"os": "test-os",
"product_id": "test-product_id",
"service_pack": "test-service_pack",
"build_number": "test-build_number",
"version": "test-version"
},
"purchase_cost": 1343434.4333,
"department": {
"name": "Administration",
"id": "2317251330783073"
},
"keyboard": {
"keyboard_manufacturer": "test-keyboard_manufacturer",
"keyboard_serial_number": "test-keyboard_serial_number",
"keyboard_type": "test-keyboard_type"
},
"is_in_contract": false,
"product": {
"part_no": "test-part_no",
"name": "test-name",
"id": "1890883035203100",
"manufacturer": "test-manufacturer"
},
"comments": "test-comments",
"asset_depreciation": {
"useful_life": "1581993045548138",
"id": "2058965165544818",
"depreciation_percent": 1343434.4333,
"salvage_value": 1343434.4333
},
"expiry_date": {
"display_value": "Nov 10, 2016 11:44 AM",
"value": "1478758440000"
},
"used_by_asset": {
"name": "192.0.2.1",
"id": "2115306165709380",
"barcode": "test-barcode"
},
"serial_number": "test-serial_number",
"warranty_expiry": {
"display_value": "Nov 10, 2016 11:44 AM",
"value": "1478758440000"
},
"ip_address": "test-ip_address",
"site": {
"deleted": false,
"name": "Custom Site",
"id": "1637524175711377"
},
"product_type": {
"image": "test-image",
"name": "WorkStation",
"id": "1809289826158938"
},
"computer_system": {
"system_manufacturer": "test-system_manufacturer",
"service_tag": "test-service_tag",
"bios_date": "test-bios_date",
"model": "test-model",
"bios_version": "test-bios_version"
},
"discovered_serial_number": "test-discovered_serial_number",
"location": "test-location",
"is_loaned": false,
"is_loanable": false,
"category": {
"name": "IT",
"description": "test-description",
"id": "2284531395224811"
},
"user": {
"email_id": "lincoln@zmail.com",
"is_technician": false,
"sms_mail": "linc123@xys_sms.co",
"phone": "test-phone",
"name": "Lincoln",
"mobile": "test-mobile",
"id": "1585943060442963",
"photo_url": "test-photo_url",
"is_vip_user": false
},
"last_success_audit": {
"description": "test-description",
"id": "2210887459543310",
"time": {
"display_value": "Nov 10, 2016 11:44 AM",
"value": "1478758440000"
},
"status": "test-status"
},
"state_history_comments": "test-state_history_comments",
"last_audit": {
"description": "test-description",
"id": "1869634769337180",
"time": {
"display_value": "Nov 10, 2016 11:44 AM",
"value": "1478758440000"
},
"status": "test-status"
}
}
}
Edit Workstation
This operation helps you Edit workstations.
Url
<service domain|custom domain>/app/<portal>/api/v3/workstations/{workstation_id}
Attributes
id (long)
Unique identifier to identify the workstation
name (string)
Unique name to identify the asset
product (product)
Product of the asset
state (asset_state)
State of the asset
asset_tag (string)
Asset tag used to identify the asset
state_history_comments (string)
No Description
More Attributes Expand all
product_depreciation (depreciation_detail)read only
Depreciation details configured for the asset’s product
is_depreciation_configured (boolean)read only
Boolean value indicating whether this asset depreciation is configured or not
$ curl <service domain|custom domain>/app/<portal>/api/v3/workstations/{workstation_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='{
"workstation": {
"memory": {
"virtual_memory": "2071770265317689",
"physical_memory": "1501126019875674"
},
"last_logged_user": "test-last_logged_user",
"is_remote_control_prompt_enabled": false,
"retain_user_site": false,
"sound_card": {
"sound_card_name": "test-sound_card_name"
},
"acquisition_date": {
"value": "1478758440000"
},
"is_server": false,
"vm_type": 48,
"workstation_udf_fields": {
"udf_ref1": {
"name": "192.0.2.1",
"id": "1617325920062018"
},
"udf_boolean1": false,
"udf_long1": "2088955578615300",
"udf_date1": {
"display_value": "Nov 10, 2016 11:44 AM",
"value": "1478758440000"
},
"udf_double1": "test-udf_double1",
"udf_char1": "test-udf_char1",
"deptheadid": {
"name": "192.0.2.1",
"id": "2355420520480952"
}
},
"vendor": {
"name": "test-name",
"id": "2134719383453628"
},
"suggested_owner": {
"name": "Lincoln",
"id": "1698436335551850"
},
"operating_system": {
"os": "test-os",
"product_id": "test-product_id",
"service_pack": "test-service_pack",
"build_number": "test-build_number",
"version": "test-version"
},
"state": {
"name": "In Use",
"id": "1673518330043655"
},
"purchase_cost": 1343434.4333,
"department": {
"name": "Administration",
"id": "1553424772194616"
},
"barcode": "test-barcode",
"asset_tag": "test-asset_tag",
"keyboard": {
"keyboard_manufacturer": "test-keyboard_manufacturer",
"keyboard_serial_number": "test-keyboard_serial_number",
"keyboard_type": "test-keyboard_type"
},
"product": {
"name": "test-name",
"id": "1963309789898603"
},
"comments": "test-comments",
"expiry_date": {
"value": "1478758440000"
},
"used_by_asset": {
"name": "192.0.2.1",
"id": "1580079193746236",
"barcode": "test-barcode"
},
"vm_platform": {
"name": "test-name",
"id": "1761170687867996"
},
"serial_number": "test-serial_number",
"warranty_expiry": {
"value": "1478758440000"
},
"site": {
"name": "Custom Site",
"id": "1823211311062304"
},
"computer_system": {
"system_manufacturer": "test-system_manufacturer",
"service_tag": "test-service_tag",
"bios_date": "test-bios_date",
"model": "test-model",
"bios_version": "test-bios_version"
},
"domain": {
"name": "test-name",
"id": "1490930287449893"
},
"udf_fields": {
"udf_ref1": {
"name": "192.0.2.1",
"id": "1965142984702295"
},
"udf_boolean1": false,
"udf_long1": "2388252916865875",
"udf_date1": {
"value": "1478758440000"
},
"udf_double1": "test-udf_double1",
"udf_char1": "test-udf_char1",
"deptheadid": {
"name": "192.0.2.1",
"id": "1878058679284267"
}
},
"name": "192.0.2.1",
"location": "test-location",
"vm_host": {
"name": "test-name",
"id": "2452933733910759",
"barcode": "test-barcode"
},
"is_loanable": false,
"user": {
"name": "Lincoln",
"id": "2233251294695217"
},
"state_history_comments": "test-state_history_comments",
"monitors": [
{
"index": 3,
"serial_number": "test-serial_number",
"monitor_type": "test-monitor_type",
"max_resolution": "test-max_resolution",
"manufacturer": "test-manufacturer"
}
]
}
}''
// Deluge Sample script
url = "<service domain|custom domain>/app/<portal>/api/v3/workstations/{workstation_id}";
headers = {"Accept":"application/vnd.manageengine.sdp.v3+json",
"Content-Type": "application/x-www-form-urlencoded",
"Authorization": "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"};
input_data = {
"workstation": {
"memory": {
"virtual_memory": "2071770265317689",
"physical_memory": "1501126019875674"
},
"last_logged_user": "test-last_logged_user",
"is_remote_control_prompt_enabled": false,
"retain_user_site": false,
"sound_card": {
"sound_card_name": "test-sound_card_name"
},
"acquisition_date": {
"value": "1478758440000"
},
"is_server": false,
"vm_type": 48,
"workstation_udf_fields": {
"udf_ref1": {
"name": "192.0.2.1",
"id": "1617325920062018"
},
"udf_boolean1": false,
"udf_long1": "2088955578615300",
"udf_date1": {
"display_value": "Nov 10, 2016 11:44 AM",
"value": "1478758440000"
},
"udf_double1": "test-udf_double1",
"udf_char1": "test-udf_char1",
"deptheadid": {
"name": "192.0.2.1",
"id": "2355420520480952"
}
},
"vendor": {
"name": "test-name",
"id": "2134719383453628"
},
"suggested_owner": {
"name": "Lincoln",
"id": "1698436335551850"
},
"operating_system": {
"os": "test-os",
"product_id": "test-product_id",
"service_pack": "test-service_pack",
"build_number": "test-build_number",
"version": "test-version"
},
"state": {
"name": "In Use",
"id": "1673518330043655"
},
"purchase_cost": 1343434.4333,
"department": {
"name": "Administration",
"id": "1553424772194616"
},
"barcode": "test-barcode",
"asset_tag": "test-asset_tag",
"keyboard": {
"keyboard_manufacturer": "test-keyboard_manufacturer",
"keyboard_serial_number": "test-keyboard_serial_number",
"keyboard_type": "test-keyboard_type"
},
"product": {
"name": "test-name",
"id": "1963309789898603"
},
"comments": "test-comments",
"expiry_date": {
"value": "1478758440000"
},
"used_by_asset": {
"name": "192.0.2.1",
"id": "1580079193746236",
"barcode": "test-barcode"
},
"vm_platform": {
"name": "test-name",
"id": "1761170687867996"
},
"serial_number": "test-serial_number",
"warranty_expiry": {
"value": "1478758440000"
},
"site": {
"name": "Custom Site",
"id": "1823211311062304"
},
"computer_system": {
"system_manufacturer": "test-system_manufacturer",
"service_tag": "test-service_tag",
"bios_date": "test-bios_date",
"model": "test-model",
"bios_version": "test-bios_version"
},
"domain": {
"name": "test-name",
"id": "1490930287449893"
},
"udf_fields": {
"udf_ref1": {
"name": "192.0.2.1",
"id": "1965142984702295"
},
"udf_boolean1": false,
"udf_long1": "2388252916865875",
"udf_date1": {
"value": "1478758440000"
},
"udf_double1": "test-udf_double1",
"udf_char1": "test-udf_char1",
"deptheadid": {
"name": "192.0.2.1",
"id": "1878058679284267"
}
},
"name": "192.0.2.1",
"location": "test-location",
"vm_host": {
"name": "test-name",
"id": "2452933733910759",
"barcode": "test-barcode"
},
"is_loanable": false,
"user": {
"name": "Lincoln",
"id": "2233251294695217"
},
"state_history_comments": "test-state_history_comments",
"monitors": [
{
"index": 3,
"serial_number": "test-serial_number",
"monitor_type": "test-monitor_type",
"max_resolution": "test-max_resolution",
"manufacturer": "test-manufacturer"
}
]
}
}';
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/workstations/{workstation_id}"
$headers = @{"Accept": "application/vnd.manageengine.sdp.v3+json",
"Authorization" : "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx",
"Content-Type" : "application/x-www-form-urlencoded"}
$input_data = @'
{
"workstation": {
"memory": {
"virtual_memory": "2071770265317689",
"physical_memory": "1501126019875674"
},
"last_logged_user": "test-last_logged_user",
"is_remote_control_prompt_enabled": false,
"retain_user_site": false,
"sound_card": {
"sound_card_name": "test-sound_card_name"
},
"acquisition_date": {
"value": "1478758440000"
},
"is_server": false,
"vm_type": 48,
"workstation_udf_fields": {
"udf_ref1": {
"name": "192.0.2.1",
"id": "1617325920062018"
},
"udf_boolean1": false,
"udf_long1": "2088955578615300",
"udf_date1": {
"display_value": "Nov 10, 2016 11:44 AM",
"value": "1478758440000"
},
"udf_double1": "test-udf_double1",
"udf_char1": "test-udf_char1",
"deptheadid": {
"name": "192.0.2.1",
"id": "2355420520480952"
}
},
"vendor": {
"name": "test-name",
"id": "2134719383453628"
},
"suggested_owner": {
"name": "Lincoln",
"id": "1698436335551850"
},
"operating_system": {
"os": "test-os",
"product_id": "test-product_id",
"service_pack": "test-service_pack",
"build_number": "test-build_number",
"version": "test-version"
},
"state": {
"name": "In Use",
"id": "1673518330043655"
},
"purchase_cost": 1343434.4333,
"department": {
"name": "Administration",
"id": "1553424772194616"
},
"barcode": "test-barcode",
"asset_tag": "test-asset_tag",
"keyboard": {
"keyboard_manufacturer": "test-keyboard_manufacturer",
"keyboard_serial_number": "test-keyboard_serial_number",
"keyboard_type": "test-keyboard_type"
},
"product": {
"name": "test-name",
"id": "1963309789898603"
},
"comments": "test-comments",
"expiry_date": {
"value": "1478758440000"
},
"used_by_asset": {
"name": "192.0.2.1",
"id": "1580079193746236",
"barcode": "test-barcode"
},
"vm_platform": {
"name": "test-name",
"id": "1761170687867996"
},
"serial_number": "test-serial_number",
"warranty_expiry": {
"value": "1478758440000"
},
"site": {
"name": "Custom Site",
"id": "1823211311062304"
},
"computer_system": {
"system_manufacturer": "test-system_manufacturer",
"service_tag": "test-service_tag",
"bios_date": "test-bios_date",
"model": "test-model",
"bios_version": "test-bios_version"
},
"domain": {
"name": "test-name",
"id": "1490930287449893"
},
"udf_fields": {
"udf_ref1": {
"name": "192.0.2.1",
"id": "1965142984702295"
},
"udf_boolean1": false,
"udf_long1": "2388252916865875",
"udf_date1": {
"value": "1478758440000"
},
"udf_double1": "test-udf_double1",
"udf_char1": "test-udf_char1",
"deptheadid": {
"name": "192.0.2.1",
"id": "1878058679284267"
}
},
"name": "192.0.2.1",
"location": "test-location",
"vm_host": {
"name": "test-name",
"id": "2452933733910759",
"barcode": "test-barcode"
},
"is_loanable": false,
"user": {
"name": "Lincoln",
"id": "2233251294695217"
},
"state_history_comments": "test-state_history_comments",
"monitors": [
{
"index": 3,
"serial_number": "test-serial_number",
"monitor_type": "test-monitor_type",
"max_resolution": "test-max_resolution",
"manufacturer": "test-manufacturer"
}
]
}
}'
'@
$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/workstations/{workstation_id}"
headers ={"Accept": "application/vnd.manageengine.sdp.v3+json",
"Authorization" : "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx",
"Content-Type" : "application/x-www-form-urlencoded"}
input_data = '''{
"workstation": {
"memory": {
"virtual_memory": "2071770265317689",
"physical_memory": "1501126019875674"
},
"last_logged_user": "test-last_logged_user",
"is_remote_control_prompt_enabled": false,
"retain_user_site": false,
"sound_card": {
"sound_card_name": "test-sound_card_name"
},
"acquisition_date": {
"value": "1478758440000"
},
"is_server": false,
"vm_type": 48,
"workstation_udf_fields": {
"udf_ref1": {
"name": "192.0.2.1",
"id": "1617325920062018"
},
"udf_boolean1": false,
"udf_long1": "2088955578615300",
"udf_date1": {
"display_value": "Nov 10, 2016 11:44 AM",
"value": "1478758440000"
},
"udf_double1": "test-udf_double1",
"udf_char1": "test-udf_char1",
"deptheadid": {
"name": "192.0.2.1",
"id": "2355420520480952"
}
},
"vendor": {
"name": "test-name",
"id": "2134719383453628"
},
"suggested_owner": {
"name": "Lincoln",
"id": "1698436335551850"
},
"operating_system": {
"os": "test-os",
"product_id": "test-product_id",
"service_pack": "test-service_pack",
"build_number": "test-build_number",
"version": "test-version"
},
"state": {
"name": "In Use",
"id": "1673518330043655"
},
"purchase_cost": 1343434.4333,
"department": {
"name": "Administration",
"id": "1553424772194616"
},
"barcode": "test-barcode",
"asset_tag": "test-asset_tag",
"keyboard": {
"keyboard_manufacturer": "test-keyboard_manufacturer",
"keyboard_serial_number": "test-keyboard_serial_number",
"keyboard_type": "test-keyboard_type"
},
"product": {
"name": "test-name",
"id": "1963309789898603"
},
"comments": "test-comments",
"expiry_date": {
"value": "1478758440000"
},
"used_by_asset": {
"name": "192.0.2.1",
"id": "1580079193746236",
"barcode": "test-barcode"
},
"vm_platform": {
"name": "test-name",
"id": "1761170687867996"
},
"serial_number": "test-serial_number",
"warranty_expiry": {
"value": "1478758440000"
},
"site": {
"name": "Custom Site",
"id": "1823211311062304"
},
"computer_system": {
"system_manufacturer": "test-system_manufacturer",
"service_tag": "test-service_tag",
"bios_date": "test-bios_date",
"model": "test-model",
"bios_version": "test-bios_version"
},
"domain": {
"name": "test-name",
"id": "1490930287449893"
},
"udf_fields": {
"udf_ref1": {
"name": "192.0.2.1",
"id": "1965142984702295"
},
"udf_boolean1": false,
"udf_long1": "2388252916865875",
"udf_date1": {
"value": "1478758440000"
},
"udf_double1": "test-udf_double1",
"udf_char1": "test-udf_char1",
"deptheadid": {
"name": "192.0.2.1",
"id": "1878058679284267"
}
},
"name": "192.0.2.1",
"location": "test-location",
"vm_host": {
"name": "test-name",
"id": "2452933733910759",
"barcode": "test-barcode"
},
"is_loanable": false,
"user": {
"name": "Lincoln",
"id": "2233251294695217"
},
"state_history_comments": "test-state_history_comments",
"monitors": [
{
"index": 3,
"serial_number": "test-serial_number",
"monitor_type": "test-monitor_type",
"max_resolution": "test-max_resolution",
"manufacturer": "test-manufacturer"
}
]
}
}''''
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())
{
"workstations": [
{
"total_cost": 1343434.4333,
"type": {
"name": "Asset",
"id": "1628184655467496"
},
"last_updated_by": {
"email_id": "lincoln@zmail.com",
"is_technician": false,
"sms_mail": "linc123@xys_sms.co",
"phone": "test-phone",
"name": "Lincoln",
"mobile": "test-mobile",
"id": "2231314966930686",
"photo_url": "test-photo_url",
"is_vip_user": false
},
"workstation_udf_fields": {
"udf_ref1": {
"name": "192.0.2.1",
"id": "1839819292693734"
},
"udf_boolean1": false,
"udf_long1": "1565531052091102",
"udf_date1": {
"display_value": "Nov 10, 2016 11:44 AM",
"value": "1478758440000"
},
"udf_double1": "test-udf_double1",
"udf_char1": "test-udf_char1",
"deptheadid": {
"name": "192.0.2.1",
"id": "1565685442578061"
}
},
"suggested_owner": {
"email_id": "lincoln@zmail.com",
"is_technician": false,
"sms_mail": "linc123@xys_sms.co",
"phone": "test-phone",
"name": "Lincoln",
"mobile": "test-mobile",
"id": "1503808383018453",
"photo_url": "test-photo_url",
"is_vip_user": false
},
"id": "2448365696896758",
"state": {
"name": "In Use",
"description": "test-description",
"id": "2076012010985640"
},
"barcode": "test-barcode",
"product_depreciation": {
"useful_life": "2479036279690909",
"id": "1773626646968394",
"depreciation_percent": 1343434.4333,
"salvage_value": 1343434.4333
},
"operational_cost": 1343434.4333,
"asset_tag": "test-asset_tag",
"created_time": {
"display_value": "Nov 10, 2016 11:44 AM",
"value": "1478758440000"
},
"vm_platform": {
"name": "test-name",
"id": "1874547022684503"
},
"created_by": {
"email_id": "lincoln@zmail.com",
"is_technician": false,
"sms_mail": "linc123@xys_sms.co",
"phone": "test-phone",
"name": "Lincoln",
"mobile": "test-mobile",
"id": "1579024812774025",
"photo_url": "test-photo_url",
"is_vip_user": false
},
"last_updated_time": {
"display_value": "Nov 10, 2016 11:44 AM",
"value": "1478758440000"
},
"purchase_order": "test-purchase_order",
"domain": {
"name": "test-name",
"id": "2411391641022265"
},
"udf_fields": {
"udf_ref1": {
"name": "192.0.2.1",
"id": "2186427777600253"
},
"udf_boolean1": false,
"udf_long1": "1839174297723976",
"udf_date1": {
"display_value": "Nov 10, 2016 11:44 AM",
"value": "1478758440000"
},
"udf_double1": "test-udf_double1",
"udf_char1": "test-udf_char1",
"deptheadid": {
"name": "192.0.2.1",
"id": "1547406684483817"
}
},
"name": "192.0.2.1",
"is_depreciation_configured": false,
"vm_host": {
"name": "test-name",
"id": "1845608704118389",
"barcode": "test-barcode"
},
"is_depreciation_calculated": false,
"region": {
"name": "test-name",
"id": "1959259814941733"
},
"monitors": [
{
"index": 26,
"serial_number": "test-serial_number",
"monitor_type": "test-monitor_type",
"max_resolution": "test-max_resolution",
"manufacturer": "test-manufacturer"
}
],
"loan": {
"start_time": {
"display_value": "Nov 10, 2016 11:44 AM",
"value": "1478758440000"
},
"id": "2131861450126341",
"returned_time": {
"display_value": "Nov 10, 2016 11:44 AM",
"value": "1478758440000"
},
"barcode": "test-barcode",
"due_by_time": {
"display_value": "Nov 10, 2016 11:44 AM",
"value": "1478758440000"
},
"loan_id": {
"display_value": "CH 44",
"value": "44"
}
},
"memory": {
"virtual_memory": "2085651338450758",
"physical_memory": "1963710042314858"
},
"last_logged_user": "test-last_logged_user",
"is_remote_control_prompt_enabled": false,
"retain_user_site": false,
"sound_card": {
"sound_card_name": "test-sound_card_name"
},
"acquisition_date": {
"display_value": "Nov 10, 2016 11:44 AM",
"value": "1478758440000"
},
"is_server": false,
"vm_type": 45,
"current_cost": 1343434.4333,
"mac_address": "test-mac_address",
"vendor": {
"name": "test-name",
"description": "test-description",
"id": "1524081190117417"
},
"operating_system": {
"os": "test-os",
"product_id": "test-product_id",
"service_pack": "test-service_pack",
"build_number": "test-build_number",
"version": "test-version"
},
"purchase_cost": 1343434.4333,
"department": {
"name": "Administration",
"id": "2366821985890066"
},
"keyboard": {
"keyboard_manufacturer": "test-keyboard_manufacturer",
"keyboard_serial_number": "test-keyboard_serial_number",
"keyboard_type": "test-keyboard_type"
},
"is_in_contract": false,
"product": {
"part_no": "test-part_no",
"name": "test-name",
"id": "1830773002222613",
"manufacturer": "test-manufacturer"
},
"comments": "test-comments",
"asset_depreciation": {
"useful_life": "1882003445223828",
"id": "2274671718827997",
"depreciation_percent": 1343434.4333,
"salvage_value": 1343434.4333
},
"expiry_date": {
"display_value": "Nov 10, 2016 11:44 AM",
"value": "1478758440000"
},
"used_by_asset": {
"name": "192.0.2.1",
"id": "2145981097083245",
"barcode": "test-barcode"
},
"serial_number": "test-serial_number",
"warranty_expiry": {
"display_value": "Nov 10, 2016 11:44 AM",
"value": "1478758440000"
},
"ip_address": "test-ip_address",
"site": {
"deleted": false,
"name": "Custom Site",
"id": "2179711117163412"
},
"product_type": {
"image": "test-image",
"name": "WorkStation",
"id": "1619173420699179"
},
"computer_system": {
"system_manufacturer": "test-system_manufacturer",
"service_tag": "test-service_tag",
"bios_date": "test-bios_date",
"model": "test-model",
"bios_version": "test-bios_version"
},
"discovered_serial_number": "test-discovered_serial_number",
"location": "test-location",
"is_loaned": false,
"is_loanable": false,
"category": {
"name": "IT",
"description": "test-description",
"id": "1842817387359099"
},
"user": {
"email_id": "lincoln@zmail.com",
"is_technician": false,
"sms_mail": "linc123@xys_sms.co",
"phone": "test-phone",
"name": "Lincoln",
"mobile": "test-mobile",
"id": "2395896518033310",
"photo_url": "test-photo_url",
"is_vip_user": false
},
"last_success_audit": {
"description": "test-description",
"id": "2253577948788426",
"time": {
"display_value": "Nov 10, 2016 11:44 AM",
"value": "1478758440000"
},
"status": "test-status"
},
"state_history_comments": "test-state_history_comments",
"last_audit": {
"description": "test-description",
"id": "2421224796272620",
"time": {
"display_value": "Nov 10, 2016 11:44 AM",
"value": "1478758440000"
},
"status": "test-status"
}
}
],
"response_status": {
"status_code": 2000,
"status": "success"
},
"workstation": {
"total_cost": 1343434.4333,
"type": {
"name": "Asset",
"id": "2395746455816753"
},
"last_updated_by": {
"email_id": "lincoln@zmail.com",
"is_technician": false,
"sms_mail": "linc123@xys_sms.co",
"phone": "test-phone",
"name": "Lincoln",
"mobile": "test-mobile",
"id": "2347309392976248",
"photo_url": "test-photo_url",
"is_vip_user": false
},
"workstation_udf_fields": {
"udf_ref1": {
"name": "192.0.2.1",
"id": "1617325920062018"
},
"udf_boolean1": false,
"udf_long1": "2088955578615300",
"udf_date1": {
"display_value": "Nov 10, 2016 11:44 AM",
"value": "1478758440000"
},
"udf_double1": "test-udf_double1",
"udf_char1": "test-udf_char1",
"deptheadid": {
"name": "192.0.2.1",
"id": "2355420520480952"
}
},
"suggested_owner": {
"email_id": "lincoln@zmail.com",
"is_technician": false,
"sms_mail": "linc123@xys_sms.co",
"phone": "test-phone",
"name": "Lincoln",
"mobile": "test-mobile",
"id": "1698436335551850",
"photo_url": "test-photo_url",
"is_vip_user": false
},
"id": "1700692506805975",
"state": {
"name": "In Use",
"description": "test-description",
"id": "1673518330043655"
},
"barcode": "test-barcode",
"product_depreciation": {
"useful_life": "1801538308533045",
"id": "1595004722099806",
"depreciation_percent": 1343434.4333,
"salvage_value": 1343434.4333
},
"operational_cost": 1343434.4333,
"asset_tag": "test-asset_tag",
"created_time": {
"display_value": "Nov 10, 2016 11:44 AM",
"value": "1478758440000"
},
"vm_platform": {
"name": "test-name",
"id": "1761170687867996"
},
"created_by": {
"email_id": "lincoln@zmail.com",
"is_technician": false,
"sms_mail": "linc123@xys_sms.co",
"phone": "test-phone",
"name": "Lincoln",
"mobile": "test-mobile",
"id": "2200809777026279",
"photo_url": "test-photo_url",
"is_vip_user": false
},
"last_updated_time": {
"display_value": "Nov 10, 2016 11:44 AM",
"value": "1478758440000"
},
"purchase_order": "test-purchase_order",
"domain": {
"name": "test-name",
"id": "1490930287449893"
},
"udf_fields": {
"udf_ref1": {
"name": "192.0.2.1",
"id": "1965142984702295"
},
"udf_boolean1": false,
"udf_long1": "2388252916865875",
"udf_date1": {
"display_value": "Nov 10, 2016 11:44 AM",
"value": "1478758440000"
},
"udf_double1": "test-udf_double1",
"udf_char1": "test-udf_char1",
"deptheadid": {
"name": "192.0.2.1",
"id": "1878058679284267"
}
},
"name": "192.0.2.1",
"is_depreciation_configured": false,
"vm_host": {
"name": "test-name",
"id": "2452933733910759",
"barcode": "test-barcode"
},
"is_depreciation_calculated": false,
"region": {
"name": "test-name",
"id": "2339094712683377"
},
"monitors": [
{
"index": 3,
"serial_number": "test-serial_number",
"monitor_type": "test-monitor_type",
"max_resolution": "test-max_resolution",
"manufacturer": "test-manufacturer"
}
],
"loan": {
"start_time": {
"display_value": "Nov 10, 2016 11:44 AM",
"value": "1478758440000"
},
"id": "2218819343299937",
"returned_time": {
"display_value": "Nov 10, 2016 11:44 AM",
"value": "1478758440000"
},
"barcode": "test-barcode",
"due_by_time": {
"display_value": "Nov 10, 2016 11:44 AM",
"value": "1478758440000"
},
"loan_id": {
"display_value": "CH 44",
"value": "44"
}
},
"memory": {
"virtual_memory": "2071770265317689",
"physical_memory": "1501126019875674"
},
"last_logged_user": "test-last_logged_user",
"is_remote_control_prompt_enabled": false,
"retain_user_site": false,
"sound_card": {
"sound_card_name": "test-sound_card_name"
},
"acquisition_date": {
"display_value": "Nov 10, 2016 11:44 AM",
"value": "1478758440000"
},
"is_server": false,
"vm_type": 48,
"current_cost": 1343434.4333,
"mac_address": "test-mac_address",
"vendor": {
"name": "test-name",
"description": "test-description",
"id": "2134719383453628"
},
"operating_system": {
"os": "test-os",
"product_id": "test-product_id",
"service_pack": "test-service_pack",
"build_number": "test-build_number",
"version": "test-version"
},
"purchase_cost": 1343434.4333,
"department": {
"name": "Administration",
"id": "1553424772194616"
},
"keyboard": {
"keyboard_manufacturer": "test-keyboard_manufacturer",
"keyboard_serial_number": "test-keyboard_serial_number",
"keyboard_type": "test-keyboard_type"
},
"is_in_contract": false,
"product": {
"part_no": "test-part_no",
"name": "test-name",
"id": "1963309789898603",
"manufacturer": "test-manufacturer"
},
"comments": "test-comments",
"asset_depreciation": {
"useful_life": "1566456141149361",
"id": "1767822919037952",
"depreciation_percent": 1343434.4333,
"salvage_value": 1343434.4333
},
"expiry_date": {
"display_value": "Nov 10, 2016 11:44 AM",
"value": "1478758440000"
},
"used_by_asset": {
"name": "192.0.2.1",
"id": "1580079193746236",
"barcode": "test-barcode"
},
"serial_number": "test-serial_number",
"warranty_expiry": {
"display_value": "Nov 10, 2016 11:44 AM",
"value": "1478758440000"
},
"ip_address": "test-ip_address",
"site": {
"deleted": false,
"name": "Custom Site",
"id": "1823211311062304"
},
"product_type": {
"image": "test-image",
"name": "WorkStation",
"id": "2199723763634899"
},
"computer_system": {
"system_manufacturer": "test-system_manufacturer",
"service_tag": "test-service_tag",
"bios_date": "test-bios_date",
"model": "test-model",
"bios_version": "test-bios_version"
},
"discovered_serial_number": "test-discovered_serial_number",
"location": "test-location",
"is_loaned": false,
"is_loanable": false,
"category": {
"name": "IT",
"description": "test-description",
"id": "2372957327984381"
},
"user": {
"email_id": "lincoln@zmail.com",
"is_technician": false,
"sms_mail": "linc123@xys_sms.co",
"phone": "test-phone",
"name": "Lincoln",
"mobile": "test-mobile",
"id": "2233251294695217",
"photo_url": "test-photo_url",
"is_vip_user": false
},
"last_success_audit": {
"description": "test-description",
"id": "2014959774719341",
"time": {
"display_value": "Nov 10, 2016 11:44 AM",
"value": "1478758440000"
},
"status": "test-status"
},
"state_history_comments": "test-state_history_comments",
"last_audit": {
"description": "test-description",
"id": "1977055224770366",
"time": {
"display_value": "Nov 10, 2016 11:44 AM",
"value": "1478758440000"
},
"status": "test-status"
}
}
}
Get Workstation
This operation helps you Get workstations.
Url
<service domain|custom domain>/app/<portal>/api/v3/workstations/{workstation_id}
Attributes
id (long)
Unique identifier to identify the workstation
name (string)
Unique name to identify the asset
product (product)
Product of the asset
state (asset_state)
State of the asset
asset_tag (string)
Asset tag used to identify the asset
state_history_comments (string)
No Description
More Attributes Expand all
product_depreciation (depreciation_detail)read only
Depreciation details configured for the asset’s product
is_depreciation_configured (boolean)read only
Boolean value indicating whether this asset depreciation is configured or not
$ curl -G <service domain|custom domain>/app/<portal>/api/v3/workstations/{workstation_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/workstations/{workstation_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/workstations/{workstation_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/workstations/{workstation_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())
{
"workstations": [
{
"total_cost": 1343434.4333,
"type": {
"name": "Asset",
"id": "1693465019387786"
},
"last_updated_by": {
"email_id": "lincoln@zmail.com",
"is_technician": false,
"sms_mail": "linc123@xys_sms.co",
"phone": "test-phone",
"name": "Lincoln",
"mobile": "test-mobile",
"id": "2423492668335074",
"photo_url": "test-photo_url",
"is_vip_user": false
},
"workstation_udf_fields": {
"udf_ref1": {
"name": "192.0.2.1",
"id": "1850276700434481"
},
"udf_boolean1": false,
"udf_long1": "1549119329522354",
"udf_date1": {
"display_value": "Nov 10, 2016 11:44 AM",
"value": "1478758440000"
},
"udf_double1": "test-udf_double1",
"udf_char1": "test-udf_char1",
"deptheadid": {
"name": "192.0.2.1",
"id": "2449313126729532"
}
},
"suggested_owner": {
"email_id": "lincoln@zmail.com",
"is_technician": false,
"sms_mail": "linc123@xys_sms.co",
"phone": "test-phone",
"name": "Lincoln",
"mobile": "test-mobile",
"id": "2080770151805215",
"photo_url": "test-photo_url",
"is_vip_user": false
},
"id": "2468747262139730",
"state": {
"name": "In Use",
"description": "test-description",
"id": "2184693334102326"
},
"barcode": "test-barcode",
"product_depreciation": {
"useful_life": "2310870983033665",
"id": "1724510253558127",
"depreciation_percent": 1343434.4333,
"salvage_value": 1343434.4333
},
"operational_cost": 1343434.4333,
"asset_tag": "test-asset_tag",
"created_time": {
"display_value": "Nov 10, 2016 11:44 AM",
"value": "1478758440000"
},
"vm_platform": {
"name": "test-name",
"id": "2354503055512486"
},
"created_by": {
"email_id": "lincoln@zmail.com",
"is_technician": false,
"sms_mail": "linc123@xys_sms.co",
"phone": "test-phone",
"name": "Lincoln",
"mobile": "test-mobile",
"id": "2066216871223921",
"photo_url": "test-photo_url",
"is_vip_user": false
},
"last_updated_time": {
"display_value": "Nov 10, 2016 11:44 AM",
"value": "1478758440000"
},
"purchase_order": "test-purchase_order",
"domain": {
"name": "test-name",
"id": "1719542996668923"
},
"udf_fields": {
"udf_ref1": {
"name": "192.0.2.1",
"id": "2367701668960406"
},
"udf_boolean1": false,
"udf_long1": "1843951850081017",
"udf_date1": {
"display_value": "Nov 10, 2016 11:44 AM",
"value": "1478758440000"
},
"udf_double1": "test-udf_double1",
"udf_char1": "test-udf_char1",
"deptheadid": {
"name": "192.0.2.1",
"id": "1886559030413829"
}
},
"name": "192.0.2.1",
"is_depreciation_configured": false,
"vm_host": {
"name": "test-name",
"id": "2010984015076523",
"barcode": "test-barcode"
},
"is_depreciation_calculated": false,
"region": {
"name": "test-name",
"id": "1600814990361019"
},
"monitors": [
{
"index": 49,
"serial_number": "test-serial_number",
"monitor_type": "test-monitor_type",
"max_resolution": "test-max_resolution",
"manufacturer": "test-manufacturer"
}
],
"loan": {
"start_time": {
"display_value": "Nov 10, 2016 11:44 AM",
"value": "1478758440000"
},
"id": "2119074722492802",
"returned_time": {
"display_value": "Nov 10, 2016 11:44 AM",
"value": "1478758440000"
},
"barcode": "test-barcode",
"due_by_time": {
"display_value": "Nov 10, 2016 11:44 AM",
"value": "1478758440000"
},
"loan_id": {
"display_value": "CH 44",
"value": "44"
}
},
"memory": {
"virtual_memory": "1781667021149881",
"physical_memory": "2430525647901097"
},
"last_logged_user": "test-last_logged_user",
"is_remote_control_prompt_enabled": false,
"retain_user_site": false,
"sound_card": {
"sound_card_name": "test-sound_card_name"
},
"acquisition_date": {
"display_value": "Nov 10, 2016 11:44 AM",
"value": "1478758440000"
},
"is_server": false,
"vm_type": 27,
"current_cost": 1343434.4333,
"mac_address": "test-mac_address",
"vendor": {
"name": "test-name",
"description": "test-description",
"id": "2161018815614191"
},
"operating_system": {
"os": "test-os",
"product_id": "test-product_id",
"service_pack": "test-service_pack",
"build_number": "test-build_number",
"version": "test-version"
},
"purchase_cost": 1343434.4333,
"department": {
"name": "Administration",
"id": "2463838552162303"
},
"keyboard": {
"keyboard_manufacturer": "test-keyboard_manufacturer",
"keyboard_serial_number": "test-keyboard_serial_number",
"keyboard_type": "test-keyboard_type"
},
"is_in_contract": false,
"product": {
"part_no": "test-part_no",
"name": "test-name",
"id": "1625694353610297",
"manufacturer": "test-manufacturer"
},
"comments": "test-comments",
"asset_depreciation": {
"useful_life": "2264341843712085",
"id": "1581836718360510",
"depreciation_percent": 1343434.4333,
"salvage_value": 1343434.4333
},
"expiry_date": {
"display_value": "Nov 10, 2016 11:44 AM",
"value": "1478758440000"
},
"used_by_asset": {
"name": "192.0.2.1",
"id": "1749964513366311",
"barcode": "test-barcode"
},
"serial_number": "test-serial_number",
"warranty_expiry": {
"display_value": "Nov 10, 2016 11:44 AM",
"value": "1478758440000"
},
"ip_address": "test-ip_address",
"site": {
"deleted": false,
"name": "Custom Site",
"id": "1923389485789821"
},
"product_type": {
"image": "test-image",
"name": "WorkStation",
"id": "2384943264193232"
},
"computer_system": {
"system_manufacturer": "test-system_manufacturer",
"service_tag": "test-service_tag",
"bios_date": "test-bios_date",
"model": "test-model",
"bios_version": "test-bios_version"
},
"discovered_serial_number": "test-discovered_serial_number",
"location": "test-location",
"is_loaned": false,
"is_loanable": false,
"category": {
"name": "IT",
"description": "test-description",
"id": "1997305092151630"
},
"user": {
"email_id": "lincoln@zmail.com",
"is_technician": false,
"sms_mail": "linc123@xys_sms.co",
"phone": "test-phone",
"name": "Lincoln",
"mobile": "test-mobile",
"id": "2361423821215740",
"photo_url": "test-photo_url",
"is_vip_user": false
},
"last_success_audit": {
"description": "test-description",
"id": "1622960200349742",
"time": {
"display_value": "Nov 10, 2016 11:44 AM",
"value": "1478758440000"
},
"status": "test-status"
},
"state_history_comments": "test-state_history_comments",
"last_audit": {
"description": "test-description",
"id": "1803336484659606",
"time": {
"display_value": "Nov 10, 2016 11:44 AM",
"value": "1478758440000"
},
"status": "test-status"
}
}
],
"response_status": {
"status_code": 2000,
"status": "success"
},
"workstation": {
"total_cost": 1343434.4333,
"type": {
"name": "Asset",
"id": "1649390715844945"
},
"last_updated_by": {
"email_id": "lincoln@zmail.com",
"is_technician": false,
"sms_mail": "linc123@xys_sms.co",
"phone": "test-phone",
"name": "Lincoln",
"mobile": "test-mobile",
"id": "2142425626251990",
"photo_url": "test-photo_url",
"is_vip_user": false
},
"workstation_udf_fields": {
"udf_ref1": {
"name": "192.0.2.1",
"id": "2383435295982955"
},
"udf_boolean1": false,
"udf_long1": "2146315750139814",
"udf_date1": {
"display_value": "Nov 10, 2016 11:44 AM",
"value": "1478758440000"
},
"udf_double1": "test-udf_double1",
"udf_char1": "test-udf_char1",
"deptheadid": {
"name": "192.0.2.1",
"id": "1889653950643528"
}
},
"suggested_owner": {
"email_id": "lincoln@zmail.com",
"is_technician": false,
"sms_mail": "linc123@xys_sms.co",
"phone": "test-phone",
"name": "Lincoln",
"mobile": "test-mobile",
"id": "1673654869182367",
"photo_url": "test-photo_url",
"is_vip_user": false
},
"id": "1486219206716993",
"state": {
"name": "In Use",
"description": "test-description",
"id": "1760884326168587"
},
"barcode": "test-barcode",
"product_depreciation": {
"useful_life": "1715002937795032",
"id": "1586842880857110",
"depreciation_percent": 1343434.4333,
"salvage_value": 1343434.4333
},
"operational_cost": 1343434.4333,
"asset_tag": "test-asset_tag",
"created_time": {
"display_value": "Nov 10, 2016 11:44 AM",
"value": "1478758440000"
},
"vm_platform": {
"name": "test-name",
"id": "1773155525244224"
},
"created_by": {
"email_id": "lincoln@zmail.com",
"is_technician": false,
"sms_mail": "linc123@xys_sms.co",
"phone": "test-phone",
"name": "Lincoln",
"mobile": "test-mobile",
"id": "1801589762252307",
"photo_url": "test-photo_url",
"is_vip_user": false
},
"last_updated_time": {
"display_value": "Nov 10, 2016 11:44 AM",
"value": "1478758440000"
},
"purchase_order": "test-purchase_order",
"domain": {
"name": "test-name",
"id": "1696037655714510"
},
"udf_fields": {
"udf_ref1": {
"name": "192.0.2.1",
"id": "1745223879514455"
},
"udf_boolean1": false,
"udf_long1": "2028539216195970",
"udf_date1": {
"display_value": "Nov 10, 2016 11:44 AM",
"value": "1478758440000"
},
"udf_double1": "test-udf_double1",
"udf_char1": "test-udf_char1",
"deptheadid": {
"name": "192.0.2.1",
"id": "1877246149241500"
}
},
"name": "192.0.2.1",
"is_depreciation_configured": false,
"vm_host": {
"name": "test-name",
"id": "2414646938204563",
"barcode": "test-barcode"
},
"is_depreciation_calculated": false,
"region": {
"name": "test-name",
"id": "2409054167145143"
},
"monitors": [
{
"index": 43,
"serial_number": "test-serial_number",
"monitor_type": "test-monitor_type",
"max_resolution": "test-max_resolution",
"manufacturer": "test-manufacturer"
}
],
"loan": {
"start_time": {
"display_value": "Nov 10, 2016 11:44 AM",
"value": "1478758440000"
},
"id": "2247920633683743",
"returned_time": {
"display_value": "Nov 10, 2016 11:44 AM",
"value": "1478758440000"
},
"barcode": "test-barcode",
"due_by_time": {
"display_value": "Nov 10, 2016 11:44 AM",
"value": "1478758440000"
},
"loan_id": {
"display_value": "CH 44",
"value": "44"
}
},
"memory": {
"virtual_memory": "2410663899703708",
"physical_memory": "1754319726950337"
},
"last_logged_user": "test-last_logged_user",
"is_remote_control_prompt_enabled": false,
"retain_user_site": false,
"sound_card": {
"sound_card_name": "test-sound_card_name"
},
"acquisition_date": {
"display_value": "Nov 10, 2016 11:44 AM",
"value": "1478758440000"
},
"is_server": false,
"vm_type": 3,
"current_cost": 1343434.4333,
"mac_address": "test-mac_address",
"vendor": {
"name": "test-name",
"description": "test-description",
"id": "2356766178670354"
},
"operating_system": {
"os": "test-os",
"product_id": "test-product_id",
"service_pack": "test-service_pack",
"build_number": "test-build_number",
"version": "test-version"
},
"purchase_cost": 1343434.4333,
"department": {
"name": "Administration",
"id": "2466435259340378"
},
"keyboard": {
"keyboard_manufacturer": "test-keyboard_manufacturer",
"keyboard_serial_number": "test-keyboard_serial_number",
"keyboard_type": "test-keyboard_type"
},
"is_in_contract": false,
"product": {
"part_no": "test-part_no",
"name": "test-name",
"id": "2008084767365686",
"manufacturer": "test-manufacturer"
},
"comments": "test-comments",
"asset_depreciation": {
"useful_life": "2250211738352306",
"id": "2233959701362488",
"depreciation_percent": 1343434.4333,
"salvage_value": 1343434.4333
},
"expiry_date": {
"display_value": "Nov 10, 2016 11:44 AM",
"value": "1478758440000"
},
"used_by_asset": {
"name": "192.0.2.1",
"id": "2143573615825159",
"barcode": "test-barcode"
},
"serial_number": "test-serial_number",
"warranty_expiry": {
"display_value": "Nov 10, 2016 11:44 AM",
"value": "1478758440000"
},
"ip_address": "test-ip_address",
"site": {
"deleted": false,
"name": "Custom Site",
"id": "1671545002890907"
},
"product_type": {
"image": "test-image",
"name": "WorkStation",
"id": "1832785890539986"
},
"computer_system": {
"system_manufacturer": "test-system_manufacturer",
"service_tag": "test-service_tag",
"bios_date": "test-bios_date",
"model": "test-model",
"bios_version": "test-bios_version"
},
"discovered_serial_number": "test-discovered_serial_number",
"location": "test-location",
"is_loaned": false,
"is_loanable": false,
"category": {
"name": "IT",
"description": "test-description",
"id": "2379119634616365"
},
"user": {
"email_id": "lincoln@zmail.com",
"is_technician": false,
"sms_mail": "linc123@xys_sms.co",
"phone": "test-phone",
"name": "Lincoln",
"mobile": "test-mobile",
"id": "2402295321144263",
"photo_url": "test-photo_url",
"is_vip_user": false
},
"last_success_audit": {
"description": "test-description",
"id": "2411254017793585",
"time": {
"display_value": "Nov 10, 2016 11:44 AM",
"value": "1478758440000"
},
"status": "test-status"
},
"state_history_comments": "test-state_history_comments",
"last_audit": {
"description": "test-description",
"id": "1917291661909201",
"time": {
"display_value": "Nov 10, 2016 11:44 AM",
"value": "1478758440000"
},
"status": "test-status"
}
}
}
Get List Workstation
This operation helps you Get list workstations.
Url
<service domain|custom domain>/app/<portal>/api/v3/workstations
Attributes
id (long)
Unique identifier to identify the workstation
name (string)
Unique name to identify the asset
product (product)
Product of the asset
state (asset_state)
State of the asset
state_history_comments (string)
No Description
barcode (string)
Unique barcode used to identify the asset
More Attributes Expand all
$ curl -G <service domain|custom domain>/app/<portal>/api/v3/workstations\
-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='{}'
// Deluge Sample script
url = "<service domain|custom domain>/app/<portal>/api/v3/workstations";
headers = {"Accept":"application/vnd.manageengine.sdp.v3+json",
"Content-Type": "application/x-www-form-urlencoded",
"Authorization": "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"};
input_data = {};
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/workstations"
$headers = @{ "Accept" = "application/vnd.manageengine.sdp.v3+json"
"Authorization" = "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"
"Content-Type" = "application/x-www-form-urlencoded"}
$input_data = @'{}'@
$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/workstations"
headers ={"Accept": "application/vnd.manageengine.sdp.v3+json",
"Authorization" : "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx",
"Content-Type" : "application/x-www-form-urlencoded"}
input_data = '''{}'''
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())
{
"workstations": [
{
"type": {
"name": "Asset",
"id": "2086757453698733"
},
"last_updated_by": {
"email_id": "lincoln@zmail.com",
"is_technician": false,
"sms_mail": "linc123@xys_sms.co",
"phone": "test-phone",
"name": "Lincoln",
"mobile": "test-mobile",
"id": "1945129372923685",
"photo_url": "test-photo_url",
"is_vip_user": false
},
"id": "2145850624424580",
"state": {
"name": "In Use",
"description": "test-description",
"id": "2033639252748434"
},
"barcode": "test-barcode",
"created_time": {
"display_value": "Nov 10, 2016 11:44 AM",
"value": "1478758440000"
},
"vm_platform": {
"name": "test-name",
"id": "1482641145543465"
},
"created_by": {
"email_id": "lincoln@zmail.com",
"is_technician": false,
"sms_mail": "linc123@xys_sms.co",
"phone": "test-phone",
"name": "Lincoln",
"mobile": "test-mobile",
"id": "2373175621868871",
"photo_url": "test-photo_url",
"is_vip_user": false
},
"last_updated_time": {
"display_value": "Nov 10, 2016 11:44 AM",
"value": "1478758440000"
},
"name": "192.0.2.1",
"vm_host": {
"name": "test-name",
"id": "2035454080939526",
"barcode": "test-barcode"
},
"loan": {
"start_time": {
"display_value": "Nov 10, 2016 11:44 AM",
"value": "1478758440000"
},
"id": "1560233750132823",
"returned_time": {
"display_value": "Nov 10, 2016 11:44 AM",
"value": "1478758440000"
},
"barcode": "test-barcode",
"due_by_time": {
"display_value": "Nov 10, 2016 11:44 AM",
"value": "1478758440000"
},
"loan_id": {
"display_value": "CH 44",
"value": "44"
}
},
"last_logged_user": "test-last_logged_user",
"retain_user_site": false,
"is_server": false,
"vm_type": 46,
"purchase_cost": 1343434.4333,
"product": {
"part_no": "test-part_no",
"name": "test-name",
"id": "2228561388238701",
"manufacturer": "test-manufacturer"
},
"site": {
"deleted": false,
"name": "Custom Site",
"id": "2338712944980497"
},
"product_type": {
"image": "test-image",
"name": "WorkStation",
"id": "1521762705941349"
},
"computer_system": {
"system_manufacturer": "test-system_manufacturer",
"service_tag": "test-service_tag",
"bios_date": "test-bios_date",
"model": "test-model",
"bios_version": "test-bios_version"
},
"location": "test-location",
"is_loanable": false,
"category": {
"name": "IT",
"description": "test-description",
"id": "2093608256183647"
},
"state_history_comments": "test-state_history_comments"
}
],
"response_status": [
{
"status_code": 2000,
"status": "success"
}
],
"list_info": {
"has_more_rows": false,
"row_count": 1
}
}
Delete Workstation
This operation helps you Delete workstations.
Url
<service domain|custom domain>/app/<portal>/api/v3/workstations/{workstation_id}
$ curl <service domain|custom domain>/app/<portal>/api/v3/workstations/{workstation_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/workstations/{workstation_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/workstations/{workstation_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/workstations/{workstation_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"
}
}