<service domain|custom domain>/app/<portal>/api/v3/{product_type_api_name}
Custom Asset
Details of Customised product types can be organised and tracked under the custom product type
Attributes
Add Custom Asset
This operation helps you create new custom assets.
Mandatory Fields :- name
Url
Attributes
id (long)
Denotes the unique identifier used to identify the custom asset
name (string)
Indicates the unique name used to identify the asset
udf_fields (udf_fields)
Holds the additional fields which were created for a specific product type and its parent types.
$ curl <service domain|custom domain>/app/<portal>/api/v3/{product_type_api_name}\
-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='{
"name": "LAP-IND-0921",
"asset_tag": "LAP-0921",
"serial_number": "C02XK1ABJG5J",
"product": {
"name": "MacBook Pro 14 M3"
},
"vendor": {
"name": "Apple India Pvt Ltd"
},
"site": {
"name": "Bangalore"
},
"user": {
"email_id": "rita@acme.com"
},
"department": {
"name": "Engineering"
},
"ip_address": "10.34.12.91",
"mac_address": "8C:85:90:C1:9A:1F",
"acquisition_date": {
"value": "1715731200000"
},
"warranty_expiry": {
"value": "1810339200000"
},
"is_loanable": true,
"udf_fields": {
"screen_size": "14 inch",
"ram_size": 18,
"storage_type": "NVMe",
"storage_capacity": 1024,
"operating_system": "macOS 15 Sequoia",
"handover_date": {
"value": "1716422400000"
},
"insurance_provider": {
"name": "ICICI Lombard"
}
}
}'
// Deluge Sample script
url = "<service domain|custom domain>/app/<portal>/api/v3/{product_type_api_name}";
headers = {"Accept":"application/vnd.manageengine.sdp.v3+json",
"Content-Type": "application/x-www-form-urlencoded",
"Authorization": "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"};
input_data = {
"name": "LAP-IND-0921",
"asset_tag": "LAP-0921",
"serial_number": "C02XK1ABJG5J",
"product": {
"name": "MacBook Pro 14 M3"
},
"vendor": {
"name": "Apple India Pvt Ltd"
},
"site": {
"name": "Bangalore"
},
"user": {
"email_id": "rita@acme.com"
},
"department": {
"name": "Engineering"
},
"ip_address": "10.34.12.91",
"mac_address": "8C:85:90:C1:9A:1F",
"acquisition_date": {
"value": "1715731200000"
},
"warranty_expiry": {
"value": "1810339200000"
},
"is_loanable": true,
"udf_fields": {
"screen_size": "14 inch",
"ram_size": 18,
"storage_type": "NVMe",
"storage_capacity": 1024,
"operating_system": "macOS 15 Sequoia",
"handover_date": {
"value": "1716422400000"
},
"insurance_provider": {
"name": "ICICI Lombard"
}
}
};
params = {"input_data": input_data};
response = invokeurl
[
url: url
type: POST
parameters: params
headers: headers
];
info response;
#Powershell version - 5.1
$url = "<service domain|custom domain>/app/<portal>/api/v3/{product_type_api_name}"
$headers = @{ "Accept" = "application/vnd.manageengine.sdp.v3+json"
"Authorization" = "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"
"Content-Type" = "application/x-www-form-urlencoded"}
$input_data = @'
{
"name": "LAP-IND-0921",
"asset_tag": "LAP-0921",
"serial_number": "C02XK1ABJG5J",
"product": {
"name": "MacBook Pro 14 M3"
},
"vendor": {
"name": "Apple India Pvt Ltd"
},
"site": {
"name": "Bangalore"
},
"user": {
"email_id": "rita@acme.com"
},
"department": {
"name": "Engineering"
},
"ip_address": "10.34.12.91",
"mac_address": "8C:85:90:C1:9A:1F",
"acquisition_date": {
"value": "1715731200000"
},
"warranty_expiry": {
"value": "1810339200000"
},
"is_loanable": true,
"udf_fields": {
"screen_size": "14 inch",
"ram_size": 18,
"storage_type": "NVMe",
"storage_capacity": 1024,
"operating_system": "macOS 15 Sequoia",
"handover_date": {
"value": "1716422400000"
},
"insurance_provider": {
"name": "ICICI Lombard"
}
}
}
'@
$data = @{ 'input_data' = $input_data}
$response = Invoke-RestMethod -Uri $url -Method post -Body $data -Headers $headers
$response
#Python version - 3.10
from urllib.error import HTTPError
from urllib.parse import urlencode
from urllib.request import urlopen,Request
url = "<service domain|custom domain>/app/<portal>/api/v3/{product_type_api_name}"
headers ={"Accept": "application/vnd.manageengine.sdp.v3+json",
"Authorization" : "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx",
"Content-Type" : "application/x-www-form-urlencoded"}
input_data = '''{
"name": "LAP-IND-0921",
"asset_tag": "LAP-0921",
"serial_number": "C02XK1ABJG5J",
"product": {
"name": "MacBook Pro 14 M3"
},
"vendor": {
"name": "Apple India Pvt Ltd"
},
"site": {
"name": "Bangalore"
},
"user": {
"email_id": "rita@acme.com"
},
"department": {
"name": "Engineering"
},
"ip_address": "10.34.12.91",
"mac_address": "8C:85:90:C1:9A:1F",
"acquisition_date": {
"value": "1715731200000"
},
"warranty_expiry": {
"value": "1810339200000"
},
"is_loanable": true,
"udf_fields": {
"screen_size": "14 inch",
"ram_size": 18,
"storage_type": "NVMe",
"storage_capacity": 1024,
"operating_system": "macOS 15 Sequoia",
"handover_date": {
"value": "1716422400000"
},
"insurance_provider": {
"name": "ICICI Lombard"
}
}
}'''
data = urlencode({"input_data":input_data}).encode()
httprequest = Request(url, headers=headers,data=data, method="POST")
try:
with urlopen(httprequest) as response:
print(response.read().decode())
except HTTPError as e:
print(e.read().decode())
{
"response_status": [
{ "status_code": 2000, "status": "success" }
],
"custom_asset_laptop": {
"id" : "12000000183045",
"name" : "LAP-IND-0921",
"asset_tag" : "LAP-0921",
"serial_number" : "C02XK1ABJG5J",
"product_type" : { "id": "12000000034011", "name": "Laptop" },
"product" : { "id": "12000000034178", "name": "MacBook Pro 14 M3" },
"vendor" : { "id": "12000000017900", "name": "Apple India Pvt Ltd" },
"state" : { "id": "12000000005001", "name": "In Stock" },
"site" : { "id": "12000000003012", "name": "Bangalore" },
"user" : { "id": "12000000060145", "email_id": "rita@acme.com" },
"ip_address" : "10.34.12.91",
"mac_address" : "8C:85:90:C1:9A:1F",
"acquisition_date": { "value": "1715731200000", "display_value": "May 15, 2024 12:00 AM" },
"warranty_expiry" : { "value": "1810339200000", "display_value": "May 15, 2027 12:00 AM" },
"is_loanable" : true,
"udf_fields": {
"screen_size" : "14 inch",
"ram_size" : 18,
"storage_type" : "NVMe",
"storage_capacity" : 1024,
"operating_system" : "macOS 15 Sequoia",
"handover_date" : { "value": "1716422400000", "display_value": "May 23, 2024 12:00 AM" },
"insurance_provider": { "id": "12000000017945", "name": "ICICI Lombard" }
},
"created_time" : { "value": "1747312033000", "display_value": "May 15, 2026 06:30 PM" },
"created_by" : { "id": "12000000060001", "email_id": "admin@acme.com" }
}
}
Edit Custom Asset
This operation helps you edit custom assets.
Url
<service domain|custom domain>/app/<portal>/api/v3/{product_type_api_name}/{id}
Attributes
id (long)
Denotes the unique identifier used to identify the custom asset
name (string)
Indicates the unique name used to identify the asset
udf_fields (udf_fields)
Holds the additional fields which were created for a specific product type and its parent types.
$ curl <service domain|custom domain>/app/<portal>/api/v3/{product_type_api_name}/{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='{
"state": {
"name": "In Use"
},
"user": {
"email_id": "arjun@mail.com"
},
"location": "Tower B - 3rd floor",
"udf_fields": {
"handover_date": {
"value": "1747094400000"
},
"ram_size": 36
}
}'
// Deluge Sample script
url = "<service domain|custom domain>/app/<portal>/api/v3/{product_type_api_name}/{id}";
headers = {"Accept":"application/vnd.manageengine.sdp.v3+json",
"Content-Type": "application/x-www-form-urlencoded",
"Authorization": "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"};
input_data = {
"state": {
"name": "In Use"
},
"user": {
"email_id": "arjun@mail.com"
},
"location": "Tower B - 3rd floor",
"udf_fields": {
"handover_date": {
"value": "1747094400000"
},
"ram_size": 36
}
};
params = {"input_data": input_data};
response = invokeurl
[
url: url
type: PUT
parameters: params
headers: headers
];
info response;
#Powershell version - 5.1
$url = "<service domain|custom domain>/app/<portal>/api/v3/{product_type_api_name}/{id}"
$headers = @{"Accept": "application/vnd.manageengine.sdp.v3+json",
"Authorization" : "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx",
"Content-Type" : "application/x-www-form-urlencoded"}
$input_data = @'
{
"state": {
"name": "In Use"
},
"user": {
"email_id": "arjun@mail.com"
},
"location": "Tower B - 3rd floor",
"udf_fields": {
"handover_date": {
"value": "1747094400000"
},
"ram_size": 36
}
}
'@
$data = @{ 'input_data' = $input_data}
$response = Invoke-RestMethod -Uri $url -Method put -Body $data -Headers $headers
$response
#Python version - 3.10
from urllib.error import HTTPError
from urllib.parse import urlencode
from urllib.request import urlopen,Request
url = "<service domain|custom domain>/app/<portal>/api/v3/{product_type_api_name}/{id}"
headers ={"Accept": "application/vnd.manageengine.sdp.v3+json",
"Authorization" : "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx",
"Content-Type" : "application/x-www-form-urlencoded"}
input_data = '''{
"state": {
"name": "In Use"
},
"user": {
"email_id": "arjun@mail.com"
},
"location": "Tower B - 3rd floor",
"udf_fields": {
"handover_date": {
"value": "1747094400000"
},
"ram_size": 36
}
}'''
data = urlencode({"input_data":input_data}).encode()
httprequest = Request(url, headers=headers,data=data, method="PUT")
try:
with urlopen(httprequest) as response:
print(response.read().decode())
except HTTPError as e:
print(e.read().decode())
{
"response_status": [{ "status_code": 2000, "status": "success" }],
"custom_asset_laptop": {
"id" : "12000000183045",
"state" : { "id": "12000000005002", "name": "In Use" },
"user" : { "id": "12000000060178", "email_id": "arjun@mail.com" },
"location" : "Tower B - 3rd floor",
"udf_fields": {
"handover_date" : { "value": "1747094400000", "display_value": "May 12, 2026 04:30 PM" },
"ram_size" : 36
},
"last_updated_time": { "value": "1747312500000", "display_value": "May 15, 2026 06:38 PM" },
"last_updated_by" : { "email_id": "admin@acme.com" }
}
}
Get Custom Asset
This operation helps to get custom assets.
Url
<service domain|custom domain>/app/<portal>/api/v3/{product_type_api_name}/{id}
Attributes
id (long)
Denotes the unique identifier used to identify the custom asset
name (string)
Indicates the unique name used to identify the asset
udf_fields (udf_fields)
Holds the additional fields which were created for a specific product type and its parent types.
$ curl -G <service domain|custom domain>/app/<portal>/api/v3/{product_type_api_name}/{id}\
-X GET\
-H "Accept: application/vnd.manageengine.sdp.v3+json"\
-H "Authorization: Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"\
-H "Content-Type: application/x-www-form-urlencoded"
// Deluge Sample script
url = "<service domain|custom domain>/app/<portal>/api/v3/{product_type_api_name}/{id}";
headers = {"Accept":"application/vnd.manageengine.sdp.v3+json",
"Content-Type": "application/x-www-form-urlencoded",
"Authorization": "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"};
response = invokeurl
[
url: url
type: GET
headers: headers
];
info response;
#Powershell version - 5.1
$url = "<service domain|custom domain>/app/<portal>/api/v3/{product_type_api_name}/{id}"
$headers = @{ "Accept" = "application/vnd.manageengine.sdp.v3+json"
"Authorization" = "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"
"Content-Type" = "application/x-www-form-urlencoded"}
$response = Invoke-RestMethod -Uri $url -Method get -Headers $headers
$response
#Python version - 3.8
#This script requires requests module installed in python.
from urllib.error import HTTPError
from urllib.parse import urlencode
from urllib.request import urlopen,Request
url = "<service domain|custom domain>/app/<portal>/api/v3/{product_type_api_name}/{id}"
headers ={"Accept": "application/vnd.manageengine.sdp.v3+json",
"Authorization" : "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx",
"Content-Type" : "application/x-www-form-urlencoded"}
httprequest = Request(url, headers=headers)
try:
with urlopen(httprequest) as response:
print(response.read().decode())
except HTTPError as e:
print(e.read().decode())
{
"response_status": [{ "status_code": 2000, "status": "success" }],
"custom_asset_laptop": {
"id" : "12000000183045",
"name" : "LAP-IND-0921",
"asset_tag" : "LAP-0921",
"serial_number" : "C02XK1ABJG5J",
"product_type" : { "id": "12000000034011", "name": "Laptop" },
"product" : { "id": "12000000034178", "name": "MacBook Pro 14 M3" },
"vendor" : { "id": "12000000017900", "name": "Apple India Pvt Ltd" },
"state" : { "id": "12000000005002", "name": "In Use" },
"user" : { "id": "12000000060178", "email_id": "arjun@mail.com" },
"site" : { "id": "12000000003012", "name": "Bangalore" },
"location" : "Tower B - 3rd floor",
"ip_address" : "10.34.12.91",
"mac_address" : "8C:85:90:C1:9A:1F",
"is_loanable" : true,
"is_in_contract": true,
"current_cost" : 152400.00,
"warranty_expiry": { "value": "1810339200000", "display_value": "May 15, 2027 12:00 AM" },
"udf_fields": {
"screen_size" : "14 inch",
"ram_size" : 36,
"storage_type" : "NVMe",
"storage_capacity" : 1024,
"operating_system" : "macOS 15 Sequoia",
"handover_date" : { "value": "1747094400000", "display_value": "May 12, 2026 04:30 PM" },
"insurance_provider": { "id": "12000000017945", "name": "ICICI Lombard" }
},
"created_time" : { "value": "1715731200000", "display_value": "May 15, 2024 12:00 AM" },
"last_updated_time": { "value": "1747312500000", "display_value": "May 15, 2026 06:38 PM" }
}
}
Get List Custom Asset
This operation helps to get list of all the custom assets.
Url
<service domain|custom domain>/app/<portal>/api/v3/{product_type_api_name}
Attributes
id (long)
Denotes the unique identifier used to identify the custom asset
name (string)
Indicates the unique name used to identify the asset
$ curl -G <service domain|custom domain>/app/<portal>/api/v3/{product_type_api_name}\
-X GET\
-H "Accept: application/vnd.manageengine.sdp.v3+json"\
-H "Authorization: Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"\
-H "Content-Type: application/x-www-form-urlencoded"\
--data-urlencode input_data='{
"list_info": {
"row_count": 50,
"start_index": 1,
"sort_field": "last_updated_time",
"sort_order": "desc",
"get_total_count": true,
"search_criteria": [
{
"field": "state.name",
"condition": "is",
"value": "In Use"
},
{
"field": "udf_fields.storage_capacity",
"condition": "gte",
"value": "512",
"logical_operator": "AND"
},
{
"field": "warranty_expiry",
"condition": "lt",
"value": "1735689600000",
"logical_operator": "AND"
}
]
}
}'
// Deluge Sample script
url = "<service domain|custom domain>/app/<portal>/api/v3/{product_type_api_name}";
headers = {"Accept":"application/vnd.manageengine.sdp.v3+json",
"Content-Type": "application/x-www-form-urlencoded",
"Authorization": "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"};
input_data = {
"list_info": {
"row_count": 50,
"start_index": 1,
"sort_field": "last_updated_time",
"sort_order": "desc",
"get_total_count": true,
"search_criteria": [
{
"field": "state.name",
"condition": "is",
"value": "In Use"
},
{
"field": "udf_fields.storage_capacity",
"condition": "gte",
"value": "512",
"logical_operator": "AND"
},
{
"field": "warranty_expiry",
"condition": "lt",
"value": "1735689600000",
"logical_operator": "AND"
}
]
}
};
params = {"input_data":input_data};
response = invokeurl
[
url: url
type: GET
parameters:params
headers: headers
];
info response;
#Powershell version - 5.1
$url = "<service domain|custom domain>/app/<portal>/api/v3/{product_type_api_name}"
$headers = @{ "Accept" = "application/vnd.manageengine.sdp.v3+json"
"Authorization" = "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"
"Content-Type" = "application/x-www-form-urlencoded"}
$input_data = @'{
"list_info": {
"row_count": 50,
"start_index": 1,
"sort_field": "last_updated_time",
"sort_order": "desc",
"get_total_count": true,
"search_criteria": [
{
"field": "state.name",
"condition": "is",
"value": "In Use"
},
{
"field": "udf_fields.storage_capacity",
"condition": "gte",
"value": "512",
"logical_operator": "AND"
},
{
"field": "warranty_expiry",
"condition": "lt",
"value": "1735689600000",
"logical_operator": "AND"
}
]
}
}'@
$data = @{ 'input_data' = $input_data}
$response = Invoke-RestMethod -Uri $url -Method get -Body $data -Headers $headers
$response
#Python version - 3.8
#This script requires requests module installed in python.
from urllib.error import HTTPError
from urllib.parse import urlencode
from urllib.request import urlopen,Request
url = "<service domain|custom domain>/app/<portal>/api/v3/{product_type_api_name}"
headers ={"Accept": "application/vnd.manageengine.sdp.v3+json",
"Authorization" : "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx",
"Content-Type" : "application/x-www-form-urlencoded"}
input_data = '''{
"list_info": {
"row_count": 50,
"start_index": 1,
"sort_field": "last_updated_time",
"sort_order": "desc",
"get_total_count": true,
"search_criteria": [
{
"field": "state.name",
"condition": "is",
"value": "In Use"
},
{
"field": "udf_fields.storage_capacity",
"condition": "gte",
"value": "512",
"logical_operator": "AND"
},
{
"field": "warranty_expiry",
"condition": "lt",
"value": "1735689600000",
"logical_operator": "AND"
}
]
}
}'''
url += "?" + urlencode({"input_data":input_data})
httprequest = Request(url, headers=headers)
try:
with urlopen(httprequest) as response:
print(response.read().decode())
except HTTPError as e:
print(e.read().decode())
{
"response_status": [{ "status_code": 2000, "status": "success" }],
"list_info": {
"has_more_rows" : true,
"start_index" : 1,
"row_count" : 50,
"total_count" : 137
},
"custom_asset_laptops": [
{
"id" : "12000000183045",
"name" : "LAP-IND-0921",
"asset_tag" : "LAP-0921",
"product" : { "name": "MacBook Pro 14 M3" },
"state" : { "name": "In Use" },
"user" : { "email_id": "arjun@mail.com" },
"udf_fields" : { "storage_capacity": 1024, "ram_size": 36 }
},
{
"id" : "12000000183071",
"name" : "LAP-IND-0938",
"asset_tag" : "LAP-0938",
"product" : { "name": "Latitude 7440" },
"state" : { "name": "In Use" },
"user" : { "email_id": "kavya@mail.com" },
"udf_fields" : { "storage_capacity": 512, "ram_size": 16 }
}
]
}
Delete Custom Asset
This operation helps to delete custom assets.
Url
<service domain|custom domain>/app/<portal>/api/v3/{product_type_api_name}/{id}
$ curl <service domain|custom domain>/app/<portal>/api/v3/{product_type_api_name}/{id}\
-X DELETE\
-H "Accept: application/vnd.manageengine.sdp.v3+json"\
-H "Authorization: Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"\
-H "Content-Type: application/x-www-form-urlencoded"
// Deluge Sample script
url = "<service domain|custom domain>/app/<portal>/api/v3/{product_type_api_name}/{id}";
headers = {"Accept":"application/vnd.manageengine.sdp.v3+json",
"Content-Type": "application/x-www-form-urlencoded",
"Authorization": "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"};
response = invokeurl
[
url: url
type: DELETE
headers: headers
];
info response;
#Powershell version - 5.1
$url = "<service domain|custom domain>/app/<portal>/api/v3/{product_type_api_name}/{id}"
$headers = @{ "Accept" = "application/vnd.manageengine.sdp.v3+json"
"Authorization" = "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"
"Content-Type" = "application/x-www-form-urlencoded"}
$response = Invoke-RestMethod -Uri $url -Method delete -Headers $headers
$response
#Python version - 3.10
from urllib.error import HTTPError
from urllib.request import urlopen,Request
url = "<service domain|custom domain>/app/<portal>/api/v3/{product_type_api_name}/{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"
}
}