buddyboss/get-topic returns a single discussion topic — title, body, forum, author, status, sticky and closed flags — together with its replies in order.
Set include_replies false for the topic alone.
At a glance
| Ability | buddyboss/get-topic |
| Toolset | BuddyBoss — toolset/buddyboss |
| Group | BuddyBoss › Forums |
| 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
The replies carry the IDs that buddyboss/manage-reply and the reply moderation actions need. There is no separate reply listing, so this is where they come from.
The reply count is the number that matters before restructuring. Merging a topic moves every reply out of it, and splitting moves a reply and everything after it — both irreversible, and both proportional to this count.
The title is also what buddyboss/restructure-topic confirms against, so a read here is the planning step for both operations.
Replies come back in order, which the underlying data does not guarantee for nested replies — a reply can be a reply to a reply, and reading them out of order makes a discussion incomprehensible.
Input
| Name | Type | Required | What it is |
|---|---|---|---|
topic_id | integer | Yes | The topic. |
include_replies | boolean | No — defaults to true | Set false for the topic alone. |
What comes back
| Name | Type | What it is |
|---|---|---|
topic | object | Title, body, forum, author, status and flags. |
replies | array | The replies in order. |
reply_count | integer | How many, which is what a merge would move. |
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:
Show me that support topic and its replies.
It resolves to one call:
{
"ability": "buddyboss/get-topic",
"parameters": {
"topic_id": 1204
}
}Worth knowing
- The only source of reply IDs.
- The reply count is the size of a merge or split.
- The title is what a restructure confirms against.
- Read-only.
Related abilities
- BuddyBoss Manage Reply — act on a reply
- BuddyBoss Restructure Topic — what the count is for
- BuddyBoss Act On Topic — change its state
Get the plugins:
AcrossAI Abilities Manager · AcrossAI MCP Manager
Browse the rest: Every ability, by category