Skip to content

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

id (long)
Numerical digits which are considered to have larger values.

Example

234759602834500

name (string)
Unique name to identify the asset

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

Example

Sample Content

product (product)
Product of the asset

product (product)
Indicates the product name of the asset

Example

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

state (asset_state)
State of the asset

state (asset_state)
Indicates the current state of the asset

Example

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

asset_tag (string)
Asset tag used to identify the asset

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

Example

Sample Content

state_history_comments (string)
No Description

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

Example

Sample Content

More Attributes Expand all

serial_number (string)

Serial number used to identify the asset

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

Example

Sample Content

barcode (string)

Unique barcode used to identify the asset

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

Example

Sample Content

acquisition_date (date)

Indicates the date when the asset was acquired.

acquisition_date (date)
Represents a date as a JSON Object. Would contain the value and the display_value attributes.

value : The time in long format (No. of milliseconds from Jan 1, 1970 ).

display_value : The time in a readable form in a format as personalized by the user. If not personalized, default format would be used.

warranty_expiry (date)

Indicates the date when the asset will approach the warranty expiry date.

warranty_expiry (date)
Represents a date as a JSON Object. Would contain the value and the display_value attributes.

value : The time in long format (No. of milliseconds from Jan 1, 1970 ).

display_value : The time in a readable form in a format as personalized by the user. If not personalized, default format would be used.

expiry_date (date)

Indicates the date when the asset will expire.

expiry_date (date)
Represents a date as a JSON Object. Would contain the value and the display_value attributes.

value : The time in long format (No. of milliseconds from Jan 1, 1970 ).

display_value : The time in a readable form in a format as personalized by the user. If not personalized, default format would be used.

location (string)

Location of the asset

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

Example

Sample Content

purchase_cost (double)

Purchase cost of the asset

purchase_cost (double)
These are numbers that can include contains decimals.

Example

23.08

is_swscan_needed (boolean)

Boolean value indicating whether this asset needs a software scan or not

is_swscan_needed (boolean)
Boolean value which can have two possible values. The values are true and false.

discovered_serial_number (string)

Discovered serial number to identify the asset

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

Example

Sample Content

retain_user_site (boolean)

No Description

retain_user_site (boolean)
Boolean value which can have two possible values. The values are true and false.

is_loanable (boolean)

Boolean value indicating whether this asset is loanable or not

is_loanable (boolean)
Boolean value which can have two possible values. The values are true and false.

vendor (vendor)

Vendor of the asset

vendor (vendor)
Indicates the vendor of the asset

Example

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

site (site)

Site of the asset

site (site)
Indicates the site of the workstation

Example

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

udf_fields (udf_fields)

Holds udf fields’ values associated with the asset

udf_fields (udf_fields)
Holds udf fields’ values associated with the asset

user (user)

Asset assigned to the user

user (user)
Indicates the user associated with the workstation

Example

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

department (department)

Department to which this requester belongs

department (department)
Indicates the department to which the asset belongs

Example

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

used_by_asset (asset)

Asset associated to this asset

used_by_asset (asset)
Indicates the asset associated with the workstation

Example

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

device_type (device_type)

Device type of the asset

device_type (device_type)
Indicates the device type of the workstation

Example

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

credential (credential)

Credentials of the asset

credential (credential)

Example

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

probe (probe)

Probe associated to the asset

probe (probe)
Indicates the probe of the workstation

Example

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

attachments (attachment)

Attachments for this asset

attachments (attachment)
Indicates the attachments for this asset

Example

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

suggested_owner (user)

Suggested owner for the asset

suggested_owner (user)
Indicates the suggested owner for the asset

Example

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

product_type (product_type)read only

Product type of the product

product_type (product_type)
Indicates the product type of the workstation

Example

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

type (asset_type)read only

Type of the product type. For ex: Asset,Component,Software,Consumable

type (asset_type)

Example

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

category (asset_category)read only

Category of the product type. For ex: IT, Non-IT

category (asset_category)
Indicates the category of product type of the workstation

Example

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

ip_address (string)read only

No Description

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

Example

Sample Content

mac_address (string)read only

No Description

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

Example

Sample Content

