Permanently deletes the specified custom group identified by cgId. This action is irreversible. Fetch the cgId from Retrieve All Custom Groups. Requires admin or customer-admin privileges, or ownership of the group. System-generated groups (e.g., All Computers, All Users) cannot be deleted. Returns a success message with the deleted group name.
post /api/1.4/customgroup/deleteCg
https://{serverurl}/api/1.4/customgroup/deleteCg
DesktopCentralCloud.Common.UPDATECopied!
Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
Must be application/json. Only JSON responses are supported.
Resource ID of the custom group to delete. Fetch from Retrieve All Custom Groups
curl --request POST \
--url 'https://appdomain/api/1.4/customgroup/deleteCg?cgId=SOME_INTEGER_VALUE' \
--header 'Accept: application/json' \
--header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52'Always 'deleteCg' for this endpoint.
Response payload container.
Response payload.
Localized message: '{groupName} was successfully deleted!'.
API version: '1.4'.
'success' when the request completed without errors.
Always 'deleteCg' for this endpoint.
API version: '1.4'.
Always 'error' for error responses.
'70506' (CG_INVALID_DETAILS_TO_UPDATE).
Resolved I18N message: 'No such Custom Group found.'.
Always 'deleteCg' for this endpoint.
API version: '1.4'.
Always 'error' for error responses.
Internal error code: '1003' (INTERNAL_ERROR).
Resolved I18N message, typically: An internal error occurred while processing the request.
Group and all its membership associations removed.
{
"message_type": "deleteCg",
"message_response": {
"deletecg": {
"message": "Windows Servers was successfully deleted!"
}
},
"message_version": "1.4",
"status": "success"
}
Group ID does not exist or user lacks admin/owner privileges.
{
"error_description": "No such Custom Group found.",
"message_type": "deleteCg",
"error_code": "70506",
"message_version": "1.4",
"status": "error"
}
Unexpected server-side failure during deletion.
{
"error_description": "An internal error occurred while processing the request.",
"message_type": "deleteCg",
"error_code": "1003",
"message_version": "1.4",
"status": "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.