buddyboss/manage-topic creates a topic in a forum or updates an existing one: title, body, forum, author, status and tags.
It writes what a topic says. buddyboss/act-on-topic changes what state it is in.
At a glance
| Ability | buddyboss/manage-topic |
| Toolset | BuddyBoss — toolset/buddyboss |
| Group | BuddyBoss › Forums |
| 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
Topics are always attributed to the account running this. BuddyBoss strips the author field from its write routes, so a topic cannot be posted on behalf of another member — which is worth knowing before planning anything that assumes otherwise.
That is a genuine limitation rather than a choice made here, and the alternative would be writing the post type directly and bypassing bbPress’s own handling.
Topics cannot be created in a forum marked as a category. bbPress treats categories as containers and rejects them, so this checks before writing rather than letting the request fail obscurely — buddyboss/list-forums reports which forums are categories.
The split between this and buddyboss/act-on-topic is deliberate: content and state are different operations with different risks, and combining them would mean a content edit could accidentally close a topic.
Idempotent.
Input
| Name | Type | Required | What it is |
|---|---|---|---|
action | string | Yes | create or update. |
topic_id | integer | For update | Which topic. |
forum_id | integer | For create | The forum. Cannot be one marked as a category. |
title | string | For create | The topic title. |
content | string | For create | The topic body. |
tags | array | No | Topic tags. |
What comes back
| Name | Type | What it is |
|---|---|---|
topic | object | The topic 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:
Post a new topic in the support forum.
It resolves to one call:
{
"ability": "buddyboss/manage-topic",
"parameters": {
"action": "create",
"forum_id": 8,
"title": "Scheduled maintenance on Monday",
"content": "The site will be unavailable between 02:00 and 04:00."
}
}Worth knowing
- Always attributed to the account running it. BuddyBoss strips the author field.
- Categories reject topics — the check happens before the write.
- State changes are a separate ability, on purpose.
- Idempotent.
Related abilities
- BuddyBoss Act On Topic — close, sticky or spam it
- BuddyBoss List Forums — which forums accept topics
- BuddyBoss Manage Reply — reply to it
Get the plugins:
AcrossAI Abilities Manager · AcrossAI MCP Manager
Browse the rest: Every ability, by category