buddyboss/manage-group-membership changes one member’s standing in a group.
Six actions, and two of them are frequently confused.
At a glance
| Ability | buddyboss/manage-group-membership |
| Toolset | BuddyBoss — toolset/buddyboss |
| Group | BuddyBoss › Groups |
| Requires | AcrossAI Pro, plus BuddyBoss Platform active on the site |
| Capability | manage_options |
| Safety | Writes data |
| Repeatable | Idempotent — running it twice leaves the same result |
| Ships in | AcrossAI Pro 0.9.16 and later |
Remove and ban are different decisions
remove takes somebody out of the group and lets them rejoin. ban takes them out and stops them returning. Both produce a member who is not in the group, and only one of them is a moderation decision.
Picking the wrong one is quietly consequential in both directions: a removal where a ban was meant lets somebody walk back in, and a ban where a removal was meant blocks somebody who did nothing wrong from a group they may want to rejoin.
promote takes a role — admin for organizer, mod for moderator — and demote returns somebody to plain member.
BuddyBoss tends to no-op rather than error when a write assumes a state that is not true. Banning somebody who is not a member, or promoting somebody who is already an organizer, succeeds and changes nothing — so reading the current state first is how you tell a successful write from a successful nothing.
So this checks the member’s current standing before writing, and an action that cannot apply is refused with a clear reason rather than producing an opaque failure from BuddyBoss or a silent success that did nothing.
Idempotent.
Input
| Name | Type | Required | What it is |
|---|---|---|---|
group_id | integer | Yes | The group. |
user_id | integer | Yes | The member. |
action | string | Yes | add, remove, ban, unban, promote or demote. |
role | string | For promote | admin for organizer, mod for moderator. |
What comes back
| Name | Type | What it is |
|---|---|---|
user_id | integer | The member. |
standing | string | Their standing afterwards. |
success | boolean | Whether the call completed. |
message | string | A one-line summary of what happened, suitable for showing a human. |
error_code | string | Present only on failure — a stable machine-readable reason, such as a missing field, a wrong field type or an unmet confirmation. |
Example
Ask your assistant:
Make this member an organizer of the group.
It resolves to one call:
{
"ability": "buddyboss/manage-group-membership",
"parameters": {
"group_id": 12,
"user_id": 44,
"action": "promote",
"role": "admin"
}
}Worth knowing
- Remove lets them back; ban does not. Choose deliberately.
- The current standing is checked, so impossible actions are refused rather than no-ops.
adminis the organizer role.- Idempotent.
Related abilities
- BuddyBoss List Group Members — read the current standings
- BuddyBoss Manage Group Invites — invite rather than add
Get the plugins:
AcrossAI Abilities Manager · AcrossAI MCP Manager
Browse the rest: Every ability, by category