---
title: "Update Notification Status"
method: PATCH
path: "/api/v1/notifications/{notification_id}"
tags: ["User APIs", "notifications"]
---

# Update Notification Status

`PATCH /api/v1/notifications/{notification_id}`

Update the status of a notification.

- **notification_id**: The ID of the notification to update
- **status**: The new status (read or archived)

## Path parameters

- `notification_id` string, uuid, required

## Request body

- NotificationUpdate — Schema for updating a notification.
  - `status` 'unread' | 'read' | 'archived', required — Status of a notification.

## Response `200`

Successful Response

- NotificationRead — Schema for reading a notification.
  - `type` 'mcp_nearing_limit' | 'mcp_reached_limit', required — Types of notifications.
  - `title` string, required
  - `body` string, required
  - `data` object, nullable
  - `id` string, uuid, required
  - `user_id` string, uuid, required
  - `status` 'unread' | 'read' | 'archived', required — Status of a notification.
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `created_by` string, nullable
  - `updated_by` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/carbonarc/apis/carbon-arc-client-admin-api.md) · [All operations](https://skmtc.net/carbonarc/apis/carbon-arc-client-admin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/carbonarc/carbon-arc-client-admin-api/revisions/a8ca30023371/schema)