Processes a web category override request by approving or blocking a website. Updates the customized category list and pushes changes to managed devices.
post /bsp/api/v1/bmp/webcategories/override
https://{serverurl}/bsp/api/v1/bmp/webcategories/override
Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
Override request with approve/deny action and optional re-categorization
Request body for category override
Override request ID. Required.
1 = approve (allow), 0 = deny (block). Required.
Category ID to re-assign. 1-News, 2-Technology, 3-Entertainment, 4-Education, 5-Personal and Hobbies, 6-Health and Medicine, 7-Shopping, 8-Business, 9-Social Media, 10-Sports, 11-Finance, 12-Streaming, 13-Blogs, 14-Government and Legal, 15-Gambling, 16-Adult, 17-Pornography, 18-Hacking and Illicit Activities, 19-Job Search and Career Development, 20-Others. Use -1 for no re-assignment. Optional.
curl --request POST \
--url https://appdomains/bsp/api/v1/bmp/webcategories/override \
--header 'Accept: application/json' \
--header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52' \
--header 'Content-Type: application/json' \
--data '{}'Deny and block website
{
"is_approved": 0,
"suggested_category": -1,
"request_id": 107
}
Approve, allow and re-categorize to Personal and Hobbies (id=5)
{
"is_approved": 1,
"suggested_category": 5,
"request_id": 108
}
Unauthorized error code: credentials missing, expired, or invalid
Authentication failure reason
Error code indicating insufficient permissions
Message indicating insufficient privileges to access this resource
Rate limit error code returned when the API call reached threshold
Rate limit exceeded message with retry guidance
Server error for Update Category Override
204 No ContentUnauthorized
{
"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.