Triggers an on-demand inventory scan on the specified devices.
post /bsp/api/v1/bmp/devices/scan
https://{server-hostname}:8383/bsp/api/v1/bmp/devices/scan
BrowserManager.CREATECopied!
Authorization: d92d4xxxxxxxxxxxxx15f52
Request body for triggering an immediate inventory scan on specified devices
Device resource ID from List Devices response (device_id field)
curl --request POST \
--url https://appdomain/bsp/api/v1/bmp/devices/scan \
--header 'Accept: application/json' \
--header 'Authorization: d92d4xxxxxxxxxxxxx15f52' \
--header 'Content-Type: application/json' \
--data '{"device_ids":[999,888]}'Scan two devices
{
"device_ids": [
999,
888
]
}
Scan single device
{
"device_ids": [
777
]
}
Bad request error when device_ids array size exceeds 1-100 range
Error code indicating the device_ids array size is outside the allowed 1-100 range
Message indicating the array size constraint violation
Request URL that triggered the error
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
Not found error when one or more device IDs do not exist
Message indicating the device ID was not found
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.Array size exceeded
{
"errorCode": "COM0014",
"url": "/bsp/api/v1/bmp/devices/scan",
"errorMsg": "ARRAY_SIZE_OUT_OF_RANGE"
}
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"
}
Device not found
{
"errormsg": "Device ID not found"
}
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.