buddyboss/list-topics returns forum topics with their IDs, titles, forum, author, reply count, status and whether they are sticky, closed or spam.
Pass a forum_id for one forum, or omit it for the whole site.
At a glance
| Ability | buddyboss/list-topics |
| 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
Hidden and private topics are included, as an administrator would expect — the same principle that includes hidden forums and hidden groups.
Spam and trashed topics are not, by default. That is the opposite choice from the activity feed and it is the right one here: a spam topic is already out of the forum, whereas a spam activity item is the thing you are usually looking for when moderating.
Pass status to include them, which is how you review what has been removed.
The topic ID is what buddyboss/get-topic, buddyboss/manage-topic, buddyboss/act-on-topic and the reply abilities all need.
Reply counts matter before restructuring. Merging a topic re-parents every reply, and the count is the size of that irreversible operation.
Input
| Name | Type | Required | What it is |
|---|---|---|---|
forum_id | integer | No | One forum’s topics. Omit for the whole site. |
status | string | No | Include spam or trashed topics. |
per_page | integer | No | Rows per page. |
What comes back
| Name | Type | What it is |
|---|---|---|
topics | array | Each topic with its ID, title, forum, author, reply count, status and flags. |
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 topics are in the support forum?
It resolves to one call:
{
"ability": "buddyboss/list-topics",
"parameters": {
"forum_id": 8
}
}Worth knowing
- Hidden and private topics are included; spam and trashed ones are not.
- Pass a status to review what has been removed.
- Reply counts are the size of a merge before you commit to one.
- Read-only.
Related abilities
- BuddyBoss Get Topic — one topic with its replies
- BuddyBoss Act On Topic — close, sticky or spam one
Get the plugins:
AcrossAI Abilities Manager · AcrossAI MCP Manager
Browse the rest: Every ability, by category