# Confluent User Notifications (notifications/v1) API

**Canonical:** https://apis.io/apis/confluent/confluent-user-notifications-notifications-v1-api/  
**Provider:** Confluent — https://apis.io/providers/confluent/  
**Base URL:** https://api.confluent.cloud  
**Documentation:** https://www.confluent.io/

Confluent User Notifications (notifications/v1) API is one of 127 APIs that [Confluent](https://apis.io/providers/confluent/) 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 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" />

## Machine-readable artifacts (3)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/confluent/refs/heads/main/openapi/confluent-user-notifications-notifications-v1-api-openapi.yml
- **APIReference** — https://docs.confluent.io/cloud/current/api.html
- **APIReference** — https://api.telemetry.confluent.cloud/docs

## Other Confluent APIs (12)

- [Confluent](https://apis.io/apis/confluent/confluent/)
- [Confluent Managed MCP Servers](https://apis.io/apis/confluent/confluent-mcp/)
- [Confluent ACLs API](https://apis.io/apis/confluent/confluent-acls-api/)
- [Confluent API Keys API](https://apis.io/apis/confluent/confluent-api-keys-api/)
- [Confluent Clusters API](https://apis.io/apis/confluent/confluent-clusters-api/)
- [Confluent Consumer Groups API](https://apis.io/apis/confluent/confluent-consumer-groups-api/)
- [Confluent Environments API](https://apis.io/apis/confluent/confluent-environments-api/)
- [Confluent Partitions API](https://apis.io/apis/confluent/confluent-partitions-api/)
- [Confluent Service Accounts API](https://apis.io/apis/confluent/confluent-service-accounts-api/)
- [Confluent Topics API](https://apis.io/apis/confluent/confluent-topics-api/)
- [Confluent Access Points (networking/v1) API](https://apis.io/apis/confluent/confluent-access-points-networking-v1-api/)
- [Confluent ACL (v3) API](https://apis.io/apis/confluent/confluent-acl-v3-api/)

## Tags

User Notifications (notifications/v1)

---

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