Sends a command to the specified devices to trigger an inventory scan or retry a failed policy deployment.
post /bsp/api/v1/bmp/devices/notify
https://{server-hostname}:8383/bsp/api/v1/bmp/devices/notify
BrowserManager.CREATECopied!
Authorization: d92d4xxxxxxxxxxxxx15f52
Request body for sending notification commands to devices
Device resource ID from List Devices response (device_id field)
Notification command: scan or retryPolicyDeployment
curl --request POST \
--url https://appdomain/bsp/api/v1/bmp/devices/notify \
--header 'Accept: application/json' \
--header 'Authorization: d92d4xxxxxxxxxxxxx15f52' \
--header 'Content-Type: application/json' \
--data '{"resource_ids":[100,101],"command":"scan"}'Scan notification
{
"resource_ids": [
100,
101
],
"command": "scan"
}
Retry deployment
{
"resource_ids": [
104
],
"command": "retryPolicyDeployment"
}
Unauthorized error code returned when authentication credentials are missing, expired, or invalid (authentication=required)
Authentication failure reason
Forbidden error code returned when the authenticated user does not have the required uem-roles (e.g., DataEncryption_Admin or DataEncryptionRecoveryKey_Admin)
Message indicating insufficient privileges to access this resource
Rate limit error code returned when the API call threshold (configured via threshold/duration in security XML) is exceeded; client is locked out for lock-period minutes
Rate limit exceeded message with retry guidance
Internal server error during device operations
Message describing the server-side failure
Internal server error code
Returns 204 No Content on success. .
204 Returns 204 No Content on success. .Unauthorized
{
"errorCode": "UNAUTHORIZED",
"errorMsg": "You are not authorized to perform this action"
}
Forbidden
{
"errorCode": "FORBIDDEN",
"errorMsg": "You do not have permission to access this resource"
}
Rate limit exceeded
{
"errorCode": "RATE_LIMIT_EXCEEDED",
"errorMsg": "You have exceeded the maximum number of API calls. Please try again later."
}
Server error
{
"error_description": "Internal Server error, Please try again in a moment.",
"error_code": "COM0004"
}
![]()
Duration: 1 minute | Threshold: 60 | 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.
© 2026, Zoho Corporation Pvt. Ltd. All Rights Reserved.