region (region)read only

Region of the site

region (region)
Indicates the region to which the asset belongs

Example

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

operational_cost (double)read only

Operational cost of the asset

operational_cost (double)
These are numbers that can include contains decimals.

Example

23.08

total_cost (double)read only

Total cost of the asset

total_cost (double)
These are numbers that can include contains decimals.

Example

23.08

current_cost (double)read only

Current value of the asset

current_cost (double)
These are numbers that can include contains decimals.

Example

23.08

asset_depreciation (depreciation_detail)read only

Depreciation details configured for the asset

asset_depreciation (depreciation_detail)
Indicates the asset depreciation information of the workstation

Example

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

product_depreciation (depreciation_detail)read only

Depreciation details configured for the asset’s product

product_depreciation (depreciation_detail)
Indicates the depreciation details configured for the asset’s product

Example

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

is_depreciation_configured (boolean)read only

Boolean value indicating whether this asset depreciation is configured or not

is_depreciation_configured (boolean)
Boolean value which can have two possible values. The values are true and false.

is_depreciation_calculated (boolean)read only

Boolean value indicating whether this asset depreciation is calculated or not

is_depreciation_calculated (boolean)
Boolean value which can have two possible values. The values are true and false.

is_loaned (boolean)read only

Boolean value indicating whether this asset is loaned or not  

is_loaned (boolean)
Boolean value which can have two possible values. The values are true and false.

created_time (datetime)read only

Indicates the time when the asset was created.

created_time (datetime)
Represents a date/time as a JSON Object. Would contain the value and the display_value attributes.

value : The time in long format (No. of milliseconds from Jan 1, 1970 ).

display_value : The time in a readable form in a format as personalized by the user. If not personalized, default format would be used.

last_updated_time (datetime)read only

Indicates the time when the asset was last updated

last_updated_time (datetime)
Represents a date/time as a JSON Object. Would contain the value and the display_value attributes.

value : The time in long format (No. of milliseconds from Jan 1, 1970 ).

display_value : The time in a readable form in a format as personalized by the user. If not personalized, default format would be used.

created_by (user)read only

Indicates the user who created the asse

created_by (user)
Indicates the user who created/added the workstation

Example

{
  "created_by": {
    "email_id": "andrews@zmail.com",
    "name": "test-created_by",
    "id": "234567890123456"
  }
}

last_updated_by (user)read only

Indicates the user who updated the asset

last_updated_by (user)

Example

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

purchase_lot_id (long)read only

Indicates the purchase lot id of this asset

purchase_lot_id (long)
Numerical digits which are considered to have larger values.

Example

234759602834500

purchase_order (purchase_order)read only

Details of the purchase order associated with this asset

purchase_order (purchase_order)

is_in_contract (boolean)read only

No Description

is_in_contract (boolean)
Boolean value which can have two possible values. The values are true and false.

last_audit (audit_history)read only

Last audit field that displays last scan time and status

last_audit (audit_history)
Indicates the last scan time

Example

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

last_success_audit (audit_history)read only

Last success audit field displays last success scan time

last_success_audit (audit_history)
Indicates the last successful audit on the workstation

Example

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

loan (loaned_asset)read only

Indicates the loan information such as (Loan ID, Loan Period)

loan (loaned_asset)

Add Workstation

This operation helps you Add workstations.

Mandatory Fields :- name, product, state

Url

api/v3/workstations

Attributes

id (long)
Unique identifier to identify the workstation

id (long)
Numerical digits which are considered to have larger values.

Example

234759602834500

name (string)
Unique name to identify the asset

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

Example

Sample Content

product (product)
Product of the asset

product (product)
Indicates the product name of the asset

Example

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

state (asset_state)
State of the asset

state (asset_state)
Indicates the current state of the asset

Example

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

asset_tag (string)
Asset tag used to identify the asset

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

Example

Sample Content

state_history_comments (string)
No Description

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

Example

Sample Content

More Attributes Expand all

serial_number (string)

Serial number used to identify the asset

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

Example

Sample Content

barcode (string)

Unique barcode used to identify the asset

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

Example

Sample Content

acquisition_date (date)

Indicates the date when the asset was acquired.

