---
title: "Service: /groups/{group}/subgroups/{subgroup} [PATCH]"
source: https://dev.pageseeder.com/api/services/edit-subgroup_patch.html
description: "PATCH endpoint to edit an existing subgroup's properties including role, notification settings, and member listing visibility. Requires manager permissions. Returns modified subgroup details."
last_updated: 2026-09-08T13:39:44+10:00
document_type: api_endpoint
operation_id: group-PATCH
resource_id: group
path_template: /groups/{group}/subgroups/{subgroup}
http_method: PATCH
api_category: group
implementation_version: 6.2004
api_since: 5.4903
deprecated_since: null
obsolete_since: null
api_support: supported
cache_control: N/A
generated_at: 2026-09-02
tokens: ~557
---

# /groups/\{group\}/subgroups/\{subgroup\} \[PATCH\]

## Description

Edit an existing [subgroup](../../reference/glossary/subgroup.md).

## Parameters

| Name | Description | Required | Type | Default |
| --- | --- | --- | --- | --- |
| listed | Whether the member’s email address is listed in the group | no | enum | `inherit` |
| notification | The member’s notification option in the group | no | enum | `inherit` |
| role | The member¹s role in the group  | no | enum | `inherit` |

### `notification`

The notification parameter must be one of `immediate`, `essential`, `daily`, `weekly`, `none`, or `inherit`.

If not specified, the value `inherit` is used, meaning that the members inherit the notification settings from the subgroup. 

### `role`

The role parameter must be one of `guest`, `reviewer`, `contributor`, `manager`, `approver` or `inherit`.

If not specified, the value `inherit` is used, meaning that the members inherit the role from the subgroup. 

### `listed`

The listed boolean parameter can be used to override the group’s default setting. It affects whether other group members are able to see the subgroup’s members’ user details.

The supported values are `true`, `false` and `inherit`, the default value is `inherit`, meaning that the members inherit the value from the subgroup.

## Permission

This service requires manager or higher.

## Response

The XML response returns the modified [\<subgroup\>](../elements/element_subgroup.md) element wrapping the `<group>` element acting as the subgroup.

```xml

<subgroup-modification>
  <subgroup id="[id]"
            role="[approver|
                   manager|
                   contributor|
                   reviewer|
                   guest|
                   inherit]"
            notification="[immediate|
                           daily|
                           none|
                           inherit]"
            listed="[true|false|inherit]">
    <group id="[group id]" name="[group name]" .../>
  </subgroup>
</subgroup-modification>
```

## Error Handling

| Code | Cause / Description |
| --- | --- |
| 0x110B | Invalid subgroup parameter |
| 0x1109 | Invalid notification parameter |
| 0x110A | Invalid role parameter |