Remove Members
/v1/admin/groups/{group_id}/membersRemove SEVERAL users from a group in one request — the bulk sibling of the
single-member remove, and the mirror of POST /{group_id}/members.
The whole removal runs in one transaction with a single set-based access revocation pass, so a large removal stays a handful of writes and lands as one audited operator action rather than many.
Severance semantics are identical to the single-member route: scoped to what these memberships conferred, so a member who keeps access through another live group keeps those credentials.
Idempotent on the membership rows: ids that are not members are simply not deleted, and the response is still 204. A partial set is NOT an error, so the call is safe to replay — the caller's intent ("these users should not be in this group") is satisfied either way.
Authorization
HTTPBearer In: header
Path Parameters
uuidRequest Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Bulk membership removal — the mirror of GroupMembersAdd.
Same 200 cap and the same explicit-id shape: removal is never expressed as a replace-set, because a client holding a stale page would then silently delete everyone it had not loaded. The caller always names exactly who it means to remove.
Response Body
application/json
curl -X DELETE "https://example.com/v1/admin/groups/497f6eca-6276-4993-bfeb-53cbbbba6f08/members" \ -H "Content-Type: application/json" \ -d '{ "auth_user_ids": [ "3b37fc75-3c6a-4086-873a-48f6618fb61a" ] }'{ "detail": [ { "loc": [ "string" ], "msg": "string", "type": "string", "input": null, "ctx": {} } ]}