buddyboss/list-media lists uploaded media of one kind — photo, document or video — with IDs, owners, privacy, and the album or folder they sit in.
All three kinds depend on the Media component.
At a glance
| Ability | buddyboss/list-media |
| Toolset | BuddyBoss — toolset/buddyboss |
| Group | BuddyBoss › Media & Documents |
| Requires | AcrossAI Pro, plus BuddyBoss Platform active on the site |
| Capability | manage_options |
| Safety | Read-only — changes nothing |
| Repeatable | Idempotent — running it twice leaves the same result |
| Ships in | AcrossAI Pro 0.9.16 and later |
How it works
BuddyBoss keeps documents and videos switched together with photos, so none of them exist on a site with media turned off. That is worth knowing before concluding a community has no documents.
Filter by user_id, group_id, album_id or folder_id. The last two are mutually exclusive in practice: photos and videos live in flat albums, documents live in nesting folders.
That structural difference is why there are two organising abilities — buddyboss/manage-media for albums and buddyboss/manage-document for folders — rather than one.
The privacy value on a listing row is not the whole answer. An item inside a group takes the group’s visibility whatever its own privacy field says, which buddyboss/get-media reports explicitly.
Input
| Name | Type | Required | What it is |
|---|---|---|---|
type | string | Yes | photo, document or video. |
user_id | integer | No | One member’s media. |
group_id | integer | No | One group’s media. |
album_id | integer | No | One album, for photos and videos. |
folder_id | integer | No | One folder, for documents. |
per_page | integer | No | Rows per page. |
What comes back
| Name | Type | What it is |
|---|---|---|
media | array | Each item with its owner, privacy and container. |
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 documents has this group uploaded?
It resolves to one call:
{
"ability": "buddyboss/list-media",
"parameters": {
"type": "document",
"group_id": 12
}
}Worth knowing
- Documents and videos are switched together with photos. Media off means none of them.
- Albums are flat; folders nest. That is why there are two organising abilities.
- A listing row’s privacy is not the whole answer inside a group.
- Read-only.
Related abilities
- BuddyBoss Get Media — one item, with the group caveat
- BuddyBoss Manage Media — organise photos and videos
- BuddyBoss Manage Document — organise documents
Get the plugins:
AcrossAI Abilities Manager · AcrossAI MCP Manager
Browse the rest: Every ability, by category