# Change a Group

Rename a group or change its description. Its id — what your rules name — stays.

## Overview

- Send `name`, `description` or both; `"description": null` clears it. A body that names neither answers `400` `GROUP_REQUEST_INVALID`.
- `200` with the group. A name another group of yours has answers `409` `GROUP_NAME_TAKEN`; a group that is not yours, `404` `GROUP_NOT_FOUND`.
- For `owner`, `tenantadmin`, `non_signing_admin` and `security_admin`.

## Endpoint

### `PATCH /v1/groups/{groupId}`

Authentication: bearer token required.

Changes a group's name or description.

**Path parameters**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `groupId` | string (uuid) | yes | The group's id |

**Request body**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `name` | string | no | 1–100 characters, trimmed; unique in your tenant whatever its case |
| `description` | string \| null | no | Up to 500 characters; `null` clears it |

**Responses**

`200` OK

```json
{
  "id": "3b8e1f6a-2c4d-4e9f-a1b7-6d5c4e3f2a10",
  "name": "Finance approvers (EU)",
  "description": "Approve transfers above 10,000 EUR",
  "memberCount": 2,
  "createdBy": "5d2c1b0a-9e8f-4a7b-8c6d-5e4f3a2b1c0d",
  "createdAt": "2026-10-08T09:12:40.118Z",
  "updatedAt": "2026-10-08T10:02:17.905Z"
}
```

`400` Nothing to change

```json
{
  "statusCode": 400,
  "error": "BadRequestError",
  "message": "Invalid request",
  "details": { "code": "GROUP_REQUEST_INVALID", "errors": ["(body): Change the name or the description"] }
}
```

---

Web version: https://docs.aureahub.com/#group-update