buddyboss/manage-document organises documents that already exist: moves them between folders, renames them, changes their privacy.
Moving a document can change who can see it even when you do not touch the privacy field.
At a glance
| Ability | buddyboss/manage-document |
| 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 |
Folders propagate
Folders push their privacy and their group down to what is inside them. So a document moved into a public folder becomes public, and one moved into a group’s folder becomes that group’s.
That happens on the move, without the privacy field being mentioned in the call — which makes a move an access-control change wearing the clothes of a tidy-up.
Checking the destination with buddyboss/manage-folder first is how you avoid that, and it is the step most likely to be skipped.
Uploading is not possible here, for the same reason as photos: BuddyBoss needs a binary multipart upload that a JSON call cannot perform.
Photos and videos are handled by buddyboss/manage-media, which uses flat albums rather than nesting folders — the two systems look similar and behave differently, and the propagation is the difference.
Idempotent.
Input
| Name | Type | Required | What it is |
|---|---|---|---|
document_id | integer | Yes | The document. |
folder_id | integer | No | Move it into this folder. The folder’s privacy and group apply. |
privacy | string | No | New privacy, where the folder does not override it. |
title | string | No | Rename it. |
What comes back
| Name | Type | What it is |
|---|---|---|
document | object | The document 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:
Move that document into the handbook folder.
It resolves to one call:
{
"ability": "buddyboss/manage-document",
"parameters": {
"document_id": 901,
"folder_id": 22
}
}Worth knowing
- A move changes visibility, because folders propagate privacy and group.
- Check the destination folder first.
- Uploading is not possible from a JSON call.
- Photos and videos use flat albums and a different ability.
Related abilities
- BuddyBoss Manage Document Folder — check the destination
- BuddyBoss List Media — find documents
Get the plugins:
AcrossAI Abilities Manager · AcrossAI MCP Manager
Browse the rest: Every ability, by category