buddyboss/manage-album manages the albums that hold photos and videos: listing, creating, updating and deleting them.
Albums are flat — they contain media but not other albums.
At a glance
| Ability | buddyboss/manage-album |
| 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 |
Deleting an album deletes its contents
The delete action removes an album along with the media inside it, which is why that path requires confirm_item_count to match how many items that is. Photos and videos deleted this way are gone with their files — there is no trash for BuddyBoss media.
How it works
That flatness is the difference from documents, which nest in folders and inherit privacy down the tree. An album has no children to propagate anything to, which makes album operations considerably simpler than folder ones.
It also makes the delete smaller in scope: an album deletion takes the media directly in it and nothing else, whereas a folder deletion takes an entire subtree.
The item count confirmation is still required, because “delete this album” and “delete these forty photos” are the same call and only one of them is what somebody pictures.
Pass group_id to work with a group’s albums rather than a member’s. A group album inherits the group’s visibility, in the same way individual items do.
Idempotent for the non-delete actions.
Input
| Name | Type | Required | What it is |
|---|---|---|---|
action | string | Yes | list, create, update or delete. |
album_id | integer | For update and delete | Which album. |
title | string | For create | The album title. |
group_id | integer | No | Work with a group’s albums. |
privacy | string | No | Album privacy. |
confirm_item_count | integer | For delete | Must match how many items are in the album. |
confirm | boolean | Yes — must be true | The irreversibility gate. Without it the call is refused before anything is touched. |
What comes back
| Name | Type | What it is |
|---|---|---|
album | object | The album after the write. |
items_deleted | integer | How many media items went, on delete. |
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 an album for the conference photos.
It resolves to one call:
{
"ability": "buddyboss/manage-album",
"parameters": {
"action": "create",
"title": "Conference 2026"
}
}Worth knowing
- Albums are flat. Folders nest; albums do not.
- Deleting an album deletes the media in it.
- There is no trash for BuddyBoss media.
- A group album inherits the group’s visibility.
Related abilities
- BuddyBoss Manage Media — move items between albums
- BuddyBoss Manage Document Folder — the nesting equivalent
Get the plugins:
AcrossAI Abilities Manager · AcrossAI MCP Manager
Browse the rest: Every ability, by category