Skip to main content

Transfer Group Ownership

Transfer group management privileges to another member, with the option to leave the group.

Enabling the Service

Before using this feature, you must enable the profile hosting service by submitting a ticket.

Request Method

POST: https://data center domain/entrust/group/transfer/owner.json

Rate Limit: 100 requests per second

Signature Rule: All server API requests require signature verification. See API Request Signature for details.

Request Parameters

The HTTP request body uses application/x-www-form-urlencoded format and supports the following form parameters:

ParameterTypeRequiredDescription
groupIdStringYesGroup ID
newOwnerStringYesID of the new Group Owner
isQuitNumberNoWhether the original Group Owner leaves the group:
  • 0: No (default)
  • 1: Yes
isDelBanNumberNoWhether to remove the original Group Owner's mute status (applies when isQuit=1):
  • 0: No
  • 1: Yes (default)
isDelWhiteNumberNoWhether to remove the original Group Owner from the Mute Exceptions list (applies when isQuit=1):
  • 0: No
  • 1: Yes (default)
isDelFollowedNumberNoWhether to remove the original Group Owner from Members I Follow (applies when isQuit=1):
  • 0: No
  • 1: Yes (default)

Request Example

POST /entrust/group/transfer/owner.json HTTP/1.1  
Host: api.rong-api.com
App-Key: uwd1c0sxdlx2
Nonce: 14314
Timestamp: 1408710653491
Signature: 45beb7cc7307889a8e711219a47b7cf6a5b000e8
Content-Type: application/x-www-form-urlencoded

groupId=groupId1&newOwner=fff

Response

The HTTP response body contains a JSON object with the following structure:

FieldTypeDescription
codeNumberStatus code (200 indicates success).

Response Example

HTTP/1.1 200 OK  
Content-Type: application/json; charset=utf-8

{
"code": 200
}