---
title: "Remove user from group"
method: DELETE
path: "/groups/{id}/members/{user_id}"
tags: ["Groups"]
---

# Remove user from group

`DELETE /groups/{id}/members/{user_id}`

## Request

- Base URL: `/v1` (relative, and the document’s source URL is not known)
- URL: `/v1/groups/{id}/members/{user_id}`
- Auth: API key in header `Authorization`

Removes a user from an existing group in Cognito

## Path parameters

- `id` string, required
- `user_id` string, required

## Response `200`

User removed from group

- Group: A group in the user pool
  - `id` string: The group ID
  - `name` string: The group name
  - `precedence` integer: The priority of the group
  - `created` string, date-time: The date the group was created
  - `last_modified_date` string, date-time
  - `role_arn` string
  - `user_pool_id` string

## Other responses

- `400`: Request rejected due to invalid parameters supplied
- `401`: Authentication information is missing or invalid
- `500`: Failed to process the request due to an internal error

---

[API](https://skmtc.dev/office-of-national-statistics/apis/identity-api.md) - [All operations](https://skmtc.dev/office-of-national-statistics/apis/identity-api/llms.txt) - [OpenAPI document](https://skmtc.dev/office-of-national-statistics/apis/identity-api/revisions/6472459b6b03?raw)