---
title: "Updates existing group roleset."
method: PATCH
path: "/v1/groups/{groupId}/rolesets/{rolesetId}"
tags: ["Groups"]
---

# Updates existing group roleset.

`PATCH /v1/groups/{groupId}/rolesets/{rolesetId}`

## Path parameters

- `groupId` integer, required
- `rolesetId` integer, required

## Request body

- RobloxGroupsApiModelsRequestUpdateRoleSetRequest
  - `name` string — The name of the roleset.
  - `description` string — The description of the roleset.
  - `rank` integer — The rank/positioning of the roleset.
  - `color` integer — Optional. The color of the roleset (GroupRoleSetColorType value, e.g. 0 = Invalid, 1 = Blue). When omitted, only name and description are updated and the existing color is left unchanged. When set, name, description, and color are updated via UpdateGroupRoleSetProperties.

## Response `200`

OK

- RobloxGroupsApiGroupRoleResponse — A group role response model
  - `id` integer — The role id
  - `name` string — The role name
  - `description` string — The role description
  - `rank` integer — The role rank
  - `memberCount` integer — The number of members in the role.
  - `isBase` boolean — Whether or not the role is the base role for the group
  - `color` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 — The role color. ['Invalid' = 0, 'Blue' = 1, 'Green' = 2, 'Purple' = 3, 'Yellow' = 4, 'Orange' = 5, 'Red' = 6, 'Magenta' = 7, 'Teal' = 8, 'Turquoise' = 9, 'Rust' = 10, 'Pistachio' = 11, 'Midnight' = 12, 'Lavender' = 13, 'Pink' = 14, 'Crimson' = 15, 'Plum' = 16]

## Other responses

- `400` — 5: Role name already exists. 6: Rank value is out of bounds. 7: The role name is too long. 8: The role description is too long. 10: This group does not exist. 14: Role name can not be empty. 15: This role does not exist. 19: Cannot update Guest role. 20: Cannot update Owner role rank.
- `401` — 0: Authorization has been denied for this request.
- `403` — 0: Token Validation Failed 9: You do not have permissions to perform this action.
- `409` — 28: Migration in progress. Please try again in a moment.

---

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