---
title: "Remove users from a group"
method: POST
path: "/api/1/groups/{groupId}/remove-users"
tags: ["Groups (Preferred)"]
---

# Remove users from a group

`POST /api/1/groups/{groupId}/remove-users`

Removes one or more users from the specified group. Pass a single-element array to remove one user.

Users not currently in the group are silently ignored (the operation is idempotent).
An empty `user_ids` array is accepted and is a no-op.

Requires the **GROUPMANAGEMENT** security role.

## Path parameters

- `groupId` string, uuid, required

## Request body

- GroupMembersInput
  - `user_ids` string[], required — IDs of the users to add or remove. An empty list is a no-op.

## Response `200`

Users removed successfully.

- GroupMembersResult
  - `user_count` integer — Updated number of members in the group after the operation.

## Other responses

- `400` — One or more user IDs do not exist in the account.
- `401` — Missing or invalid authentication. The response body is empty.
- `403` — The authenticated user does not have the **GROUPMANAGEMENT** security role.
- `404` — Group not found.
- `422` — Validation error (e.g. missing `user_ids` field or malformed UUID).

---

[API](https://skmtc.net/bynder/apis/oauth-2-0.md) · [All operations](https://skmtc.net/bynder/apis/oauth-2-0/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bynder/oauth-2-0/versions/bb9efc864ce1/schema)