buddyboss/manage-avatar reads or removes profile pictures and cover images, for either a member or a group.
Uploading a new image is not possible here.
At a glance
| Ability | buddyboss/manage-avatar |
| Toolset | BuddyBoss — toolset/buddyboss |
| Group | BuddyBoss › Media & Documents |
| 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
BuddyBoss requires a multipart file upload that a JSON call cannot make, so images must be set through the site. That is the same limitation as photos and documents.
action=get reports the current image and whether it is the default, which is the useful distinction — “has no avatar” and “has the default avatar” look identical in a rendered page and are different facts.
action=delete removes it and falls back to the default.
Deleting discards the original file. The member or group can upload a new picture, but the old one is not recoverable — which matters for a group cover image somebody designed, rather than for a member’s photo of themselves.
Cover images and avatars are separate, so removing one leaves the other.
Idempotent.
Input
| Name | Type | Required | What it is |
|---|---|---|---|
action | string | Yes | get or delete. |
object | string | Yes | member or group. |
object_id | integer | Yes | The member or group. |
image | string | No | avatar or cover. |
What comes back
| Name | Type | What it is |
|---|---|---|
image | object | The current image and whether it is the default. |
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:
Remove that group’s cover image.
It resolves to one call:
{
"ability": "buddyboss/manage-avatar",
"parameters": {
"action": "delete",
"object": "group",
"object_id": 12,
"image": "cover"
}
}Worth knowing
- Uploading needs a multipart request. This cannot set a new image.
- The default-image flag distinguishes “none” from “the default”.
- Deleting discards the original file permanently.
- Avatars and cover images are separate.
Related abilities
- BuddyBoss Get Member — the member’s avatar in context
- BuddyBoss Get Group — the group’s
Get the plugins:
AcrossAI Abilities Manager · AcrossAI MCP Manager
Browse the rest: Every ability, by category