buddyboss/manage-group-settings reads and writes what a group can do: its forum, invite permissions, media rules and privacy controls.
Always call action=get first.
At a glance
| Ability | buddyboss/manage-group-settings |
| 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 |
There is no fixed list of settings
The available settings are decided at runtime by which components and add-ons are active. A site with media off has no media settings; one with a forums add-on has settings the next site does not.
So there is no documented field list to work from, and the read is the only way to learn the field names for a given site.
BuddyBoss silently ignores names it does not recognise, which means a write with a wrong field name succeeds and changes nothing. That is why the response reports the section state afterwards rather than echoing what you sent — compare the two to confirm the change landed.
Privacy is protected on partial writes. BuddyBoss resets an omitted group status to public rather than leaving it alone, which would turn a private group public as a side effect of changing its invite rules. The current value is re-submitted unless you name one.
That behaviour is worth knowing about even when using this ability, because it is what happens to anything writing these settings without the same protection.
Idempotent.
Input
| Name | Type | Required | What it is |
|---|---|---|---|
group_id | integer | Yes | The group. |
action | string | Yes | get or set. |
fields | object | For set | A map of field name to value, using names from the get response. |
What comes back
| Name | Type | What it is |
|---|---|---|
settings | object | The section state after the call. |
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:
What can members of this group do?
It resolves to one call:
{
"ability": "buddyboss/manage-group-settings",
"parameters": {
"group_id": 12,
"action": "get"
}
}Worth knowing
- The field names are site-specific and only knowable from the read.
- Unrecognised names are ignored silently. Compare the returned state.
- An omitted group status would otherwise reset to public.
- Idempotent.
Related abilities
- BuddyBoss Manage Group — what the group is, rather than does
- BuddyBoss Get Community Overview — which components create settings
Get the plugins:
AcrossAI Abilities Manager · AcrossAI MCP Manager
Browse the rest: Every ability, by category