---
title: "Remove group member"
method: DELETE
path: "/groups/{groupId}/members/{userId}"
tags: ["Groups"]
---

# Remove group member

`DELETE /groups/{groupId}/members/{userId}`

## Request

- Base URL: `https://demodesk.com/api/v2`
- URL: `https://demodesk.com/api/v2/groups/{groupId}/members/{userId}`
- Auth: HTTP bearer

Removes a user from a restricted group of the company.

The operation is idempotent. It returns `204` whether or not the user was a member.

Shared groups contain every user of the company, so their membership cannot be changed and the
request returns `400` with the code `group_not_restricted`.

Changing the membership has the same effects as in Settings > Groups, including updating the group
visibility of the user's scheduled meetings and removing the user from the group's meeting types.

Changing a group requires the permission to edit it in the web app: a company admin, or a manager who
is a member of the group. A group that is readable but not editable returns `403`. A group that is
unknown, personal, or not readable returns `404` with the code `group_not_found`. A user that is
unknown or in another company returns `404` with the code `user_not_found`. Blocked users can still be
removed, so offboarding scripts can clean up their memberships.

Rate limits:
- Global: 120 requests per minute per API key.

## Path parameters

- `groupId` string, required
- `userId` string, required

## Response `204`

The user is not a member of the group, whether they were removed now or never were one.

## Other responses

- `400`: Request validation failed.
- `401`: API key is missing or invalid.
- `403`: The authenticated user is not allowed to access this resource, e.g. it is not assigned to a company.
- `404`: Resource was not found.
- `429`: Rate limit exceeded.

## Changes

- **2026-10-18** `14d6c8e2e11a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/demodesk/apis/demodesk-public-api/changes/groups/:groupId/members/:userId/delete.md)

---

[API](https://skmtc.dev/demodesk/apis/demodesk-public-api.md) - [All operations](https://skmtc.dev/demodesk/apis/demodesk-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/demodesk/apis/demodesk-public-api/revisions/8729e4025dc9?raw)