---
title: "Edit a group"
method: PUT
path: "/groups/{groupId}"
tags: ["groups"]
---

# Edit a group

`PUT /groups/{groupId}`

## Request

- Base URL: `https://pmp-demo.privateplatform.mendix.com/groupservice/v2`
- URL: `https://pmp-demo.privateplatform.mendix.com/groupservice/v2/groups/{groupId}`
- Auth: one of:
  - HTTP basic
  - API key in header `Authorization`

## Use this operation to edit a group

- If a field is omitted in the request body, it is not updated. To set field to empty specify with empty string.

## Path parameters

- `groupId` string, required

## Request body

- GroupChangeRequest: Group change request
  - `name` string, required: Group name
  - `description` string: Group description
  - `parentGroupName` string, required: Parent group name

## Response `200`

Group

- object
  - `id` string: Group Id
  - `name` string: Group name
  - `description` string: Group description
  - `memberCount` integer: Group member count
  - `parentGroup` string: Parent group name

## Other responses

- `400`: Invalid input parameter or request body
- `401`: Authentication information is missing or invalid
- `403`: User has no permission for this operation
- `404`: Resource not found

---

[API](https://skmtc.dev/mendix/apis/group-service-v2.md) - [All operations](https://skmtc.dev/mendix/apis/group-service-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/mendix/apis/group-service-v2/revisions/77591db6a820?raw)