---
title: "Service: /members/{member}/groups/{group}/rename [POST]"
source: https://dev.pageseeder.com/api/services/rename-group-POST.html
description: "POST service that asynchronously renames a group, updating its name, project template, visibility, folder paths, and related URIs. Requires administrator permission and optional re-indexing."
last_updated: 2026-09-02T11:36:12+10:00
document_type: api_endpoint
operation_id: group-POST
resource_id: group
path_template: /members/{member}/groups/{group}/rename
http_method: POST
api_category: group
implementation_version: 6.2004
api_since: 5.5004
deprecated_since: null
obsolete_since: null
api_support: supported
cache_control: N/A
generated_at: 2026-09-02
tokens: ~332
---

# /members/\{member\}/groups/\{group\}/rename \[POST\]

## Description

Launch a rename thread for the [group](../../reference/glossary/group.md).

Invoking this service starts an [Asynchronous process](../usage/asynchronous_process.md).

The thread does the following

1. Update the group name, [project template](../../reference/glossary/project_template.md) and visibility (control group) if not 'public'.
2. Rename the group default folder path in the file system.
3. Update all URIs and group folders which start with the group default folder path.

## Parameters

| Name | Description | Required | Type | Default |
| --- | --- | --- | --- | --- |
| name | The new name of the group | yes | string |  |
| index | Whether to re-index the group after renaming | no | boolean | `true` |

## Permission

This service requires administrator.

## Response

This service returns the following XML:

```xml

<group-renaming>
  <thread ...> ... </thread>
</group-renaming>
```

## Error Handling

| Code | Cause / Description |
| --- | --- |
| 0x1101 | Illegal character in group name |
| 0x1103 | Group name in use |
| 0x1102 | Documents folder already exists |
| 0x1106 | Parent project missing or is a group |
| 0x1110 | Template folder already exists |
| 0x110F | Cannot change a group to a project or a project to a group |