> ## Documentation Index > Fetch the complete documentation index at: https://mintlify.com/NapNeko/NapCatQQ/llms.txt > Use this file to discover all available pages before exploring further. # Group Actions > OneBot 11 group management actions ## get\_group\_info Get group information. ### Request Group number ### Response Group number Group name Group remark (note) All members muted: `-1` if enabled, `0` if disabled Current member count Maximum member capacity ### Example ```json theme={null} // Request { "group_id": "123456" } // Response { "status": "ok", "retcode": 0, "data": { "group_id": 123456, "group_name": "Example Group", "group_remark": "My Group", "group_all_shut": 0, "member_count": 50, "max_member_count": 200 } } ``` ## get\_group\_list Get the list of groups the bot has joined. ### Request No parameters required. ### Response Array of group objects Each group object contains: * `group_id` (number): Group number * `group_name` (string): Group name * `group_remark` (string): Group remark * `group_all_shut` (number): Mute status * `member_count` (number): Member count * `max_member_count` (number): Max capacity ### Example ```json theme={null} // Response { "status": "ok", "retcode": 0, "data": [ { "group_id": 123456, "group_name": "Group 1", "group_remark": "My Group 1", "group_all_shut": 0, "member_count": 50, "max_member_count": 200 }, { "group_id": 789012, "group_name": "Group 2", "group_remark": "My Group 2", "group_all_shut": -1, "member_count": 100, "max_member_count": 500 } ] } ``` ## get\_group\_member\_info Get information about a group member. ### Request Group number Member QQ number Bypass cache and fetch fresh data ### Response Group number Member QQ number Member nickname Group card (display name in group) Gender: `male`, `female`, or `unknown` Age Join time (Unix timestamp) Last message time (Unix timestamp) Group level QQ level Role: `owner`, `admin`, or `member` Special title Location/area Has bad record Special title expiration time Can change group card Mute expiration timestamp Is a robot/bot account ### Example ```json theme={null} // Request { "group_id": "123456", "user_id": "987654" } // Response { "status": "ok", "retcode": 0, "data": { "group_id": 123456, "user_id": 987654, "nickname": "User", "card": "Card Name", "sex": "male", "age": 20, "join_time": 1234567890, "last_sent_time": 1234567890, "level": "10", "qq_level": 64, "role": "member", "title": "Special Member", "shut_up_timestamp": 0, "card_changeable": true, "is_robot": false } } ``` ## get\_group\_member\_list Get the list of members in a group. ### Request Group number Bypass cache and fetch fresh data ### Response Array of group member objects (same structure as `get_group_member_info`) ### Example ```json theme={null} // Request { "group_id": "123456" } // Response { "status": "ok", "retcode": 0, "data": [ { "group_id": 123456, "user_id": 111111, "nickname": "Owner", "card": "Group Owner", "role": "owner" }, { "group_id": 123456, "user_id": 222222, "nickname": "Admin", "card": "Administrator", "role": "admin" }, { "group_id": 123456, "user_id": 333333, "nickname": "Member", "card": "Regular Member", "role": "member" } ] } ``` ## set\_group\_kick Kick a member from the group. ### Request Group number Member QQ number to kick Reject future join requests from this user ### Response Returns `null` on success ### Example ```json theme={null} // Request { "group_id": "123456", "user_id": "987654", "reject_add_request": true } // Response { "status": "ok", "retcode": 0, "data": null } ``` ## set\_group\_ban Mute a group member. ### Request Group number Member QQ number to mute Mute duration in seconds (0 to unmute, max 2592000 = 30 days) ### Response Returns `null` on success ### Example ```json theme={null} // Request - Mute for 1 hour { "group_id": "123456", "user_id": "987654", "duration": 3600 } // Request - Unmute { "group_id": "123456", "user_id": "987654", "duration": 0 } // Response { "status": "ok", "retcode": 0, "data": null } ``` ## set\_group\_whole\_ban Enable or disable all members mute. ### Request Group number Enable (`true`) or disable (`false`) all members mute ### Response Returns `null` on success ### Example ```json theme={null} // Request - Enable { "group_id": "123456", "enable": true } // Response { "status": "ok", "retcode": 0, "data": null } ``` ## set\_group\_admin Set or remove group admin. ### Request Group number Member QQ number Promote (`true`) or demote (`false`) admin ### Response Returns `null` on success ### Example ```json theme={null} // Request - Promote to admin { "group_id": "123456", "user_id": "987654", "enable": true } // Response { "status": "ok", "retcode": 0, "data": null } ``` ## set\_group\_card Set a member's group card (display name). ### Request Group number Member QQ number New group card (empty string to clear) ### Response Returns `null` on success ### Example ```json theme={null} // Request { "group_id": "123456", "user_id": "987654", "card": "New Card Name" } // Response { "status": "ok", "retcode": 0, "data": null } ``` ## set\_group\_name Set the group name. ### Request Group number New group name ### Response Returns `null` on success ### Example ```json theme={null} // Request { "group_id": "123456", "group_name": "New Group Name" } // Response { "status": "ok", "retcode": 0, "data": null } ``` ## set\_group\_leave Leave a group. ### Request Group number to leave Dismiss the group (only works if bot is owner) ### Response Returns `null` on success ### Example ```json theme={null} // Request { "group_id": "123456", "is_dismiss": false } // Response { "status": "ok", "retcode": 0, "data": null } ``` ## set\_group\_add\_request Approve or reject a group join request. ### Request Request flag from group request event Request type: `add` (join request) or `invite` (invitation) Approve (`true`) or reject (`false`) Rejection reason (only used when rejecting) ### Response Returns `null` on success ### Example ```json theme={null} // Request - Approve { "flag": "request_flag_12345", "sub_type": "add", "approve": true } // Request - Reject { "flag": "request_flag_12345", "sub_type": "add", "approve": false, "reason": "Not accepting new members" } // Response { "status": "ok", "retcode": 0, "data": null } ``` ## Additional Group Actions ### get\_group\_essence Get group essence messages (pinned messages). ### set\_essence\_msg Set a message as essence (pin it). ### del\_essence\_msg Remove a message from essence (unpin it). ### get\_group\_notice Get group announcements. ### send\_group\_notice Publish a group announcement. ### get\_group\_honor\_info Get group honor information (active members, etc.). ### get\_group\_shut\_list Get list of muted members in a group.