acquisition_date (date)
Represents a date as a JSON Object. Would contain the value and the display_value attributes.

value : The time in long format (No. of milliseconds from Jan 1, 1970 ).

display_value : The time in a readable form in a format as personalized by the user. If not personalized, default format would be used.

warranty_expiry (date)

Indicates the date when the asset will approach the warranty expiry date.

warranty_expiry (date)
Represents a date as a JSON Object. Would contain the value and the display_value attributes.

value : The time in long format (No. of milliseconds from Jan 1, 1970 ).

display_value : The time in a readable form in a format as personalized by the user. If not personalized, default format would be used.

expiry_date (date)

Indicates the date when the asset will expire.

expiry_date (date)
Represents a date as a JSON Object. Would contain the value and the display_value attributes.

value : The time in long format (No. of milliseconds from Jan 1, 1970 ).

display_value : The time in a readable form in a format as personalized by the user. If not personalized, default format would be used.

location (string)

Location of the asset

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

Example

Sample Content

purchase_cost (double)

Purchase cost of the asset

purchase_cost (double)
These are numbers that can include contains decimals.

Example

23.08

is_swscan_needed (boolean)

Boolean value indicating whether this asset needs a software scan or not

is_swscan_needed (boolean)
Boolean value which can have two possible values. The values are true and false.

discovered_serial_number (string)

Discovered serial number to identify the asset

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

Example

Sample Content

retain_user_site (boolean)

No Description

retain_user_site (boolean)
Boolean value which can have two possible values. The values are true and false.

is_loanable (boolean)

Boolean value indicating whether this asset is loanable or not

is_loanable (boolean)
Boolean value which can have two possible values. The values are true and false.

vendor (vendor)

Vendor of the asset

vendor (vendor)
Indicates the vendor of the asset

Example

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

site (site)

Site of the asset

site (site)
Indicates the site of the workstation

Example

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

udf_fields (udf_fields)

Holds udf fields’ values associated with the asset

udf_fields (udf_fields)
Holds udf fields’ values associated with the asset

user (user)

Asset assigned to the user

user (user)
Indicates the user associated with the workstation

Example

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

department (department)

Department to which this requester belongs

department (department)
Indicates the department to which the asset belongs

Example

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

used_by_asset (asset)

Asset associated to this asset

used_by_asset (asset)
Indicates the asset associated with the workstation

Example

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

device_type (device_type)

Device type of the asset

device_type (device_type)
Indicates the device type of the workstation

Example

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

credential (credential)

Credentials of the asset

credential (credential)

Example

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

probe (probe)

Probe associated to the asset

probe (probe)
Indicates the probe of the workstation

Example

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

attachments (attachment)

Attachments for this asset

attachments (attachment)
Indicates the attachments for this asset

Example

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

suggested_owner (user)

Suggested owner for the asset

suggested_owner (user)
Indicates the suggested owner for the asset

Example

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

product_type (product_type)read only

Product type of the product

product_type (product_type)
Indicates the product type of the workstation

Example

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

type (asset_type)read only

Type of the product type. For ex: Asset,Component,Software,Consumable

type (asset_type)

Example

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

category (asset_category)read only

Category of the product type. For ex: IT, Non-IT

category (asset_category)
Indicates the category of product type of the workstation

Example

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

ip_address (string)read only

No Description

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

Example

Sample Content

mac_address (string)read only

No Description

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

Example

Sample Content

region (region)read only

Region of the site

region (region)
Indicates the region to which the asset belongs

Example

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

operational_cost (double)read only

Operational cost of the asset

operational_cost (double)
These are numbers that can include contains decimals.

Example

23.08

total_cost (double)read only

Total cost of the asset

total_cost (double)
These are numbers that can include contains decimals.

Example

23.08

current_cost (double)read only

Current value of the asset

current_cost (double)
These are numbers that can include contains decimals.

Example

23.08

asset_depreciation (depreciation_detail)read only

Depreciation details configured for the asset

asset_depreciation (depreciation_detail)
Indicates the asset depreciation information of the workstation

Example

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

product_depreciation (depreciation_detail)read only

Depreciation details configured for the asset’s product

