# Remove group members

`POST /group.remove`

## Description

Remove one or more group members.

Apps may remove members from a group if one of the following conditions is true:
1. It is a public group in their Roam.
2. They are a member of the group.

Removing members with the Admin role is not yet supported.

**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 |
|----------|------|----------|-------------|
| `group` | TaggedUUID | Yes |  |
| `members` | TaggedUUID[] | Yes | List of member IDs |

**TaggedUUID**:

A UUID prefixed by a tag identifying the specific type of object
**TaggedUUID** (array item):

*See TaggedUUID above*

### Example Request

```json
{
  "group": "G-88bebce7-6cbb-4666-96f9-5c02d73e6661",
  "members": [
    "U-709b8a57-70bc-427a-b6f0-b16ba5297f8c"
  ]
}
```

## Responses

### 204 - Members removed successfully

### 400 - Invalid request, e.g. group does not exist or incorrect user IDs.

### 401 - Unauthorized.

### 403 - App does not have permission to remove members from this group.

### 500 - An internal error occured.

---

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