---
title: "Update a group"
method: PATCH
path: "/api/1/groups/{groupId}"
tags: ["Groups (Preferred)"]
---

# Update a group

`PATCH /api/1/groups/{groupId}`

Updates the name and/or description of an existing group.

At least one field must be provided. Only the fields included in the request body are updated
(partial update semantics).

Requires the **GROUPMANAGEMENT** security role.

## Path parameters

- `groupId` string, uuid, required

## Request body

- object
  - `name` string — New name for the group. Must be unique within the account.
  - `description` string, nullable — New description for the group. Pass `null` to clear it.

## Response `200`

Group updated successfully.

- Group
  - `id` string, uuid
  - `title` string
  - `description` string
  - `guideIds` string[]
  - `guides` GuideOverview[]
    - `id` string, uuid
    - `creationTime` string
    - `lastModifiedTime` string
    - `title` string
    - `visibility` 'PRIVATE' | 'SPECIFIC' | 'PORTAL' | 'PUBLIC'
    - `version` integer
    - `ownerId` string
    - `cover` Cover
      - `assetId` string
      - `assetName` string
      - `imageUrl` string
      - `detailUrl` string
    - `isFeatured` boolean
    - `type` 'MULTI_PAGE' | 'SINGLE_PAGE' | 'HOME_PAGE'
    - `groupId` string, uuid
    - `canEdit` boolean
    - `canView` boolean
    - `shared` boolean
    - `targetedPagesEnabled` boolean
  - `visibility` 'PRIVATE' | 'SPECIFIC' | 'PORTAL' | 'PUBLIC'
  - `ownerId` string
  - `version` integer
  - `creationTime` string
  - `lastModifiedTime` string
  - `cover` object
    - `colorId` string
    - `assetId` string
    - `assetName` string
    - `imageUrl` string
    - `detailUrl` string
  - `canEdit` boolean
  - `canView` boolean
  - `shared` boolean

## Other responses

- `401` — Missing or invalid authentication. The response body is empty.
- `403` — The authenticated user does not have the **GROUPMANAGEMENT** security role.
- `404` — Group not found.
- `409` — A group with the requested name already exists.
- `422` — Validation error (e.g. empty request body, malformed group ID, or `name` is not a string).

---

[API](https://skmtc.net/bynder/apis/oauth-2-0.md) · [All operations](https://skmtc.net/bynder/apis/oauth-2-0/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bynder/oauth-2-0/versions/bb9efc864ce1/schema)