product_depreciation (depreciation_detail)
Indicates the depreciation details configured for the asset’s product

Example

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

is_depreciation_configured (boolean)read only

Boolean value indicating whether this asset depreciation is configured or not

is_depreciation_configured (boolean)
Boolean value which can have two possible values. The values are true and false.

is_depreciation_calculated (boolean)read only

Boolean value indicating whether this asset depreciation is calculated or not

is_depreciation_calculated (boolean)
Boolean value which can have two possible values. The values are true and false.

is_loaned (boolean)read only

Boolean value indicating whether this asset is loaned or not  

is_loaned (boolean)
Boolean value which can have two possible values. The values are true and false.

created_time (datetime)read only

Indicates the time when the asset was created.

created_time (datetime)
Represents a date/time as a JSON Object. Would contain the value and the display_value attributes.

value : The time in long format (No. of milliseconds from Jan 1, 1970 ).

display_value : The time in a readable form in a format as personalized by the user. If not personalized, default format would be used.

last_updated_time (datetime)read only

Indicates the time when the asset was last updated

last_updated_time (datetime)
Represents a date/time as a JSON Object. Would contain the value and the display_value attributes.

value : The time in long format (No. of milliseconds from Jan 1, 1970 ).

display_value : The time in a readable form in a format as personalized by the user. If not personalized, default format would be used.

created_by (user)read only

Indicates the user who created the asse

created_by (user)
Indicates the user who created/added the workstation

Example

{
  "created_by": {
    "email_id": "andrews@zmail.com",
    "name": "test-created_by",
    "id": "234567890123456"
  }
}

last_updated_by (user)read only

Indicates the user who updated the asset

last_updated_by (user)

Example

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

purchase_lot_id (long)read only

Indicates the purchase lot id of this asset

purchase_lot_id (long)
Numerical digits which are considered to have larger values.

Example

234759602834500

purchase_order (purchase_order)read only

Details of the purchase order associated with this asset

purchase_order (purchase_order)

is_in_contract (boolean)read only

No Description

is_in_contract (boolean)
Boolean value which can have two possible values. The values are true and false.

last_audit (audit_history)read only

Last audit field that displays last scan time and status

last_audit (audit_history)
Indicates the last scan time

Example

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

last_success_audit (audit_history)read only

Last success audit field displays last success scan time

last_success_audit (audit_history)
Indicates the last successful audit on the workstation

Example

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

loan (loaned_asset)read only

Indicates the loan information such as (Loan ID, Loan Period)

loan (loaned_asset)

$ curl <url>/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 = "<url>/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 = "<url>/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 = "<url>/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

api/v3/workstations/{workstation_id}

Attributes

id (long)
Unique identifier to identify the workstation

id (long)
Numerical digits which are considered to have larger values.

Example

234759602834500

name (string)
Unique name to identify the asset

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

Example

Sample Content

product (product)
Product of the asset

product (product)
Indicates the product name of the asset

Example

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

state (asset_state)
State of the asset

state (asset_state)
Indicates the current state of the asset

Example

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

asset_tag (string)
Asset tag used to identify the asset

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

Example

Sample Content

state_history_comments (string)
No Description

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

Example

Sample Content

More Attributes Expand all

serial_number (string)

Serial number used to identify the asset

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

Example

Sample Content

barcode (string)

Unique barcode used to identify the asset

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

Example

Sample Content

acquisition_date (date)

Indicates the date when the asset was acquired.

acquisition_date (date)
Represents a date as a JSON Object. Would contain the value and the display_value attributes.

value : The time in long format (No. of milliseconds from Jan 1, 1970 ).

display_value : The time in a readable form in a format as personalized by the user. If not personalized, default format would be used.

warranty_expiry (date)

Indicates the date when the asset will approach the warranty expiry date.

warranty_expiry (date)
Represents a date as a JSON Object. Would contain the value and the display_value attributes.

value : The time in long format (No. of milliseconds from Jan 1, 1970 ).

display_value : The time in a readable form in a format as personalized by the user. If not personalized, default format would be used.

expiry_date (date)

Indicates the date when the asset will expire.

expiry_date (date)
Represents a date as a JSON Object. Would contain the value and the display_value attributes.

