---
title: "Mark specific notifications, or a whole card's, read"
method: POST
path: "/me/notifications/read"
---

# Mark specific notifications, or a whole card's, read

`POST /me/notifications/read`

## Request

- Base URL: `https://craaft.io/api/v1`
- URL: `https://craaft.io/api/v1/me/notifications/read`
- Auth: HTTP bearer

Marking read also marks seen. Send `ids`, `cardId`, or both; at least one is required.

## Request body

- object
  - `ids` string[]: Notification ids to mark read. Unknown or foreign ids are ignored.
  - `cardId` string, uuid: Marks every unread notification on this card read.

## Response `200`

OK

- object
  - `unseen` integer, required

## Other responses

- `400`: Neither `ids` nor `cardId` sent, or more than 200 ids
- `401`: Missing or invalid token

---

[API](https://skmtc.dev/craaft/apis/craaft-api.md) · [All operations](https://skmtc.dev/craaft/apis/craaft-api/llms.txt) · [OpenAPI document](https://skmtc.dev/craaft/apis/craaft-api/revisions/3a1e9d30d7dc?raw)