buddyboss/manage-block blocks or unblocks a member on behalf of the account running the request.
BuddyBoss blocking is personal, not administrative — which is the thing to understand before using it.
At a glance
| Ability | buddyboss/manage-block |
| Toolset | BuddyBoss — toolset/buddyboss |
| Group | BuddyBoss › Moderation |
| 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 |
This does not do what it sounds like
Blocking hides that member from this one account’s feeds and messages. It does not suspend them, does not hide their content from anyone else, and does not stop them posting.
So an administrator blocking a problem member protects their own view and changes nothing for the community — which is almost never the intent when somebody says “block them”.
If the goal is to stop somebody affecting the whole community, the tools are elsewhere: buddyboss/manage-group-membership bans them from groups, buddyboss/act-on-activity spams their posts, and suspension lives in wp-admin.
The legitimate use for this is the ordinary member-facing one, applied on behalf of a member who asked.
Unblocking is safe and loses nothing.
Idempotent.
Input
| Name | Type | Required | What it is |
|---|---|---|---|
action | string | Yes | block or unblock. |
user_id | integer | Yes | The member to block or unblock. |
What comes back
| Name | Type | What it is |
|---|---|---|
user_id | integer | The member. |
blocked | boolean | Their state afterwards, for this account. |
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:
Block this member.
It resolves to one call:
{
"ability": "buddyboss/manage-block",
"parameters": {
"action": "block",
"user_id": 44
}
}Worth knowing
- Personal, not administrative. It changes one account’s view.
- It does not suspend, hide content from others, or stop them posting.
- For community-wide effect, use group bans, activity spam, or wp-admin.
- Unblocking loses nothing.
Related abilities
- BuddyBoss List Blocked Members — what this account has blocked
- BuddyBoss Manage Group Membership — the community-wide equivalent
Get the plugins:
AcrossAI Abilities Manager · AcrossAI MCP Manager
Browse the rest: Every ability, by category