---
title: "Mark the alert as viewed, read, or unread"
method: POST
path: "/alerts/{id}/mark"
tags: ["Alerts"]
---

# Mark the alert as viewed, read, or unread

`POST /alerts/{id}/mark`

Mark the alert as viewed, read, or unread. Marking as unviewed is not supported.

## Response `200`

OK

- object
  - `success` boolean

## Other responses

- `default` — Error

## Changes

- **2026-03-18** `e271d0e41f6d` — 2 breaking, 1 warning, 5 info
  - removed the media type `application/json` from the request body
  - the `success` response's property type/format changed from `string`/`` to `boolean`/`` for status `200`
  - deleted the `path` request parameter `id`
  - api operation id `post_alerts_id_mark` removed and replaced with `postAlertsIdMark`
  - …4 more
- **2026-02-03** `fc0a40f3b859` — 2 breaking, 4 warning, 4 info
  - added the new path request parameter `id`
  - the `success` response's property type/format changed from `boolean`/`` to `string`/`` for status `200`
  - the optional response header `XF-Latest-Api-Version` removed for the status `200`
  - the optional response header `XF-Request-User` removed for the status `200`
  - …6 more

[Change history](https://skmtc.dev/xenforo-ltd/apis/xenforo-api/changes/alerts/:id/mark/post.md)

---

[API](https://skmtc.dev/xenforo-ltd/apis/xenforo-api.md) · [All operations](https://skmtc.dev/xenforo-ltd/apis/xenforo-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/xenforo-ltd/xenforo-api/revisions/b15eba33657a/schema)