# Remove group members

`POST /group.remove`

## Description

Remove one or more group members.

Members can be specified by user ID or email address.

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.

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

---

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

## Authentication

```
Authorization: Bearer YOUR_API_KEY
```

## Request Body

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `id` | string | Yes | Group ID |
| `members` | string[] | Yes | List of member IDs or email addresses to remove |

## 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 occurred.

---

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