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 returned when authentication credentials are missing, expired, or invalid (authentication=required)
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.