Actions116
- š¬ Chats Actions
- š¤ Contacts Actions
- š„ļø Sessions Actions
- š Profile Actions
- š¼ļø Screenshot Actions
- š¤ Chatting Actions
- š¢ Channels Actions
- š¢ Status Actions
- š„ Groups Actions
- Add Participants
- Demote To Admin
- Create Group
- Get Groups
- Join Info Group
- Join Group
- Refresh Groups
- Get Group
- Delete Group
- Leave Group
- Get Chat Picture
- Set Picture
- Delete Picture
- Set Description
- Set Subject
- Set Info Admin Only
- Get Info Admin Only
- Set Messages Admin Only
- Get Messages Admin Only
- Get Invite Code
- Revoke Invite Code
- Get Participants
- Remove Participants
- Promote To Admin
- ā Presence Actions
- š·ļø Labels Actions
- š Observability Actions
- š Auth Actions
Overview
This node operation removes participants from a specified group in a messaging or collaboration platform. It is useful for managing group memberships by programmatically removing users from groups based on their IDs. For example, it can be used to automate the cleanup of inactive members or to enforce group membership policies.
Use Case Examples
- Remove specific users from a group by providing their participant IDs.
- Automate group management by removing participants based on certain criteria or events.
Properties
| Name | Meaning |
|---|---|
| Session | The session name used to identify the active session for the operation. |
| Id | The unique identifier of the group from which participants will be removed. |
| Participants | A JSON array specifying the participants to be removed, each identified by their unique ID. |
| Request Options | Additional options for the request such as batching, SSL certificate handling, proxy settings, and timeout configuration. |
Output
JSON
success- Indicates whether the participants were successfully removed from the group.removedParticipants- Details of the participants that were removed from the group.groupId- The ID of the group from which participants were removed.
Dependencies
- Requires an active session identified by the session name to authenticate and authorize the operation.
Troubleshooting
- Ensure the session name is valid and active; otherwise, the operation will fail due to authentication errors.
- Verify that the group ID is correct and that the group exists; invalid group IDs will cause errors.
- Participants must be specified in the correct JSON format; malformed JSON will cause parsing errors.
- If batching is enabled, ensure batch size and interval are set appropriately to avoid request throttling or timeouts.
- If SSL certificate validation is disabled, be aware of potential security risks.
- Proxy settings must be correctly configured if used, including authentication if required.