---
title: "Service: /members/{member}/projects/{group}/rename [POST]"
source: https://dev.pageseeder.com/api/services/rename-project-POST.html
description: "This service launches an asynchronous rename process for a project, updating its name, template, visibility, folder paths, URIs, and all subproject properties. Requires administrator permission."
last_updated: 2026-09-02T11:36:14+10:00
document_type: api_endpoint
operation_id: group-POST
resource_id: group
path_template: /members/{member}/projects/{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: ~385
---

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

## Description

Launch a rename thread for the project.

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

The thread does the following

1. Update the project name, [project template](../../reference/glossary/project_template.md) and visibility (control group) if not `public`.
2. Rename the project default folder path in the file system.
3. Update all URIs and group folders which start with the project default folder path.
4. Update the name, *project template* and visibility (control group) if not `public`, of all subprojects/groups. Also, rename the project’s folder under template and woconfig.

## Parameters

| Name | Description | Required | Type | Default value |
| --- | --- | --- | --- | --- |
| name | The new name of the group | yes | string |  |
| index | Whether to re-index all the groups under this project 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 | Config folder already exists (for template or web folder) |
| 0x110F | Cannot change a group to a project or a project to a group |