---
title: "UpdateUsergroup updates a user group's name and/or description"
method: PATCH
path: "/v1/orgs/{org}/usergroups/{usergroup}"
---

# UpdateUsergroup updates a user group's name and/or description

`PATCH /v1/orgs/{org}/usergroups/{usergroup}`

## Path parameters

- `org` string, required
- `usergroup` string, required

## Request body

- object
  - `description` string
  - `newName` string

## Response `200`

A successful response.

- V1UpdateUsergroupResponse
  - `usergroup` V1Usergroup
    - `createdOn` string, date-time
    - `groupDescription` string
    - `groupId` string
    - `groupName` string
    - `managed` boolean
    - `updatedOn` string, date-time

## Other responses

- `default` — An unexpected error response.

## Changes

> 54 revisions in range; 4 could not be searched.

- **2026-02-17** (v1) `5dda040d7e2b` — 1 info
  - endpoint added
- **2025-12-11** (v1) `f317ff96998d` — 1 breaking
  - api removed without deprecation

[Change history](https://skmtc.dev/rilldata/apis/rill-admin-api/changes/v1/orgs/:org/usergroups/:usergroup/patch.md)

---

[API](https://skmtc.dev/rilldata/apis/rill-admin-api.md) · [All operations](https://skmtc.dev/rilldata/apis/rill-admin-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/rilldata/rill-admin-api/revisions/abe7a430f373/schema)