buddyboss/get-media returns a single media item with its owner, privacy, container and URL.
The group is reported alongside the privacy value, deliberately.
At a glance
| Ability | buddyboss/get-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
An item inside a group takes the group’s visibility whatever its own privacy field holds. A photo marked public, in a private group, is visible to that group and nobody else.
Reading the privacy field at face value therefore produces a wrong answer in the direction that matters — it looks more exposed than it is, or, on a public group with an item marked private, less.
So the group comes back with the item, and the two together are the actual visibility.
The URL is the file itself. Whether it is reachable without being logged in depends on how the site serves uploads rather than on BuddyBoss’s privacy model, which is a separate question worth not conflating.
Pass the same type you would to the listing — photo, document or video.
Input
| Name | Type | Required | What it is |
|---|---|---|---|
media_id | integer | Yes | The media item. |
type | string | Yes | photo, document or video. |
What comes back
| Name | Type | What it is |
|---|---|---|
media | object | Owner, privacy, container and URL. |
group | object | The group, when the item belongs to one. It governs visibility. |
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:
Who can see this photo?
It resolves to one call:
{
"ability": "buddyboss/get-media",
"parameters": {
"media_id": 880,
"type": "photo"
}
}Worth knowing
- A group item takes the group’s visibility, not its own privacy value.
- The two fields together are the real answer.
- File reachability depends on how uploads are served, separately from this.
- Read-only.
Related abilities
- BuddyBoss Manage Media — change privacy or move it
- BuddyBoss List Media — find the ID
Get the plugins:
AcrossAI Abilities Manager · AcrossAI MCP Manager
Browse the rest: Every ability, by category