value : The time in long format (No. of milliseconds from Jan 1, 1970 ).

display_value : The time in a readable form in a format as personalized by the user. If not personalized, default format would be used.

location (string)

Location of the asset

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

Example

Sample Content

purchase_cost (double)

Purchase cost of the asset

purchase_cost (double)
These are numbers that can include contains decimals.

Example

23.08

is_swscan_needed (boolean)

Boolean value indicating whether this asset needs a software scan or not

is_swscan_needed (boolean)
Boolean value which can have two possible values. The values are true and false.

discovered_serial_number (string)

Discovered serial number to identify the asset

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

Example

Sample Content

retain_user_site (boolean)

No Description

retain_user_site (boolean)
Boolean value which can have two possible values. The values are true and false.

is_loanable (boolean)

Boolean value indicating whether this asset is loanable or not

is_loanable (boolean)
Boolean value which can have two possible values. The values are true and false.

vendor (vendor)

Vendor of the asset

vendor (vendor)
Indicates the vendor of the asset

Example

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

site (site)

Site of the asset

site (site)
Indicates the site of the workstation

Example

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

udf_fields (udf_fields)

Holds udf fields’ values associated with the asset

udf_fields (udf_fields)
Holds udf fields’ values associated with the asset

user (user)

Asset assigned to the user

user (user)
Indicates the user associated with the workstation

Example

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

department (department)

Department to which this requester belongs

department (department)
Indicates the department to which the asset belongs

Example

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

used_by_asset (asset)

Asset associated to this asset

used_by_asset (asset)
Indicates the asset associated with the workstation

Example

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

device_type (device_type)

Device type of the asset

device_type (device_type)
Indicates the device type of the workstation

Example

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

credential (credential)

Credentials of the asset

credential (credential)

Example

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

probe (probe)

Probe associated to the asset

probe (probe)
Indicates the probe of the workstation

Example

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

attachments (attachment)

Attachments for this asset

attachments (attachment)
Indicates the attachments for this asset

Example

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

suggested_owner (user)

Suggested owner for the asset

suggested_owner (user)
Indicates the suggested owner for the asset

Example

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

product_type (product_type)read only

Product type of the product

product_type (product_type)
Indicates the product type of the workstation

Example

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

type (asset_type)read only

Type of the product type. For ex: Asset,Component,Software,Consumable

type (asset_type)

Example

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

category (asset_category)read only

Category of the product type. For ex: IT, Non-IT

category (asset_category)
Indicates the category of product type of the workstation

Example

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

ip_address (string)read only

No Description

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

Example

Sample Content

mac_address (string)read only

No Description

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

Example

Sample Content

region (region)read only

Region of the site

region (region)
Indicates the region to which the asset belongs

Example

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

operational_cost (double)read only

Operational cost of the asset

operational_cost (double)
These are numbers that can include contains decimals.

Example

23.08

total_cost (double)read only

Total cost of the asset

total_cost (double)
These are numbers that can include contains decimals.

Example

23.08

current_cost (double)read only

Current value of the asset

current_cost (double)
These are numbers that can include contains decimals.

Example

23.08

asset_depreciation (depreciation_detail)read only

Depreciation details configured for the asset

asset_depreciation (depreciation_detail)
Indicates the asset depreciation information of the workstation

Example

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

product_depreciation (depreciation_detail)read only

Depreciation details configured for the asset’s product

product_depreciation (depreciation_detail)
Indicates the depreciation details configured for the asset’s product

Example

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

is_depreciation_configured (boolean)read only

Boolean value indicating whether this asset depreciation is configured or not

is_depreciation_configured (boolean)
Boolean value which can have two possible values. The values are true and false.

is_depreciation_calculated (boolean)read only

Boolean value indicating whether this asset depreciation is calculated or not

is_depreciation_calculated (boolean)
Boolean value which can have two possible values. The values are true and false.

is_loaned (boolean)read only

Boolean value indicating whether this asset is loaned or not  

is_loaned (boolean)
Boolean value which can have two possible values. The values are true and false.

created_time (datetime)read only

Indicates the time when the asset was created.

