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

**Canonical:** https://apis.io/apis/confluent-the-data-streaming-platform/confluent-the-data-streaming-platform-subscriptions-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 Subscriptions (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 Subscriptions (notifications/v1). The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

[![General Availability](https://img.shields.io/badge/Lifecycle%20Stage-General%20Availability-%2345c6e8)](#section/Versioning/API-Lifecycle-Policy) `Subscription` objects represent the intent of the customers to get notifications of particular types. A subscription is created for a particular `NotificationType` and the user will get notifications on the `Integrations` that are provided while creating the subscription. This API allows you to create, retrieve, and update subscriptions, as well as to view the list of all your subscriptions. You can also delete subscriptions with RECOMMENDED or OPTIONAL notification types. Subscriptions with REQUIRED notification types cannot be deleted. Related guide: [Cloud Notifications](https://docs.confluent.io/cloud/current/monitoring/configure-notifications.html#notifications-for-ccloud). ## The Subscriptions Model <SchemaDefinition schemaRef="#/components/schemas/notifications.v1.Subscription" />

## Operations (5)

| Method | Path | Summary |
|---|---|---|
| GET | `/notifications/v1/subscriptions` | List of Subscriptions |
| POST | `/notifications/v1/subscriptions` | Create a Subscription |
| GET | `/notifications/v1/subscriptions/{id}` | Read a Subscription |
| PATCH | `/notifications/v1/subscriptions/{id}` | Update a Subscription |
| DELETE | `/notifications/v1/subscriptions/{id}` | Delete a Subscription |

## 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-subscriptions-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

Subscriptions (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-subscriptions-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/.