---
title: "Update groups users"
method: PUT
path: "/groups/{id}/members"
tags: ["Groups"]
---

# Update groups users

`PUT /groups/{id}/members`

Update groups users

## Path parameters

- `id` string, required

## Request body

- object
  - `user_id` string, required

## Response `200`

List of users in updated group

- UserList — A list of users
  - `users` User[]
    - `id` string — The users id
    - `forename` string — The users forename
    - `surname` string — The users surname
    - `email` string — The users email address
    - `groups` string[] — The groups the user belongs to
    - `active` boolean — Whether or not the user is active
    - `status_notes` string — Notes about the updates made to the user
    - `status` 'UNCONFIRMED' | 'CONFIRMED' | 'ARCHIVED' | 'COMPROMISED' | 'UNKNOWN' | 'RESET_REQUIRED' | 'FORCE_CHANGE_PASSWORD' — The current status of the user
  - `count` integer

## 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.net/office-of-national-statistics/apis/identity-api.md) · [All operations](https://skmtc.net/office-of-national-statistics/apis/identity-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/office-of-national-statistics/identity-api/revisions/6472459b6b03/schema)