Updates a static custom group (groupCategory=1). Requires groupId and resourceIds. 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 replaces the entire member list — pass the full desired member set on every update; partial omission is not supported. 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 group to update. Fetch from Retrieve All Custom Groups.
Updated group name. Max 100 chars. Must be unique.
Updated description. Max 250 chars.
Complete replacement member list. Pass the entire desired member set on every update — partial omission is not supported. 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":301,"resourceIds":[101,102,103,104,105]}'Replace the entire member list and update description.
{
"groupName": "Windows Servers",
"groupId": 301,
"description": "Updated - Production and Staging Windows Servers",
"resourceIds": [
101,
102,
103,
104,
105
]
}
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.
Group details and membership updated.
{
"message_type": "updateCg",
"message_response": {
"updatecg": {
"groupName": "Windows Servers",
"cgResourceId": "301"
}
},
"message_version": "1.4",
"status": "success"
}
Static group updated but some submitted resource IDs were not found.
{
"message_type": "updateCg",
"message_response": {
"updatecg": {
"groupName": "Windows Servers",
"invalidResourceIds": [
999,
998
],
"cgResourceId": "301"
}
},
"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 is missing — groupId, or resourceIds for a static update.
{
"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.