Moves one or more sensors to trash. To get sensor IDs use Get Sensor Libraries
post /intelligence/sensors/api/moveToTrash
https://{serverurl}/intelligence/sensors/api/moveToTrash
Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
Array of sensor IDs (long) to move to trash. Max 200 items
true to force-trash sensors even if dependencies exist; false to block on dependencies
curl --request POST \
--url https://appdomains/intelligence/sensors/api/moveToTrash \
--header 'Accept: application/json' \
--header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52' \
--header 'Content-Type: application/json' \
--data '{}'Move multiple sensors to trash
{
"forceDelete": false,
"sensorIDs": [
101,
102,
103
]
}
Force-trash a sensor ignoring dependencies
{
"forceDelete": true,
"sensorIDs": [
101
]
}
Result of the operation: 'success' or 'failure'
A confirmation message about the trash operation
Error code when sensor cannot be deleted due to dependencies
Details about which dependencies prevent deletion
Unauthorized error code: credentials missing, expired, or invalid
Authentication failure reason
HTTP status code (500)
Internal error code identifying the server-side failure
Error message describing the server-side failure
Single sensor moved to trash
{
"message": "Sensor Disk Health Sensor moved to trash successfully",
"status": "success"
}
Multiple sensors moved to trash
{
"message": "Selected sensors moved to trash successfully",
"status": "success"
}
Sensor is used by other features and cannot be deleted
{
"errorMessage": "Sensor has dependencies in other modules and cannot be trashed.",
"errorCode": "SENORS_DEPENDENCY_EXISTS"
}
You do not have permission for this action
{
"errorMessage": "Sensor is not in the authorized user scope.",
"errorCode": "UNAUTHORIZED"
}
Server error
{
"errorMessage": "An internal error occurred.",
"errorCode": "INTERNAL_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.