Confluent | the Data Streaming Platform

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

[![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

GitHub OpenAPI

Operations 5

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /notifications/v1/subscriptions List notification subscriptions · List of Subscriptions #
Ask an LLM
“Which notification types am I subscribed to?”
“Can I see all notification subscriptions in my org?”
Tell an agent
List my notification subscriptions.
Show every notification subscription and its integrations.
POST /notifications/v1/subscriptions Subscribe to a notification type · Create a Subscription #
Ask an LLM
“How do I start receiving alerts for a particular notification type?”
“Can I route a notification type to specific integrations?”
Tell an agent
Subscribe to notification type {notification_type} via integrations {integrations}.
Create a subscription for {notification_type}.
GET /notifications/v1/subscriptions/{id} Get a notification subscription · Read a Subscription #
Ask an LLM
“Which integrations does a given subscription deliver to?”
“Can I read one notification subscription by id?”
Tell an agent
Show subscription {id}.
Get the integrations on notification subscription {id}.
PATCH /notifications/v1/subscriptions/{id} Update a notification subscription · Update a Subscription #
Ask an LLM
“Can I change which integrations an existing subscription uses?”
“Is it possible to disable a subscription without deleting it?”
Tell an agent
Update subscription {id} to deliver to {integrations}.
Set subscription {id} to state {current_state}.
DELETE /notifications/v1/subscriptions/{id} Unsubscribe from a notification type · Delete a Subscription #
Ask an LLM
“How do I stop receiving a type of notification?”
“Can I delete a notification subscription?”
Tell an agent destructive · confirm first
Delete subscription {id}.
Unsubscribe by removing notification subscription {id}.

Documentation

📖
Documentation
https://docs.confluent.io/cloud/current/api.html
📖
APIReference
https://docs.confluent.io/cloud/current/api.html

Specifications

⚙
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

Other Resources

🔗
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

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/confluent-the-data-streaming-platform:confluent-the-data-streaming-platform-subscriptions-notifications-v1-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

confluent-the-data-streaming-platform-subscriptions-notifications-v1-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Confluent Cloud Subscriptions (notifications/v1) API
  version: ''
  x-api-id: 46234552-5833-42eb-ba0f-883ad3f70d2b
  x-audience: external-public
  x-logo:
    url: https://assets.confluent.io/m/1661ef5e4ff82d3d/
  description: '# Introduction


    Note


    This documents the collection of Confluent Cloud APIs.'
servers:
- url: https://api.confluent.cloud
  description: Confluent Cloud API
tags:


# --- truncated at 32 KB (49 KB total) ---
# Full source: 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