Browse SDKs · HarmonyOS
Platform
SDKsHarmonyOSEnterprise

Transfer group ownership

Transfer group ownership to another active member in the group.

Copy

Only the current group owner can transfer ownership. The target user must be an active member of the specified group.

Code example

import sdk, { TransferGroupOwnerReq } from '@openimsdk/imsdk';

const request: TransferGroupOwnerReq = {
  groupID: groupID,
  ownerUserID: targetUserID,
};
await sdk.transferGroupOwner(request);

Parameters

ParameterTypeRequiredDescription
groupIDstringYesTarget group identifier.
ownerUserIDstringYesUser ID of the new group owner.

Return value

Returns a Promise that resolves to void when ownership has transferred on the server.

State changes after the call

Once the Promise resolves, roles for both the former owner and the new owner are updated. The SDK triggers group info and group member info changed events; clients update the group owner matching groupID and update member roles matching groupID:userID. For complete event listeners, see Retrieve group member list. If the former owner intends to leave the group, transfer ownership first before calling Leave group.