# Rename a group

`POST /group.rename`

## Description

Rename a group by ID.

Apps may only rename groups for which they are an admin.

**Access:** Organization only.

**Required scope:** `group:write`

---

**OpenAPI Spec:** [chat.json](https://developer.ro.am/chat.json)

## Authentication

```
Authorization: Bearer YOUR_API_KEY
```

## Request Body

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `id` | TaggedUUID | Yes |  |
| `name` | string | Yes |  |

**TaggedUUID**:

A UUID prefixed by a tag identifying the specific type of object
### Example Request

```json
{
  "id": "G-88bebce7-6cbb-4666-96f9-5c02d73e6661",
  "name": "Product Engineering"
}
```

## Responses

### 204 - Group renamed successfully

### 400 - Bad request.

### 401 - Presented invalid authentication credentials.

### 403 - App does not have admin access to this group.

### 404 - Group not found.

### 500 - An internal error occured.

---

*Machine-readable API documentation.*
*Full documentation: https://developer.ro.am/docs/chat-api/group-rename*