SDKsiOS

Set or remove an administrator

Set or remove a group administrator with OpenIM iOS SDK.

Invoke setGroupMemberRoleLevel:userID:roleLevel:onSuccess:onFailure: to promote a regular member to administrator or demote an administrator to a regular member (only the group owner has permission to perform this action):

Parameters

Parameter	Type	Required	Description
`groupID`	`NSString *`	Yes	Target group ID.
`userID`	`NSString *`	Yes	Target member user ID.
`roleLevel`	`OIMGroupMemberRole`	Yes	Desired role level enumeration.

Role level enumeration

Enumeration value	Numeric value	Description
`OIMGroupMemberRoleMember`	`20`	Regular member (used to remove administrator status).
`OIMGroupMemberRoleAdmin`	`60`	Administrator (used to grant administrator privileges).

Code example

[[OIMManager manager] setGroupMemberRoleLevel:@"group_1001"
                                      userID:@"user_002"
                                   roleLevel:OIMGroupMemberRoleAdmin
                                   onSuccess:^(NSString * _Nullable data) {
                                       NSLog(@"setGroupMemberRoleLevel success");
                                   }
                                   onFailure:^(NSInteger code, NSString *message) {
                                       NSLog(@"setGroupMemberRoleLevel failed: %ld %@", (long)code, message);
                                   }];

Return value

The onSuccess callback returns confirmation when the server accepts the role change.

State changes after the call

Role update restrictions: Group ownership cannot be modified using this method; to transfer ownership, call Transfer group ownership.
Event notification: Role changes broadcast across active clients via onGroupMemberInfoChanged:. The client updates the member's role attribute matching groupID:userID.
Re-query calibration: For administration queries, refer to Retrieve the group owner and administrators.

Was this page helpful?