---
title: "Remove users from a group"
method: DELETE
path: "/groups/{groupId}/users"
tags: ["groups"]
---

# Remove users from a group

`DELETE /groups/{groupId}/users`

Removes one or more users from a call group. The request body is an array of user IDs to remove. Once removed, these users will no longer receive calls routed to this group. If a user ID is not a member of the group, it is silently ignored.

**Permission:** `Users Write` required.

**Monitoring:** **Required.** Group membership management is a supervisory operation. Returns `401 Unauthorized` if Monitoring is OFF on your API key.

## Path parameters

- `groupId` integer, required

## Request body

- integer[]

## Response `200`

Successful operation

## Other responses

- `400` — The provided group ID or request body is invalid
- `401` — Authentication token is missing, invalid, expired, Users Write permission is missing, or monitoring is not enabled
- `404` — No group found with the specified ID
- `500` — Internal server error

---

[API](https://skmtc.net/ringover/apis/ringover-public-api.md) · [All operations](https://skmtc.net/ringover/apis/ringover-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ringover/ringover-public-api/revisions/9da73dd2f99e/schema)