buddyboss/manage-group creates a group or updates an existing one: name, description, privacy status, parent group and group types.
It writes what a group is. What a group can do is buddyboss/manage-group-settings, on a different route.
At a glance
| Ability | buddyboss/manage-group |
| 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 |
How it works
types replaces the group’s types rather than adding to them. append_types and remove_types change them one at a time, which is what you want unless you are setting the full list deliberately.
Group types only exist when the site has enabled them. buddyboss/list-community-taxonomies reports which are available, and an empty list there means the feature is off rather than unconfigured.
Changing status to hidden is the change worth being deliberate about. It removes the group and its activity from every directory and feed, which to members is hard to distinguish from deletion — they simply stop being able to find something they were part of.
It is also the reversible alternative to deleting a group, which is why buddyboss/delete-group points back here.
Setting a parent nests the group, and nesting has consequences at deletion time: a parent with children cannot be deleted at all.
Idempotent.
Input
| Name | Type | Required | What it is |
|---|---|---|---|
action | string | Yes | create or update. |
group_id | integer | For update | Which group. |
name | string | For create | The group name. |
description | string | No | The group description. |
status | string | No | public, private or hidden. |
parent_id | integer | No | Nest under this group. |
types | array | No | Replaces the group’s types. |
append_types | array | No | Add these types. |
remove_types | array | No | Remove these types. |
What comes back
| Name | Type | What it is |
|---|---|---|
group | object | The group after the write. |
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:
Create a private group for the mentors.
It resolves to one call:
{
"ability": "buddyboss/manage-group",
"parameters": {
"action": "create",
"name": "Mentors",
"status": "private"
}
}Worth knowing
typesreplaces; use append and remove for single changes.- An empty group-types list means the feature is off.
- Hiding a group looks like deletion to its members.
- Nesting a group makes its parent undeletable.
Related abilities
- BuddyBoss Manage Group Settings — what the group can do
- BuddyBoss Delete Group — the gated alternative to hiding
- BuddyBoss List Community Taxonomies — the type slugs
Get the plugins:
AcrossAI Abilities Manager · AcrossAI MCP Manager
Browse the rest: Every ability, by category