> ## Documentation Index
> Fetch the complete documentation index at: https://handbook.nyotaimara.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Mark In-App Notifications as Read: One or Bulk All

> PATCH /v1/notifications/:id/read marks a specific notification read. PATCH /v1/notifications/read-all clears all unread notifications in one request.

Two endpoints are available for marking notifications as read: one for a specific notification by ID, and one that clears all unread notifications at once. Both require only an `Authorization` header — no request body is needed.

***

## Mark a single notification as read

```
PATCH /v1/notifications/:id/read
```

Marks one notification as read. Scoped to the authenticated user — users cannot mark another user's notifications.

### Headers

<ParamField header="Authorization" type="string" required>
  Bearer token. Format: `Bearer <token>`
</ParamField>

### Path parameters

<ParamField path="id" type="string" required>
  The ID of the notification to mark as read.
</ParamField>

### Response

<ResponseField name="success" type="boolean">
  `true` on a successful update.
</ResponseField>

### Example

```bash theme={null}
curl --request PATCH \
  --url https://api.nyotaimara.com/v1/notifications/ntf_01j9.../read \
  --header 'Authorization: Bearer <token>'
```

```json theme={null}
{
  "success": true
}
```

***

## Mark all notifications as read

```
PATCH /v1/notifications/read-all
```

Marks every unread notification for the authenticated user as read in a single operation. Useful for a "mark all as read" button.

### Headers

<ParamField header="Authorization" type="string" required>
  Bearer token. Format: `Bearer <token>`
</ParamField>

### Response

<ResponseField name="success" type="boolean">
  `true` once all notifications have been updated.
</ResponseField>

### Example

```bash theme={null}
curl --request PATCH \
  --url https://api.nyotaimara.com/v1/notifications/read-all \
  --header 'Authorization: Bearer <token>'
```

```json theme={null}
{
  "success": true
}
```