# 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://rest-api.symphony.com/main/compliance-barrier-groups/compliance-user-groups/update-a-compliance-user-group.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.