created_time (datetime)
Represents a date/time as a JSON Object. Would contain the value and the display_value attributes.

value : The time in long format (No. of milliseconds from Jan 1, 1970 ).

display_value : The time in a readable form in a format as personalized by the user. If not personalized, default format would be used.

last_updated_time (datetime)read only

Indicates the time when the asset was last updated

last_updated_time (datetime)
Represents a date/time as a JSON Object. Would contain the value and the display_value attributes.

value : The time in long format (No. of milliseconds from Jan 1, 1970 ).

display_value : The time in a readable form in a format as personalized by the user. If not personalized, default format would be used.

created_by (user)read only

Indicates the user who created the asse

created_by (user)
Indicates the user who created/added the workstation

Example

{
  "created_by": {
    "email_id": "andrews@zmail.com",
    "name": "test-created_by",
    "id": "234567890123456"
  }
}

last_updated_by (user)read only

Indicates the user who updated the asset

last_updated_by (user)

Example

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

purchase_lot_id (long)read only

Indicates the purchase lot id of this asset

purchase_lot_id (long)
Numerical digits which are considered to have larger values.

Example

234759602834500

purchase_order (purchase_order)read only

Details of the purchase order associated with this asset

purchase_order (purchase_order)

is_in_contract (boolean)read only

No Description

is_in_contract (boolean)
Boolean value which can have two possible values. The values are true and false.

last_audit (audit_history)read only

Last audit field that displays last scan time and status

last_audit (audit_history)
Indicates the last scan time

Example

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

last_success_audit (audit_history)read only

Last success audit field displays last success scan time

last_success_audit (audit_history)
Indicates the last successful audit on the workstation

Example

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

loan (loaned_asset)read only

Indicates the loan information such as (Loan ID, Loan Period)

loan (loaned_asset)

$ curl <url>/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 = "<url>/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 = "<url>/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 = "<url>/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

api/v3/workstations/{workstation_id}

Attributes

id (long)
Unique identifier to identify the workstation

id (long)
Numerical digits which are considered to have larger values.

Example

234759602834500

name (string)
Unique name to identify the asset

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

Example

Sample Content

product (product)
Product of the asset

product (product)
Indicates the product name of the asset

Example

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

state (asset_state)
State of the asset

state (asset_state)
Indicates the current state of the asset

Example

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

asset_tag (string)
Asset tag used to identify the asset

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

Example

Sample Content

state_history_comments (string)
No Description

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

Example

Sample Content

More Attributes Expand all

serial_number (string)

Serial number used to identify the asset

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

Example

Sample Content

barcode (string)

Unique barcode used to identify the asset

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

Example

Sample Content

acquisition_date (date)

Indicates the date when the asset was acquired.

acquisition_date (date)
Represents a date as a JSON Object. Would contain the value and the display_value attributes.

value : The time in long format (No. of milliseconds from Jan 1, 1970 ).

display_value : The time in a readable form in a format as personalized by the user. If not personalized, default format would be used.

warranty_expiry (date)

Indicates the date when the asset will approach the warranty expiry date.

warranty_expiry (date)
Represents a date as a JSON Object. Would contain the value and the display_value attributes.

value : The time in long format (No. of milliseconds from Jan 1, 1970 ).

display_value : The time in a readable form in a format as personalized by the user. If not personalized, default format would be used.

expiry_date (date)

Indicates the date when the asset will expire.

expiry_date (date)
Represents a date as a JSON Object. Would contain the value and the display_value attributes.

value : The time in long format (No. of milliseconds from Jan 1, 1970 ).

display_value : The time in a readable form in a format as personalized by the user. If not personalized, default format would be used.

location (string)

Location of the asset

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

Example

Sample Content

purchase_cost (double)

Purchase cost of the asset

purchase_cost (double)
These are numbers that can include contains decimals.

Example

23.08

is_swscan_needed (boolean)

Boolean value indicating whether this asset needs a software scan or not

is_swscan_needed (boolean)
Boolean value which can have two possible values. The values are true and false.

discovered_serial_number (string)

Discovered serial number to identify the asset

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

Example

Sample Content

retain_user_site (boolean)

No Description

