buddyboss/manage-notification changes the state of a member’s notifications: read, unread, or deleted.
The bulk form applies to an entire account in one call.
At a glance
| Ability | buddyboss/manage-notification |
| Toolset | BuddyBoss — toolset/buddyboss |
| Group | BuddyBoss › Notifications & Invites |
| 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 |
Clearing somebody’s badge
The unread badge is the mechanism that brings a member back to a mention, a message or a reply. Marking notifications read on their behalf clears it, and they are not told.
So this is a reliable way to make somebody miss something, and the bulk form does it to every notification they have at once.
There are legitimate uses — clearing a flood from a misconfigured integration, resetting after a test — and they are worth distinguishing from tidying somebody’s account for them.
action=delete removes a notification. Notifications point at content rather than containing any, so the thing it referred to survives — this only removes the pointer.
That makes deletion the least destructive operation with that name in the whole suite, and it is still the one that loses somebody their route back to something.
Idempotent.
Input
| Name | Type | Required | What it is |
|---|---|---|---|
action | string | Yes | read, unread or delete. |
notification_id | integer | For one notification | Which notification. |
user_id | integer | For the bulk form | Whose notifications. |
bulk | boolean | No | Apply to all of that member’s notifications at once. |
What comes back
| Name | Type | What it is |
|---|---|---|
changed | integer | How many notifications changed state. |
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:
Mark this member’s notifications as read.
It resolves to one call:
{
"ability": "buddyboss/manage-notification",
"parameters": {
"action": "read",
"user_id": 44,
"bulk": true
}
}Worth knowing
- The badge is what brings people back. Clearing it removes their prompt.
- The member is not told.
- Deleting removes the pointer, not the content.
- The bulk form applies to a whole account.
Related abilities
- BuddyBoss List Notifications — see what they have
- BuddyBoss Get Account Settings — their preferences
Get the plugins:
AcrossAI Abilities Manager · AcrossAI MCP Manager
Browse the rest: Every ability, by category