Skip to content

Mark all your notifications read

POST
/account/notifications/read-all

Marks every unread notification of yours as read, including ones you haven’t loaded, and returns how many it marked.

You need to be signed in; no capability is needed. Without a session cookie or bearer token that identifies you, the answer is 401, whether or not public mode is on. Any request body is ignored.

marked_count is how many notifications this call changed, 0 when it changed none, which can also happen when another call marked them first. The call marks what is unread at the moment the marking itself runs, so one that arrives at that moment can still be unread afterwards. When two calls overlap, each notification is counted by the call that marked it, so one can return all of them and the other 0. Calling again returns 0 unless new notifications have arrived.

The notifications are marked read, not deleted, and each gets the same read time. When any were marked, your cached unread count is cleared. Server errors get a plain-text 500.

How many notifications this call marked read.

object
marked_count
required

How many notifications this call changed from unread to read; 0 when it changed none, for example because none were unread or another call marked them first.

integer format: int64

Authentication required, missing, or invalid

object
error
required

Human-readable error summary

string
Example
the request could not be completed
Example
{
"error": "authentication required: sign in and retry with a valid session or API token"
}