retain_user_site (boolean)
Boolean value which can have two possible values. The values are true and false.

is_loanable (boolean)

Boolean value indicating whether this asset is loanable or not

is_loanable (boolean)
Boolean value which can have two possible values. The values are true and false.

vendor (vendor)

Vendor of the asset

vendor (vendor)
Indicates the vendor of the asset

Example

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

site (site)

Site of the asset

site (site)
Indicates the site of the workstation

Example

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

udf_fields (udf_fields)

Holds udf fields’ values associated with the asset

udf_fields (udf_fields)
Holds udf fields’ values associated with the asset

user (user)

Asset assigned to the user

user (user)
Indicates the user associated with the workstation

Example

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

department (department)

Department to which this requester belongs

department (department)
Indicates the department to which the asset belongs

Example

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

used_by_asset (asset)

Asset associated to this asset

used_by_asset (asset)
Indicates the asset associated with the workstation

Example

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

device_type (device_type)

Device type of the asset

device_type (device_type)
Indicates the device type of the workstation

Example

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

credential (credential)

Credentials of the asset

credential (credential)

Example

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

probe (probe)

Probe associated to the asset

probe (probe)
Indicates the probe of the workstation

Example

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

attachments (attachment)

Attachments for this asset

attachments (attachment)
Indicates the attachments for this asset

Example

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

suggested_owner (user)

Suggested owner for the asset

suggested_owner (user)
Indicates the suggested owner for the asset

Example

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

product_type (product_type)read only

Product type of the product

product_type (product_type)
Indicates the product type of the workstation

Example

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

type (asset_type)read only

Type of the product type. For ex: Asset,Component,Software,Consumable

type (asset_type)

Example

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

category (asset_category)read only

Category of the product type. For ex: IT, Non-IT

category (asset_category)
Indicates the category of product type of the workstation

Example

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

ip_address (string)read only

No Description

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

Example

Sample Content

mac_address (string)read only

No Description

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

Example

Sample Content

region (region)read only

Region of the site

region (region)
Indicates the region to which the asset belongs

Example

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

operational_cost (double)read only

Operational cost of the asset

operational_cost (double)
These are numbers that can include contains decimals.

Example

23.08

total_cost (double)read only

Total cost of the asset

total_cost (double)
These are numbers that can include contains decimals.

Example

23.08

current_cost (double)read only

Current value of the asset

current_cost (double)
These are numbers that can include contains decimals.

Example

23.08

asset_depreciation (depreciation_detail)read only

Depreciation details configured for the asset

asset_depreciation (depreciation_detail)
Indicates the asset depreciation information of the workstation

Example

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

product_depreciation (depreciation_detail)read only

Depreciation details configured for the asset’s product

product_depreciation (depreciation_detail)
Indicates the depreciation details configured for the asset’s product

Example

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

is_depreciation_configured (boolean)read only

Boolean value indicating whether this asset depreciation is configured or not

is_depreciation_configured (boolean)
Boolean value which can have two possible values. The values are true and false.

is_depreciation_calculated (boolean)read only

Boolean value indicating whether this asset depreciation is calculated or not

is_depreciation_calculated (boolean)
Boolean value which can have two possible values. The values are true and false.

is_loaned (boolean)read only

Boolean value indicating whether this asset is loaned or not  

is_loaned (boolean)
Boolean value which can have two possible values. The values are true and false.

created_time (datetime)read only

Indicates the time when the asset was created.

created_time (datetime)
Represents a date/time as a JSON Object. Would contain the value and the display_value attributes.

value : The time in long format (No. of milliseconds from Jan 1, 1970 ).

display_value : The time in a readable form in a format as personalized by the user. If not personalized, default format would be used.

last_updated_time (datetime)read only

Indicates the time when the asset was last updated

last_updated_time (datetime)
Represents a date/time as a JSON Object. Would contain the value and the display_value attributes.

value : The time in long format (No. of milliseconds from Jan 1, 1970 ).

display_value : The time in a readable form in a format as personalized by the user. If not personalized, default format would be used.

created_by (user)read only

Indicates the user who created the asse

created_by (user)
Indicates the user who created/added the workstation

Example

