Splits and parses a device instance path for UI/workflow usage.
post /dcapi/device/splitinstancepath
https://{serverurl}/dcapi/device/splitinstancepath
Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
Parent device instance path
Full device instance path to split
Device type identifier. Fetch from Get Supported Devices
curl --request POST \
--url https://appdomains/dcapi/device/splitinstancepath \
--header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52' \
--header 'Content-Type: application/json' \
--data '{}'Split a device instance path
{
"deviceTypeId": 1,
"deviceInstancePath": "USB\\VID_0781&PID_55AB\\04015160",
"parentInstancePath": "USB\\VID_0781&PID_55AB"
}
Parsed vendor hexadecimal identifier
Parsed product hexadecimal identifier
Parsed serial number. Falls back to parentInstancePath if serial number cannot be extracted
Error code identifying the type of error
Human-readable error message
Error code identifying the type of error
Human-readable error message
Split instance path response
{
"productHexID": "55AB",
"vendorHexID": "0781",
"serialNo": "04015160"
}
Bad request - missing parentInstancePath
{
"errorCode": "INCORRECT_REQUEST_DATA",
"errorMsg": "parentInstancePath can't not be empty"
}
Internal server error
{
"errorCode": "INTERNAL_ERROR",
"errorMsg": "Internal Server Error!"
}
![]()
Duration: 1 minute | Threshold: 30 | Lock period: 5 minutes
Duration - Time window for the threshold.
Threshold - Number of API calls allowed within the specified duration.
Lock Period - Wait time before consecutive API requests.
© 2026, Zoho Corporation Pvt. Ltd. All Rights Reserved.