mark_all_notifications_read

Mark every unread entry of the creator's notification centre as read in one call.

Purpose

The bell's "Mark all as read" for agents: every unread entry is marked read in one statement and the tool answers how many it marked. Idempotent: a second call marks nothing and answers 0. Use it when the creator has caught up; to clear one entry use mark_notification_read.

Required ability

account:write

Input schema

{
  "type": "object",
  "properties": {}
}

Output shape

{
  "data": { "marked": 3 },
  "meta": {}
}

Example prompts

"Clear my notifications, I've read them all."

Failure modes

AUTHENTICATION_REQUIRED — no authenticated user on the request.
TOKEN_MISSING_ABILITY — token lacks account:write.

How is this guide?

list_notifications

Read the notification centre of the creator the token acts for — every alert sent to them, newest first, with its class, where it points and whether it was read.

mark_notification_read

Mark one entry of the creator's notification centre as read.