{
  "created_by": {
    "email_id": "andrews@zmail.com",
    "name": "test-created_by",
    "id": "234567890123456"
  }
}

last_updated_by (user)read only

Indicates the user who updated the asset

last_updated_by (user)

Example

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

purchase_lot_id (long)read only

Indicates the purchase lot id of this asset

purchase_lot_id (long)
Numerical digits which are considered to have larger values.

Example

234759602834500

purchase_order (purchase_order)read only

Details of the purchase order associated with this asset

purchase_order (purchase_order)

is_in_contract (boolean)read only

No Description

is_in_contract (boolean)
Boolean value which can have two possible values. The values are true and false.

last_audit (audit_history)read only

Last audit field that displays last scan time and status

last_audit (audit_history)
Indicates the last scan time

Example

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

last_success_audit (audit_history)read only

Last success audit field displays last success scan time

last_success_audit (audit_history)
Indicates the last successful audit on the workstation

Example

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

loan (loaned_asset)read only

Indicates the loan information such as (Loan ID, Loan Period)

loan (loaned_asset)

$ curl -G <url>/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 = "<url>/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 = "<url>/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 = "<url>/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

api/v3/workstations

Attributes

id (long)
Unique identifier to identify the workstation

id (long)
Numerical digits which are considered to have larger values.

Example

234759602834500

name (string)
Unique name to identify the asset

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

Example

Sample Content

product (product)
Product of the asset

product (product)
Indicates the product name of the asset

Example

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

state (asset_state)
State of the asset

state (asset_state)
Indicates the current state of the asset

Example

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

state_history_comments (string)
No Description

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

Example

Sample Content

barcode (string)
Unique barcode used to identify the asset

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

Example

Sample Content

More Attributes Expand all

location (string)

Location of the asset

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

Example

Sample Content

purchase_cost (double)

Purchase cost of the asset

purchase_cost (double)
These are numbers that can include contains decimals.

Example

23.08

retain_user_site (boolean)

No Description

retain_user_site (boolean)
Boolean value which can have two possible values. The values are true and false.

is_loanable (boolean)

Boolean value indicating whether this asset is loanable or not

is_loanable (boolean)
Boolean value which can have two possible values. The values are true and false.

site (site)

Site of the asset

site (site)
Indicates the site of the workstation

Example

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

attachments (attachment)

Attachments for this asset

attachments (attachment)
Indicates the attachments for this asset

Example

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

product_type (product_type)read only

Product type of the product

product_type (product_type)
Indicates the product type of the workstation

Example

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

type (asset_type)read only

Type of the product type. For ex: Asset,Component,Software,Consumable

type (asset_type)

Example

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

category (asset_category)read only

Category of the product type. For ex: IT, Non-IT

category (asset_category)
Indicates the category of product type of the workstation

Example

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

created_time (datetime)read only

Indicates the time when the asset was created.

created_time (datetime)
Represents a date/time as a JSON Object. Would contain the value and the display_value attributes.

value : The time in long format (No. of milliseconds from Jan 1, 1970 ).

display_value : The time in a readable form in a format as personalized by the user. If not personalized, default format would be used.

last_updated_time (datetime)read only

Indicates the time when the asset was last updated

last_updated_time (datetime)
Represents a date/time as a JSON Object. Would contain the value and the display_value attributes.

value : The time in long format (No. of milliseconds from Jan 1, 1970 ).

display_value : The time in a readable form in a format as personalized by the user. If not personalized, default format would be used.

created_by (user)read only

Indicates the user who created the asse

created_by (user)
Indicates the user who created/added the workstation

Example

{
  "created_by": {
    "email_id": "andrews@zmail.com",
    "name": "test-created_by",
    "id": "234567890123456"
  }
}

last_updated_by (user)read only

Indicates the user who updated the asset

last_updated_by (user)

Example

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

loan (loaned_asset)read only

Indicates the loan information such as (Loan ID, Loan Period)

loan (loaned_asset)

$ curl -G <url>/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 = "<url>/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 = "<url>/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 = "<url>/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

api/v3/workstations/{workstation_id}

$ curl <url>/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 = "<url>/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 = "<url>/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 = "<url>/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"
  }
}