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

# Update group

`PUT /groups/{groupId}`

Updates the Group specified in the URL.

**_This operation is only available to group administrators and system administrators._**

## Request body

- object
  - `name` string — name (Optional) Must be unique within the organization account.
  - `description` string — Description (optional).
  - `ownerId` number — ownerId (optional) Id of an admin user to whom the group ownership is transferred.

## Response `200`

Result object containing the [Group object](/api/smartsheet/openapi/groups/group) for the updated group

- object
  - `message` 'PARTIAL_SUCCESS' | 'SUCCESS' — Message that indicates the outcome of the request. (One of `SUCCESS` or `PARTIAL_SUCCESS`.)
  - `resultCode` 0 | 3 — * '0' Success * '3' Partial Success of Bulk Operation
  - `result` Group
    - `id` number — Group ID.
    - `name` string — Group name.
    - `description` string — Group description.
    - `owner` string, email — Group owner’s email address.
    - `ownerId` number — Group owner's user ID.
    - `createdAt` union
      - string, date-time
      - number
    - `modifiedAt` union
      - string, date-time
      - number

## Other responses

- `400` — Bad Request. See Smartsheet Error Code and Message for details.
- `500` — Internal Server Error. See Smartsheet Error Code and Message for details.

---

[API](https://skmtc.net/smartsheet/apis/smartsheet-openapi-reference.md) · [All operations](https://skmtc.net/smartsheet/apis/smartsheet-openapi-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smartsheet/smartsheet-openapi-reference/versions/b4afda95fb51/schema)