---
title: "Update group"
method: PATCH
path: "/groups/{groupId}"
tags: ["Groups"]
---

# Update group

`PATCH /groups/{groupId}`

Updates a group's name or description. Requires ownership.

## Request body

- GroupUpdate
  - `name` string
  - `description` string, nullable

## Response `200`

Group updated successfully.

- Group
  - `id` string, ulid, required
  - `owner` string, ulid, required
  - `name` string, required
  - `description` string, nullable
  - `type` 'domain' | 'list', required
  - `domain` string, fqdn — Present if type is 'domain'.
  - `members` string[] — Array of user emails. Present if type is 'list'.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `422` — Unprocessable Entity

## Changes

- **2025-07-14** `9aec27988ad3` — 1 breaking
  - the `domain` response's property type/format changed from `string`/`hostname` to `string`/`fqdn` for status `200`
- **2025-07-14** `128cf3db212c` — 2 info
  - added the optional property `domain` to the response with the `200` status
  - added the optional property `members` to the response with the `200` status
- **2025-07-13** `02015e1343c5` — 1 info
  - endpoint added
- **2025-07-13** `0d7f3c750979` — 1 breaking
  - api removed without deprecation

[Change history](https://skmtc.dev/osdg-iiith/apis/forms-portal-api/changes/groups/:groupId/patch.md)

---

[API](https://skmtc.dev/osdg-iiith/apis/forms-portal-api.md) · [All operations](https://skmtc.dev/osdg-iiith/apis/forms-portal-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/osdg-iiith/forms-portal-api/revisions/7761ba23f677/schema)