---
title: "Update a Specific Group"
method: PATCH
path: "/api/v2/groups/{id}"
tags: ["Group"]
---

# Update a Specific Group

`PATCH /api/v2/groups/{id}`

This endpoint updates supplied fields for a specific group. <h3>Required Scope</h3>`groups:write`

## Path parameters

- `id` string, required

## Request body

- GroupsIdBody
  - `data` Apiv2groupsData
    - `type` string
    - `attributes` Apiv2groupsDataAttributes
      - `name` string, nullable, required — The title of the group.
      - `description` string, nullable, required — The description of the group.
      - `privacy` string — The privacy setting for this group. Can be `Open`, `Closed`, `Private` and `Administrative`. Global Admin Tool Organizations privacy settings can be `Open` and `Private`.
      - `group-type` string — Specifies the type of Group. Can either be `Group` or `ManagerGroup`

## Response `200`

Success

- ListedGroup
  - `links` SelfWithNextLink
    - `self` string
    - `next` string
  - `data` ListedGroupData[]
    - `type` string
    - `id` string
    - `attributes` ListedGroupAttributes
      - `name` string, nullable — The name of the group.
      - `description` string, nullable — Short description of the group.
      - `privacy` string, nullable — Privacy setting for the group.
      - `external-group-id` string, nullable — External identifier of the group.
      - `created-at` string, date-time — Date that the group was created. (UTC)
    - `links` SelfLink
      - `self` string
    - `relationships` CreatedByUserRelationshipsInner[]
      - `created_by` UserRelationshipsInnerUser
        - `data` UserRelationshipData
          - `id` string, nullable
          - `type` string, nullable

---

[API](https://skmtc.net/degreed/apis/degreed-api-web.md) · [All operations](https://skmtc.net/degreed/apis/degreed-api-web/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/degreed/degreed-api-web/revisions/4a22b709515c/schema)