Alerts5

Attachments8

Auth3

Conversations15

Featured content1

Forums3

Index1

Me6

Media10

Media albums8

Media categories7

Media comments6

Nodes6

OAuth24

oEmbed1

Posts7

Profile posts11

Resource categories7

Resource reviews6

Resource updates4

Resource versions4

Resources10

Search4

Search forums2

Stats1

Threads12

Users10

Alerts

Mark all alerts as read or viewed

Changed on Mar 18, 2026

Mark all alerts as read or viewed. Must specify "read" or "viewed" parameters.

post/alerts/mark-all

Request

Base URL
https://example.com/api
Auth
- OAuth 2
  Authorization codehttps://example.com/oauth2/authorize
  Token URLhttps://example.com/api/oauth2/token
  Scopesalert:read
- or API key in header XF-Api-Key
TypeScript
https://skmtc.dev/xenforo-ltd/apis/xenforo-api/docs/alerts/mark-all/post.ts
A function with typed inputs. Its response is checked against the schema.

Request body application/x-www-form-urlencoded

readboolean

If specified, marks all alerts as read.

viewedboolean

If specified, marks all alerts as viewed. This will remove the alert counter but keep unactioned alerts highlighted.

Response

OK

successboolean

Changes

Mar 18, 2026e271d0e41f6d Revision changes
- breaking
  removed the media type application/json from the request body
- breaking
  the response's property type changed from string to boolean for status
- info
  api operation id post_alerts_mark_all removed and replaced with postAlertsMarkAll
- info
  the endpoint scheme security XF-Api-Key was added to the API
- info
  the endpoint scheme security XF-OAuth2 was added to the API
- info
  added the new optional header request parameter XF-Api-User to all path's operations
- info
  added the new optional query request parameter api_bypass_permissions to all path's operations
Feb 3, 2026fc0a40f3b859 Revision changes
- breaking
  the response's property type changed from boolean to string for status
- warning
  the optional response header XF-Latest-Api-Version removed for the status 200
- warning
  the optional response header XF-Request-User removed for the status 200
- warning
  the optional response header XF-Request-User-Extras removed for the status 200
- warning
  the optional response header XF-Used-Api-Version removed for the status 200
- info
  api operation id postAlertsMarkAll removed and replaced with post_alerts_mark_all
- info
  the endpoint scheme security XF-Api-Key was removed from the API
- info
  the endpoint scheme security XF-OAuth2 was removed from the API
- info
  added the media type application/json to the request body

Operation history