Oracle Cloud Infrastructure Notification Data Plane API

The notificationDataPlane API from Oracle Cloud Infrastructure — 9 operation(s) for notificationdataplane.

Documentation GitHub OpenAPI

Operations 12

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 /smsNumbers List SMS numbers for an SMS provider · List sms numbers #

Ask an LLM

“Which SMS numbers are registered with my SMS provider?”

“Can I filter SMS numbers by state or by when they were last updated?”

Tell an agent

List the SMS numbers for SMS provider {smsProviderId}.

Show SMS numbers for provider {smsProviderId} in state {state}.

GET /subscriptions List subscriptions for a compartment or topic · List subscriptions #

Ask an LLM

“Who is subscribed to my notification topic?”

“Can I list all subscriptions in a compartment regardless of topic?”

Tell an agent

List the subscriptions in compartment {compartmentId}.

List the subscriptions on topic {topicId} in compartment {compartmentId}.

POST /subscriptions Subscribe an endpoint to a topic · Create subscription #

Ask an LLM

“How do I subscribe an email address to a notification topic?”

“Which protocols can a topic subscription use, such as email, custom HTTPS or a function?”

Tell an agent

Subscribe {endpoint} to topic {topicId} over {protocol} in compartment {compartmentId}.

Send a confirmation link to email {endpoint} for topic {topicId}, protocol {protocol}, compartment {compartmentId}.

GET /subscriptions/{id}/confirmation Get a subscription's confirmation result · Get confirm subscription #

Ask an LLM

“How do I check the confirmation details of a subscription using its token?”

“What does a subscription's confirmation look like after the endpoint accepts?”

Tell an agent

Get the confirmation details for subscription {id} using token {token} and protocol {protocol}.

Check confirmation of subscription {id} with token {token} over {protocol}.

POST /subscriptions/{id}/resendConfirmation Resend a subscription confirmation · Resend subscription confirmation #

Ask an LLM

“How do I resend the confirmation link for a pending subscription?”

“The subscriber never got the confirmation email, can I send it again?”

Tell an agent

Resend the confirmation for subscription {id}.

Send the subscription confirmation message again for {id}.

GET /subscriptions/{id}/unsubscription Unsubscribe a subscription from its topic · Get unsubscription #

Ask an LLM

“How do I unsubscribe an endpoint from a topic with its unsubscribe token?”

“Can a subscriber opt out of topic messages themselves?”

Tell an agent destructive · confirm first

Unsubscribe subscription {id} using token {token} and protocol {protocol}.

Opt {endpoint} out of subscription {id} with token {token} over {protocol}.

DELETE /subscriptions/{subscriptionId} Delete a subscription · Delete subscription #

Ask an LLM

“How do I delete a subscription as the topic administrator?”

“Can I permanently remove a subscription by its OCID?”

Tell an agent destructive · confirm first

Delete subscription {subscriptionId}.

Remove subscription {subscriptionId} from its topic.

GET /subscriptions/{subscriptionId} Get a subscription's configuration · Get subscription #

Ask an LLM

“Is a particular subscription confirmed or still pending?”

“What delivery policy does a given subscription use?”

Tell an agent

Get subscription {subscriptionId}.

Show the endpoint and status of subscription {subscriptionId}.

PUT /subscriptions/{subscriptionId} Update a subscription's delivery policy · Update subscription #

Ask an LLM

“How do I change the retry delivery policy of a subscription?”

“Can I retag a subscription after it's created?”

Tell an agent

Set the delivery policy of subscription {subscriptionId} to {deliveryPolicy}.

Update the tags on subscription {subscriptionId} to {freeformTags}.

POST /subscriptions/{subscriptionId}/actions/changeCompartment Move a subscription to another compartment · Change subscription compartment #

Ask an LLM

“How do I move a subscription into a different compartment?”

“Can subscriptions be relocated independently of their topic's compartment?”

Tell an agent

Move subscription {subscriptionId} to compartment {compartmentId}.

Relocate subscription {subscriptionId} into compartment {compartmentId}.

POST /subscriptionsPriorConfirmation Create an already-confirmed active subscription · Create subscription prior confirmation #

Ask an LLM

“Can I create a subscription that starts active without sending a confirmation URL?”

“Is there a way to add a pre-confirmed subscriber to a topic?”

Tell an agent

Create a pre-confirmed subscription for {endpoint} on topic {topicId} via {protocol} in compartment {compartmentId}.

Add {endpoint} to topic {topicId} as an active {protocol} subscription in {compartmentId} with no confirmation step.

POST /topics/{topicId}/messages Publish a message to a topic · Publish message #

Ask an LLM

“How do I send a notification message to everyone subscribed to a topic?”

“What is the size limit for a message published to a topic?”

Tell an agent

Publish {body} to topic {topicId}.

Send a message titled {title} with body {body} to topic {topicId}.

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/oracle-cloud:oracle-cloud-notificationdataplane-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

openapi: 3.2.0
info:
  description: 'Use the Notifications API to broadcast messages to distributed components by topic, using a publish-subscribe pattern.

    For information about managing topics, subscriptions, and messages, see the Notifications documentation.'
  title: Notifications Notification Data Plane API
  version: '20181201'
servers:
- url: https://notification.{region}.oraclecloud.com/20181201
tags:


# --- truncated at 32 KB (59 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/oracle-cloud/refs/heads/main/openapi/oracle-cloud-notificationdataplane-api-openapi.yml

Oracle Cloud Infrastructure Notification Data Plane API

Operations 12

Documentation

Specifications

Schemas & Data

Other Resources

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification