Skip to main content

Modify Group Member Information

Brief Description

  • Modifies group member information. The roleLevel field cannot be set to 100 (Group Owner). To transfer ownership, use the Transfer Group Ownership endpoint.

Request Method

  • post

Request URL

  • {API_ADDRESS}/group/set_group_member_info
Header NameExample ValueOptionalTypeDescription
operationID1646445464564RequiredstringUsed for global trace tracking. It is recommended to use a timestamp, unique for each request
tokeneyJhbxxxx3XsRequiredstringAdmin token

Request Parameters Example

{
"members": [
{
"groupID": "2137448827",
"userID": "2699373280",
"nickName": "newName",
"faceURL": "new faceURL",
"roleLevel": 60,
"ex": ""
}
]
}
Field NameOptionalTypeDescription
membersRequiredarrayList of group member objects
members.groupIDRequiredstringGroup ID
members.userIDRequiredstringGroup member ID
members.nickNameOptionalstringGroup member nickname
members.faceURLOptionalstringGroup member avatar URL
members.roleLevelOptionalintGroup member role level: 60 = Administrator, 20 = Regular Member
members.exOptionalstringGroup member extension field

Success Response Example

{
"errCode": 0,
"errMsg": "",
"errDlt": ""
}

Success Response Parameters Description

Parameter NameTypeDescription
errCodeintError code, 0 indicates success
errMsgstringBrief error message, empty if none
errDlterrDltDetailed error information, empty if none
dataobjectGeneral data object, see structure below

Failure Response Example

{
"errCode": 1004,
"errMsg": "RecordNotFoundError",
"errDlt": ": [1004]RecordNotFoundError"
}

Failure Response Parameters Description

Parameter NameTypeDescription
errCodeintError code, refer to global error code documentation
errMsgstringBrief error message
errDlterrDltDetailed error information