v1

latestOpenAPI 3.0.32026-08-061874701.5 MB

groups

Update group

Updates the Group specified in the URL.

This operation is only available to group administrators and system administrators.

put/groups/{groupId}

Request body

namestring

name (Optional)

Must be unique within the organization account.

descriptionstring

Description (optional).

ownerIdnumber

ownerId (optional)

Id of an admin user to whom the group ownership is transferred.

Example request

{
  "name": "Renamed group",
  "description": "Some new description",
  "ownerId": 94094820842
}

Response

Result object containing the Group object for the updated group

message'PARTIAL_SUCCESS' | 'SUCCESS'

Message that indicates the outcome of the request. (One of SUCCESS or PARTIAL_SUCCESS.)

resultCode0 | 3

'0' Success
'3' Partial Success of Bulk Operation

Example response

{
  "message": "SUCCESS",
  "result": {
    "id": 4583173393803140,
    "name": "Group 1",
    "description": "My group",
    "owner": "john.doe@smartsheet.com",
    "ownerId": 2331373580117892
  }
}