# Updates a static custom group's name, description, or member resources

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](https://www.manageengine.com/products/desktop-central/help/api/cloud/custom-groups-get-available-resources.html) to discover valid resource IDs for the replacement member list.

## Endpoint

`POST /api/1.4/customgroup/updateCg`

## Request URL

`https://`[*{serverurl}*](https://www.manageengine.com/products/desktop-central/help/api/cloud/oauth-authentication-endpoint-domain.html)`/api/1.4/customgroup/updateCg`

## Scope

`DesktopCentralCloud.Common.UPDATE`

## Header

`Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52`

## Request Parameters

### Request Headers

- **Content-Type** `string` — **Mandatory** — `application/json`
  - Must be `application/json`. Request body must be valid JSON.
- **Accept** `string` — **Mandatory** — `application/json`
  - Must be `application/json`. Only JSON responses are supported.

### Request Body

`application/json`

- `JSON Object`
  - **groupId** `long` — **Mandatory**
    - Resource ID of the group to update. Fetch from [Retrieve All Custom Groups](https://www.manageengine.com/products/desktop-central/help/api/cloud/custom-groups-get-cglist.html).
  - **groupName** `string` — Optional
    - Updated group name. Max 100 chars. Must be unique.
  - **description** `string` — Optional
    - Updated description. Max 250 chars.
  - **resourceIds** `array` — **Mandatory**
    - Complete replacement member list. Pass the entire desired member set on every update — partial omission is not supported. Fetch IDs from [Get Available Resources](https://www.manageengine.com/products/desktop-central/help/api/cloud/custom-groups-get-available-resources.html).

## Sample Request

```curl
curl --request POST \
  --url https://appdomains/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]}'
```

## Sample Request Body

Replace the entire member list and update description.

```json
{
  "groupName": "Windows Servers",
  "groupId": 301,
  "description": "Updated - Production and Staging Windows Servers",
  "resourceIds": [
    101,
    102,
    103,
    104,
    105
  ]
}
```

## Response Parameters

### HTTP Code 200

Response Body — `application/json`

- `JSON Object`
  - **message_type** `string`
    - Always `'updateCg'` for this endpoint.
  - **message_response** `JSON Object`
    - Response payload container.
  - **message_version** `string`
    - API version: `'1.4'`.
  - **status** `string`
    - `'success'` when the request completed without errors.

### HTTP Code 404

Response Body — `application/json`

- `JSON Object`
  - **message_type** `string`
    - Always `'updateCg'` for this endpoint.
  - **message_version** `string`
    - API version: `'1.4'`.
  - **status** `string`
    - Always `'error'` for error responses.
  - **error_code** `string`
    - `'70506'` (`CG_INVALID_DETAILS_TO_UPDATE`).
  - **error_description** `string`
    - 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.

### HTTP Code 412

Response Body — `application/json`

- `JSON Object`
  - **message_type** `string`
    - Always `'updateCg'` for this endpoint.
  - **message_version** `string`
    - API version: `'1.4'`.
  - **status** `string`
    - Always `'error'` for error responses.
  - **error_code** `string`
    - `'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`).
  - **error_description** `string`
    - 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).

### HTTP Code 500

Response Body — `application/json`

- `JSON Object`
  - **message_type** `string`
    - Always `'updateCg'` for this endpoint.
  - **message_version** `string`
    - API version: `'1.4'`.
  - **status** `string`
    - Always `'error'` for error responses.
  - **error_code** `string`
    - Internal error code: `'1003'` (`INTERNAL_ERROR`).
  - **error_description** `string`
    - Resolved I18N message, typically: An internal error occurred while processing the request.

## Possible Response Codes

- `200` — HTTP code
- `404` — HTTP code
- `412` — HTTP code
- `500` — HTTP code

## Sample Response: HTTP 200

Group details and membership updated.

```json
{
  "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.

```json
{
  "message_type": "updateCg",
  "message_response": {
    "updatecg": {
      "groupName": "Windows Servers",
      "invalidResourceIds": [
        999,
        998
      ],
      "cgResourceId": "301"
    }
  },
  "message_version": "1.4",
  "status": "success"
}
```

## Sample Response: HTTP 404

Group ID does not exist or user lacks access.

```json
{
  "error_description": "No such Custom Group found.",
  "message_type": "updateCg",
  "error_code": "70506",
  "message_version": "1.4",
  "status": "error"
}
```

## Sample Response: HTTP 412

Required field is missing — `groupId`, or `resourceIds` for a static update.

```json
{
  "error_description": "Required parameters are missing to create/update Custom Group.",
  "message_type": "updateCg",
  "error_code": "70501",
  "message_version": "1.4",
  "status": "error"
}
```

## Sample Response: HTTP 500

Unexpected server-side failure during update.

```json
{
  "error_description": "An internal error occurred while processing the request.",
  "message_type": "updateCg",
  "error_code": "1003",
  "message_version": "1.4",
  "status": "error"
}
```

## Rate Limit

![](https://www.zohowebstatic.com/sites/zweb/images/people/ico-help.png)

**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.