# Update a Compliance User Group

## PUT /v2/admin/usergroups/{groupId}

> Update user group informations

```json
{"openapi":"3.1.1","info":{"title":"Restricted Pod API","version":"20.17.1"},"servers":[{"url":"https://yourpodURL.symphony.com/pod"}],"paths":{"/v2/admin/usergroups/{groupId}":{"put":{"summary":"Update user group informations","parameters":[{"schema":{"type":"string"},"name":"sessionToken","description":"Session authentication token.","in":"header","required":true},{"schema":{"type":"string"},"name":"groupId","in":"path","required":true}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserGroupResponse"}}}},"400":{"description":"Client error, see response body for further details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized: Session tokens invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden: Caller lacks necessary entitlement.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found. See response body for further details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Unprocessable Entity: Error on updating user group.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Server error, see response body for further details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserGroupUpdate"}}},"required":true}}}},"components":{"schemas":{"UserGroupResponse":{"description":"Group object response","type":"object","properties":{"id":{"description":"Group ID","type":"string"},"name":{"description":"Group name","type":"string"},"area":{"description":"An optional string attribute used for categorizing groups","type":"string"},"description":{"description":"Group description","type":"string"},"type":{"description":"Group type","type":"string"},"active":{"description":"Group status","type":"boolean"},"createdDate":{"description":"Date of group creation","type":"integer","format":"int64"},"modifiedDate":{"description":"Date of group last update","type":"integer","format":"int64"},"memberCount":{"description":"Number of group members","type":"integer","format":"int64"},"assigneeCount":{"description":"Number of group assignees","type":"integer","format":"int64"}}},"Error":{"type":"object","properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"}}},"UserGroupUpdate":{"description":"Body for group update","type":"object","properties":{"name":{"description":"Group name","type":"string"},"area":{"description":"Group area","type":"string"},"description":{"description":"Group description","type":"string"},"active":{"description":"Group status","type":"boolean"}}}}}}
```

> #### 🚧 Roles and Privileges
>
> Calling this endpoint requires the **Scope Management** role with the MANAGE\_ROLE\_SCOPES entitleable action.\
> See [Bot Permissions](https://docs.developers.symphony.com/building-bots-on-symphony/configuration/bot-permissions) for a list of roles and associated privileges.