# update_group_role

Set or clear the workspace role a group grants its members.

Takes effect immediately for all members. Requires workspace billing-admin permission.

## Parameters

| Parameter         | Type          | Default | Description                                                                                                                                  |
| ----------------- | ------------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| group\_idrequired | string (uuid) | —       | The group to update.                                                                                                                         |
| role              | enum          | —       | New workspace role to grant members, or null to clear the group's role.One of: admin, editor, settings\_admin, art\_director, artist, member |