Updates a static unique custom group (groupCategory=5). Requires groupId and resourceIds. Only computer-type static unique groups exist (user-type static unique is not supported). Members must remain exclusive — resources already in another static unique group will be reported in invalidResourceIds. Important: Do not include groupType or groupCategory in the request body — these are immutable after creation and will be rejected. The resourceIds field is required and is a complete replacement of the member list — pass the full desired member set on every update. Prerequisites: Call Get Available Resources to discover valid resource IDs for the replacement member list.
post /api/1.4/customgroup/updateCg
https://{serverurl}/api/1.4/customgroup/updateCg
DesktopCentralCloud.Common.UPDATECopied!
Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
Must be application/json. Request body must be valid JSON.
Must be application/json. Only JSON responses are supported.
Resource ID of the static unique group to update. Fetch from Retrieve All Custom Groups.
Updated group name. Max 100 chars.
Updated description. Max 250 chars.
Complete replacement member list. Members must be exclusive to this group — each resource can belong to only ONE static unique group of the same type. Fetch IDs from Get Available Resources.
curl --request POST \
--url https://appdomain/api/1.4/customgroup/updateCg \
--header 'Accept: application/json' \
--header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52' \
--header 'Content-Type: application/json' \
--data '{"groupId":310,"resourceIds":[101,102,103]}'Update a static unique group's exclusive member list.
{
"groupName": "Privileged Servers",
"groupId": 310,
"description": "Updated - High-security servers with restricted technician access",
"resourceIds": [
101,
102,
103
]
}
Always 'updateCg' for this endpoint.
Response payload container.
Response payload.
Resource ID of the updated group (returned as string). Use as cgId in Delete CG, or as groupId in a subsequent Update Static CG / Update Static Unique CG call.
Current name after update.
[Conditional] Array of resource IDs that were not found or not valid. Present only when some submitted resourceIds are invalid.
API version: '1.4'.
'success' when the request completed without errors.
Always 'updateCg' 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.' -- group does not exist, user is out of scope, or group is invalid for current product edition.
Always 'updateCg' for this endpoint.
API version: '1.4'.
Always 'error' for error responses.
'70501' (CG_CREATE_UPDATE_PARAMS_MISSING), '70502' (CG_DUPLICATE_NAME), '70509' (CG_DUMMY_CG_RENAME), '70503' (CG_NULL_CRITERIA_PATTERN), '70517' (CG_INVALID_CRITERIA_PATTERN), '70508' (CG_MORE_COMPUTERS_DUMMY_CG), '70513' (CG_INVALID_CREATION_MODE).
Resolved I18N message varies by error code: 'Required parameters are missing to create/update Custom Group.' (70501), 'Custom group name is already in use.' (70502), 'All Features Group cannot be renamed.' (70509), 'Criteria pattern is empty.' (70503), 'Invalid criteria pattern.' (70517), 'Computer limit exceeded for free edition.' (70508), 'Only manually created Custom Group is allowed to be accessed using external apis.' (70513).
Always 'updateCg' 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.
Static unique group members and details updated.
{
"message_type": "updateCg",
"message_response": {
"updatecg": {
"groupName": "Privileged Servers",
"cgResourceId": "310"
}
},
"message_version": "1.4",
"status": "success"
}
Static unique group updated but some exclusive member resource IDs were not found.
{
"message_type": "updateCg",
"message_response": {
"updatecg": {
"groupName": "Privileged Servers",
"invalidResourceIds": [
999,
998
],
"cgResourceId": "310"
}
},
"message_version": "1.4",
"status": "success"
}
Group ID does not exist or user lacks access.
{
"error_description": "No such Custom Group found.",
"message_type": "updateCg",
"error_code": "70506",
"message_version": "1.4",
"status": "error"
}
Required field groupId is missing.
{
"error_description": "Required parameters are missing to create/update Custom Group.",
"message_type": "updateCg",
"error_code": "70501",
"message_version": "1.4",
"status": "error"
}
Unexpected server-side failure during update.
{
"error_description": "An internal error occurred while processing the request.",
"message_type": "updateCg",
"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.