# Confluent | the Data Streaming Platform User Notifications (notifications/v1) API

**Canonical:** https://apis.io/apis/confluent-the-data-streaming-platform/confluent-the-data-streaming-platform-user-notifications-notifications-v1-api/  
**Provider:** Confluent | the Data Streaming Platform — https://apis.io/providers/confluent-the-data-streaming-platform/  
**Base URL:** https://api.confluent.cloud  
**Documentation:** https://docs.confluent.io/cloud/current/api.html

Confluent | the Data Streaming Platform User Notifications (notifications/v1) API is one of 121 APIs that [Confluent | the Data Streaming Platform](https://apis.io/providers/confluent-the-data-streaming-platform/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include User Notifications (notifications/v1). The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

[![Early Access](https://img.shields.io/badge/Lifecycle%20Stage-Early%20Access-%2345c6e8)](#section/Versioning/API-Lifecycle-Policy) [![Request Access To User Notifications API v1](https://img.shields.io/badge/-Request%20Access%20To%20User%20Notifications%20API%20v1-%23bc8540)](mailto:ccloud-api-access+notifications-v1-early-access@confluent.io?subject=Request%20to%20join%20notifications/v1%20API%20Early%20Access&body=I%E2%80%99d%20like%20to%20join%20the%20Confluent%20Cloud%20API%20Early%20Access%20for%20notifications/v1%20to%20provide%20early%20feedback%21%20My%20Cloud%20Organization%20ID%20is%20%3Cretrieve%20from%20https%3A//confluent.cloud/settings/billing/payment%3E.) `UserNotification` objects represent in-app notifications scoped to a specific Confluent Cloud user. Each notification carries a severity, references the Confluent Cloud resource it relates to, and tracks whether the user has read it. This API lets you list and retrieve your notifications, mark notifications as read or unread, and fetch an unread-count summary. `read` is the only mutable field on this resource; `PATCH` requests with values for other fields will have those values silently ignored. Two `PATCH` shapes are supported: - `PATCH /user-notifications/{id}` — update a single notification by id. - `PATCH /user-notifications` — update the read state of every notification matching the supplied filter query parameters. The body is a narrow payload (`{ "read": true | false }`) and the same filters accepted by the list endpoint scope which notifications are updated (with the exception of `include`, which is a list-only partial-response selector). The heavier `integrations` and `recommended_actions` fields are populated on single-resource reads (`GET /user-notifications/{id}`) and omitted from list responses by default to keep collection payloads slim. Use the `include` query parameter on the list endpoint to opt in to populating these fields (`?include=integrations,recommended_actions`). Related guide: [Cloud Notifications](https://docs.confluent.io/cloud/current/monitoring/configure-notifications.html#notifications-for-ccloud). ## The User Notifications Model <SchemaDefinition schemaRef="#/components/schemas/notifications.v1.UserNotification" />

## Operations (5)

| Method | Path | Summary |
|---|---|---|
| GET | `/notifications/v1/user-notifications` | List of User Notifications |
| GET | `/notifications/v1/user-notifications/{id}` | Read a User Notification |
| PATCH | `/notifications/v1/user-notifications/{id}` | Update a User Notification |
| PATCH | `/notifications/v1/user-notifications:mark-all` | Mark multiple notifications read or unread |
| GET | `/notifications/v1/user-notifications:summary` | Get notification summary |

## Machine-readable artifacts (5)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/confluent-the-data-streaming-platform/refs/heads/main/openapi/confluent-the-data-streaming-platform-user-notifications-notifications-v1-api-openapi.yml
- **Documentation** — https://docs.confluent.io/cloud/current/api.html
- **APIReference** — https://docs.confluent.io/cloud/current/api.html
- **ToolCrosswalk** — https://raw.githubusercontent.com/api-evangelist/confluent-the-data-streaming-platform/refs/heads/main/mcp/confluent-the-data-streaming-platform-tool-crosswalk.yml
- **DataModel** — https://raw.githubusercontent.com/api-evangelist/confluent-the-data-streaming-platform/refs/heads/main/data-model/confluent-the-data-streaming-platform-data-model.yml

## Other Confluent | the Data Streaming Platform APIs (12)

- [Confluent Kafka REST API](https://apis.io/apis/confluent-the-data-streaming-platform/kafka-rest-api/)
- [Confluent Schema Registry REST API](https://apis.io/apis/confluent-the-data-streaming-platform/schema-registry-api/)
- [Kafka Connect REST API](https://apis.io/apis/confluent-the-data-streaming-platform/connect-rest-api/)
- [ksqlDB REST API](https://apis.io/apis/confluent-the-data-streaming-platform/ksqldb-rest-api/)
- [Confluent Cloud for Apache Flink REST API](https://apis.io/apis/confluent-the-data-streaming-platform/flink-rest-api/)
- [Confluent | the Data Streaming Platform Access Points (networking/v1) API](https://apis.io/apis/confluent-the-data-streaming-platform/confluent-the-data-streaming-platform-access-points-networking-v1-api/)
- [Confluent | the Data Streaming Platform ACL (v3) API](https://apis.io/apis/confluent-the-data-streaming-platform/confluent-the-data-streaming-platform-acl-v3-api/)
- [Confluent | the Data Streaming Platform Agents (sql/v1) API](https://apis.io/apis/confluent-the-data-streaming-platform/confluent-the-data-streaming-platform-agents-sql-v1-api/)
- [Confluent | the Data Streaming Platform API Keys (iam/v2) API](https://apis.io/apis/confluent-the-data-streaming-platform/confluent-the-data-streaming-platform-api-keys-iam-v2-api/)
- [Confluent | the Data Streaming Platform Applied Quotas (service-quota/v1) API](https://apis.io/apis/confluent-the-data-streaming-platform/confluent-the-data-streaming-platform-applied-quotas-service-quota-v1-api/)
- [Confluent | the Data Streaming Platform Catalog Integrations (tableflow/v1) API](https://apis.io/apis/confluent-the-data-streaming-platform/confluent-the-data-streaming-platform-catalog-integrations-tableflow-v1-api/)
- [Confluent | the Data Streaming Platform Certificate Authorities (iam/v2) API](https://apis.io/apis/confluent-the-data-streaming-platform/confluent-the-data-streaming-platform-certificate-authorities-iam-v2-api/)

## Tags

User Notifications (notifications/v1)

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/confluent-the-data-streaming-platform/confluent-the-data-streaming-platform-user-notifications-notifications-v1-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/confluent-the-data-streaming-platform/.