---
title: "Remove group members"
method: POST
path: "/api/workspace/groups/{group_id}/members/remove"
---

# Remove group members

`POST /api/workspace/groups/{group_id}/members/remove`

## Request

- Base URL: `https://app.base44.com`
- URL: `https://app.base44.com/api/workspace/groups/{group_id}/members/remove`
- Auth: HTTP bearer

<Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>

Removes members from a custom group, up to 200 per request.

Each affected member's role is worked out again from their other groups. A member left in no group becomes a viewer, or gets the workspace's SSO default role when SSO is set up.

Removing someone who isn't in the group changes nothing, so retrying is safe. A group whose `source` is `idp` gets its name and members from your identity provider, so they can't be changed here. You can't make a change that removes your own admin access. Removing members works on any plan, so you can take groups apart after a downgrade.

This is limited to 60 requests per minute, shared with the other endpoints that change groups or their members. A signed-in session has its own limit, and every personal access token for the workspace shares one. Some workspaces have a different limit.

<Note>Call this as an owner or admin of the workspace, with a personal access token for that workspace sent as a Bearer token, or from a signed-in session. A read-only token is refused, and workspace API keys aren't accepted.</Note>

## Path parameters

- `group_id` string, required: ID of the group to remove members from. Get it from `id` in [List workspace groups](/api-reference/list-workspace-groups).

## Query parameters

- `workspaceId` string, required: ID of the workspace. With a personal access token, use the token's workspace. Get it from `organization_id` in [Get app](/api-reference/get-app).

## Request body

- GroupMembersModifyRequest
  - `emails` string[], required: Emails of the members, 1 to 200.

## Response `200`

The members are no longer in the group.

- ChangeResult: Confirms the change.
  - `status` 'success', required: Always `success`.
  - `message` string, required: Short confirmation. Its wording can change, so don't parse it.

## Other responses

- `400`: The group's members come from your identity provider, or the change would remove your own admin access.
- `401`: Missing or invalid credentials.
- `403`: You aren't an owner or admin of the workspace, your token is for a different workspace or is read-only, or your credential can't be used on this endpoint.
- `404`: Group not found in this workspace.
- `409`: Your workspace requires an unlocked SSO session.
- `422`: Validation Error
- `429`: Rate limit exceeded.

## Changes

> 58 revisions in range; 1 not diffed.

- **2026-10-12** `5e139db2e643`: 1 info
  - the endpoint scheme security `PersonalAccessTokenAuth` was added to the API
- **2026-10-06** `9a0e9d0827a1`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/adexad/apis/base44-app-management-api/changes/api/workspace/groups/:group_id/members/remove/post.md)

---

[API](https://skmtc.dev/adexad/apis/base44-app-management-api.md) · [All operations](https://skmtc.dev/adexad/apis/base44-app-management-api/llms.txt) · [OpenAPI document](https://skmtc.dev/adexad/apis/base44-app-management-api/revisions/fa29e915c226?raw)