Edit a user group of the MPC user management.
This request will affect the policies and the approval workflows that include this group
Users provided in user_ids that are already in another group will be moved from the
previous group to the new group.
In case of removing a user from the user_ids list, this user will move to the 'Unassigned' group
MPC user created from the cold is editable only in its role and user group.
-------------------- Request Example--------------------
editUserGroup(
id="f045b9e0-01fd-4e07-a297-1bce52d7fc65",
name="EU-USS",
request_extra_data={
"MessageNumber": 2,
"SessionId": "4e4ceea2-248e-40e8-bca7-41cf0957d59c"
},
userIds=[],
view_permission_set_id="2"
)
-------------------- Response Example --------------------
{
"FunctionData": {
"StatusCode": 0,
"StatusCodeDescription": "User group edited successfully"
},
"Meta": {
"AccessToken": "ab4ab9004a867993e5033f976e4f77ef8c6014fe4b30a50e5973ef51a99146de",
"Destination": "04a105027a5921dbf475acee16a35bab04500e86f6376bda7e066d882e6783a58bc2c6b27a1a773243e8d9b581efbd1a79a5c9f8fc779135f976e3a1a58ecdf721",
"Source": "fb3cd2dd3df524f7e2e165e3e1d4c29213aa4273420753596503a42e16bbf09bedd4c5ae232bcc8128e5d70f6afe8ba8a11658370c9209e07eaf878fa845ced3ef",
"Time": "2026-03-15 19:11:22.160"
}
}
### Error Responses
| Error Type | Http Code | GK8 error code | Reason / Description | Example Response |
|------------------|-----------|----------------|-------------------------------------------|-----------------------------------------------------------------|
| Backend Response | 400 | 1 | Unknown user group | "StatusCode": 1 |
| Backend Response | 400 | 2 | User group name already exists | "StatusCode": 2 |
| Backend Response | 400 | 3 | Invalid name | "StatusCode": 3 |
| Backend Response | 400 | 4 | Unknown view permission set ID | "StatusCode": 4 |
| Backend Response | 400 | 5 | Unknown user | "StatusCode": 5, "UserIds": ["[email protected]", "[email protected]"] |
| Backend Response | 400 | 6 | Invalid policy | "StatusCode": 6, "PolicyIds": ["test1", "test2"] |
| Backend Response | 400 | 7 | Invalid approval workflows | "StatusCode": 7, "ApprovalWorkflowIds": ["6", "9"] |
| Backend Response | 400 | 8 | Users in admin group must have admin role | "StatusCode": 8, "UserIds": ["[email protected]", "[email protected]"] |
| Backend Response | 400 | 9 | Duplicate user | "StatusCode": 9, "UserId": "[email protected]" |
| Backend Response | 400 | 10 | Cannot rename built-in user group | "StatusCode": 10 |
| Backend Response | 400 | 11 | Insufficient available account approvers | "StatusCode": 11, "UserIds": ["[email protected]"] |
| Backend Response | 400 | 12 | Invalid transaction notification users | "StatusCode": 12, "UserIds": ["[email protected]"] |
| Backend Response | 400 | 13 | Cannot edit system user group | "StatusCode": 13 |
| Backend Response | 400 | 14 | Users are managed externally | "StatusCode": 14 |
idstringid of the group requested for editing
namestringthe name of the updated user group or the previous one
view_permission_set_idstring<p>the view permission id for the new group - defines the accounts viewable in the group</p>
user_idsarraydefines the member list for the new group
request_extra_dataobjectadditional data for the administrative request
acceptstringGenerated from available response content types
200success
curl --request POST \
--url '/editUserGroup?id=123&name=newGroup&view_permission_set_id=0&user_ids=array&request_extra_data={%0A%20%20%22MessageNumber%22%3A%205%2C%0A%20%20%22SessionId%22%3A%20%223478593863424051983840947%22%0A}%0A' \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--data '{
"FunctionData": {
"Id": "123",
"Name": "user group name",
"ViewPermissionSetId": "0",
"RequestExtraData": {
"MessageNumber": 5,
"SessionId": "3478593863424051983840947"
}
},
"Meta": {
"FunctionName": "editUserGroup",
"RandomData": "288cd49d4b8bf00e7d6114b78d5668d5581d6b953fafef779133caa844cd4229",
"Destination": "b9cb8afe52f1d52521cf2b62dfe12146156ad5328f83c62c20c7da81b263356a61340de745c858998544c041798b01c2f4fac31bebe52a19280a32cd57d6d374ea",
"Time": "2021-02-07T18:37:46.948Z",
"Source": "048b99461a70a49abe63fd585cb224177a22a92d2e9e4ddfbc0027887bee9d1843388f42a3eb2e740565e115ad8b7981abf59e3b03b771f4b063b53c517d7a9d99",
"AccessToken": "51311c84d2c8fd2fafbe56ceb1fb30a99d3417abfc55769577338ab286798087"
}
}'