Overview

Provides an interface to the notification service.

Version information

Version : 0.9.142 (BETA)

License information

URI scheme

Schemes : HTTPS

Consumes

  • application/json

Produces

  • application/json

Paths

CreateOrUpdateAccountMetadata

POST /api/v1/notification/createOrUpdateAccountMetadata

Description

Creates or Updates Account metadata, such as allowed domains list for the Account.

Parameters

Type Name Schema

Body

input
required

Responses

HTTP Code Description Schema

200

Expected response to a valid request.

default

The default response on an error.

CreateOrUpdateDistributionList

POST /api/v1/notification/createOrUpdateDistributionList

Description

Creates or updates a distribution list with the given preferences.

Parameters

Type Name Schema

Body

input
required

Responses

HTTP Code Description Schema

200

Expected response to a valid request.

default

The default response on an error.

CreateOrUpdateResourceSubscription

POST /api/v1/notification/createOrUpdateResourceSubscription

Description

Creates or Updates the subscription with events and channel preferences provided by user.

Parameters

Type Name Schema

Body

input
required

Responses

HTTP Code Description Schema

200

Expected response to a valid request.

default

The default response on an error.

DeleteAllSubscriptionsForResource

POST /api/v1/notification/deleteAllSubscriptionsForResource

Description

Deletes Resource subscription by resource or user CRN.

Parameters

Type Name Schema

Body

input
required

Responses

HTTP Code Description Schema

200

Expected response to a valid request.

default

The default response on an error.

API endpoint used to delete app registration

POST /api/v1/notification/deleteAppRegistration

Description

Used to delete App Registration.

Parameters

Type Name Schema

Body

input
required

Responses

HTTP Code Description Schema

200

Expected response to a valid request.

default

The default response on an error.

DeleteDistributionList

POST /api/v1/notification/deleteDistributionList

Description

Deletes a distribution list.

Parameters

Type Name Schema

Body

input
required

Responses

HTTP Code Description Schema

200

Expected response to a valid request.

default

The default response on an error.

DeleteDistributionListsForResource

POST /api/v1/notification/deleteDistributionListsForResource

Description

Deletes distribution lists for the resource CRN.

Parameters

Type Name Schema

Body

input
required

Responses

HTTP Code Description Schema

200

Expected response to a valid request.

default

The default response on an error.

DeleteResourceSubscription

POST /api/v1/notification/deleteResourceSubscription

Description

Deletes user subscription for the resourceCrn.

Parameters

Type Name Schema

Body

input
required

Responses

HTTP Code Description Schema

200

Expected response to a valid request.

default

The default response on an error.

DeleteResourceSubscriptionsForResource

POST /api/v1/notification/deleteResourceSubscriptionsForResource

Description

Deletes Resource subscription by resource or user CRN.

Parameters

Type Name Schema

Body

input
required

Responses

HTTP Code Description Schema

200

Expected response to a valid request.

default

The default response on an error.

GetAccountMetadata

POST /api/v1/notification/getAccountMetadata

Description

Fetches the Account metadata such as allowed email domains.

Parameters

Type Name Schema

Body

input
required

Responses

HTTP Code Description Schema

200

Expected response to a valid request.

default

The default response on an error.

API endpoint to get AppRegistrationStatus

POST /api/v1/notification/getAppRegistrationStatus

Description

Fetches the app registration status for the tenant.

Parameters

Type Name Schema

Body

input
required

Responses

HTTP Code Description Schema

200

Expected response to a valid request.

default

The default response on an error.

GetDistributionList

POST /api/v1/notification/getDistributionList

Description

Fetches an existing distribution list with events and channel preferences.

Parameters

Type Name Schema

Body

input
required

Responses

HTTP Code Description Schema

200

Expected response to a valid request.

default

The default response on an error.

GetOAuthURL

POST /api/v1/notification/getOAuthUrl

Description

Fetches the OAuth Request Url for the App Integrations.

Parameters

Type Name Schema

Body

input
required

Responses

HTTP Code Description Schema

200

Expected response to a valid request.

default

The default response on an error.

GetResourceSubscription

POST /api/v1/notification/getResourceSubscription

Description

Fetches existing resource subscription with events and channel preferences.

Parameters

Type Name Schema

Body

input
required

Responses

HTTP Code Description Schema

200

Expected response to a valid request.

default

The default response on an error.

ListDistributionLists

POST /api/v1/notification/listDistributionLists

Description

Lists all distribution lists.

Parameters

Type Name Schema

Body

input
required

Responses

HTTP Code Description Schema

200

Expected response to a valid request.

default

The default response on an error.

Lists all the types of resource events available in the catalog.

POST /api/v1/notification/listResourceEventCatalog

Description

Lists all the types of resource events available in the catalog.

Parameters

Type Name Schema

Body

input
required

Responses

HTTP Code Description Schema

200

Expected response to a valid request.

default

The default response on an error.

ListResourceSubscriptions

POST /api/v1/notification/listResourceSubscriptions

Description

Lists all resource subscriptions for a user.

Parameters

Type Name Schema

Body

input
required

Responses

HTTP Code Description Schema

200

Expected response to a valid request.

default

The default response on an error.

API endpoint to get UpdateAppAuthorizationCode

POST /api/v1/notification/updateAppAuthorizationCode

Description

Registers/Updates the App temporary authorization code with the Notification Service.

Parameters

Type Name Schema

Body

input
required

Responses

HTTP Code Description Schema

200

Expected response to a valid request.

default

The default response on an error.

Definitions

ChannelType

Represents the types of channels.

Type : enum (UNKNOWN, EMAIL, IN_APP, SLACK)

CreateOrUpdateAccountMetadataRequest

Request object for the CreateOrUpdateAccountMetadata.

Name Description Schema

allowedDomains
optional

The list of allowed domains for the Account.

< string > array

CreateOrUpdateAccountMetadataResponse

Response object for the CreateOrUpdateAccountMetadata.

Type : object

CreateOrUpdateDistributionListRequest

Request object to create or update a distribution list.

Name Description Schema

distributionListId
optional

Optional identifier of an existing distribution list, if specified, is used for an update.

string

distributionListManagementType
required

SYSTEM_MANAGED: Created by internal actors, modifiable only by internal users. USER_MANAGED: Created by non-internal actors, modifiable by internal or external users

string

emailAddresses
optional

List of recipient email addresses.

< string > array

eventChannelPreferences
optional

Channel preference for individual events to be subscribed to, does not require notification type.

parentResourceCrn
optional

Parent resource crn for which the resource authorization has to be done.

string

resourceCrn
required

CRN of resource to create a topic for.

string

resourceName
required

The name of the resource to be subscribed.

string

slackChannelIds
optional

List of recipient Slack channel identifiers.

< string > array

CreateOrUpdateDistributionListResponse

Response object for creating or updating the distribution list.

Name Description Schema

distributionListDetails
optional

Contains details of the distribution lists created or updated.

CreateOrUpdateResourceSubscriptionRequest

CreateOrUpdateResourceSubscriptionRequest holds the fields required to create new subscription.

Name Description Schema

eventChannelPreferences
optional

Channel preference for the individual events.

existingSubscriptionId
optional

Existing subscription identifier, an optional parameter to be passed when updating the existing subscription.

string

parentResourceCrn
optional

Parent resource crn for which the resource authorization has to be done.

string

resourceCrn
optional

CRN of resource for which user want to subscribe.

string

CreateOrUpdateResourceSubscriptionResponse

CreateOrUpdateResourceSubscriptionResponse is response for subscription creation.

Name Description Schema

subscriptionDetails
optional

Contains details of the subscription created.

DeleteAllSubscriptionsForResourceRequest

Request object for the deletion of all subscriptions by resourceCrn.

Name Description Schema

resourceCrn
required

CRN of the resource for which all associated resource subscriptions must be deleted.

string

DeleteAllSubscriptionsForResourceResponse

Response object for the deletion of all subscriptions by resourceCrn.

Name Description Schema

recordsDeleted
optional

Response string which describes the number of records deleted.

string

DeleteAppRegistrationRequest

Request object for deleting the App registration

Name Description Schema

notificationType
optional

Notification identifier for the apps

DeleteAppRegistrationResponse

Response object for deleting the App registration

Type : object

DeleteDistributionListRequest

The request object for deleting a distribution list.

Name Description Schema

distributionListId
required

The identifier of the distribution list to be deleted.

string

DeleteDistributionListResponse

The response object for deleting a distribution list.

Type : object

DeleteDistributionListsForResourceRequest

Request object for the deletion of Distribution List by resourceCrn.

Name Description Schema

resourceCrn
required

CRN of resource for which the resource subscriptions has to be delete.

string

DeleteDistributionListsForResourceResponse

Response object for the deletion of Distribution List by resourceCrn.

Name Description Schema

recordsDeleted
optional

Response string which describes the number of records deleted.

string

DeleteResourceSubscriptionRequest

DeleteResourceSubscriptionRequest holds the fields required to delete any existing subscription.

Name Description Schema

subscriptionId
required

The subscription identifier of the subscription to be deleted for the user.

string

DeleteResourceSubscriptionResponse

The response object for deleteResourceSubscription.

Type : object

DeleteResourceSubscriptionsForResourceRequest

Request object for the deletion of Subscriptions.

Name Description Schema

resourceCrn
required

CRN of resource for which the resource subscriptions has to be delete.

string

DeleteResourceSubscriptionsForResourceResponse

Response object for the deletion of Subscriptions.

Name Description Schema

recordsDeleted
optional

Response string which describes the number of records deleted.

string

DistributionList

The list of distribution lists.

Name Description Schema

distributionListId
optional

The distribution list identifier.

string

distributionListManagementType
optional

Attribute to identify system vs user managed distribution list.

emailAddresses
optional

The list of email addresses if configured.

< string > array

parentResourceCrn
optional

CRN of the parent resource of the Distribution List’s resource.

string

resourceCrn
optional

CRN of resource the group has subscribed to.

string

resourceName
optional

The name of the resource to be subscribed.

string

resourceType
optional

Type of resource. This should be service name as represented in a CRN.

string

slackChannelIds
optional

The list of Slack channel ids configured.

< string > array

subscribedEvents
optional

List of all events subscribed under the given resource.

< SubscribedEvents > array

DistributionListDetails

Details of the distribution list.

Name Description Schema

distributionListId
optional

Identifier of the distribution list.

string

resourceCrn
optional

The resourceCrn of the subscription.

string

DistributionListManagementType

Represents the management types of distribution list.

Type : enum (USER_MANAGED, SYSTEM_MANAGED)

Error

An object returned on an error.

Name Description Schema

code
optional

The error code.

string

message
optional

The error message.

string

EventCatalog

The details of the events present in the event catalog.

Name Description Schema

eventDescription
optional

Description of the event in the catalog.

string

eventName
optional

Name of the event in the catalog.

string

eventSeverityLists
optional

List of severity for the catalog.

< string > array

eventTypeId
optional

ID of the event in the catalog.

string

targetedEventType
optional

Type of the targeted event. Either user_targeted or resource_targeted.

EventChannelPreference

EventChannelPreference contains event identifier and its channel preference.

Name Description Schema

channels
optional

The channel preference for the event where the event notification has to be delivered. e.g.: IN_APP, EMAIL

< ChannelType > array

eventSeverityLists
optional

The chosen severity list for the particular event.

< string > array

eventTypeId
optional

The event identifier.

string

GetAccountMetadataRequest

Request object for fetching the Account metadata.

Type : object

GetAccountMetadataResponse

Response object for the GetAccountMetadata.

Name Description Schema

allowedDomains
optional

Get allowed domains for the Account.

< string > array

GetAppRegistrationStatusRequest

Request object to for GetAppRegistrationStatus

Name Description Schema

notificationType
optional

Notification identifier for the apps

GetAppRegistrationStatusResponse

Response object to for GetAppRegistrationStatus

Name Description Schema

appRegistrationStatus
optional

The App app registration status for the tenant.

string

GetDistributionListRequest

Request object for fetching a distribution list.

Name Description Schema

distributionListId
required

The identifier for which the distribution list is requested.

string

GetDistributionListResponse

Response object for the GetDistributionList.

Name Description Schema

distributionList
optional

Contains details of the distribution list fetched.

GetOAuthUrlRequest

Request object to for GetOAuthUrl

Type : object

GetOAuthUrlResponse

Response object to for GetOAuthUrl

Name Description Schema

requestUrl
optional

OAuth Request url.

string

GetResourceSubscriptionRequest

Request object for the GetResourceSubscription.

Name Description Schema

resourceCrn
required

The resource crn for which the subscription is requested.

string

GetResourceSubscriptionResponse

Response object for the GetResourceSubscription.

Name Description Schema

resourceSubscription
optional

Contains details of the resource subscription fetched.

ListDistributionListsRequest

The request object for listing the distribution lists.

Name Description Schema

distributionListManagementType
optional

The optional distribution list management type, if specified, only distribution lists related to this type will be returned.

string

pageSize
optional

The page size.
Minimum value : 1
Maximum value : 50

integer (int32)

pageToken
optional

A token to specify where to start paginating. This is the nextToken from a previously truncated response.

string

resourceCrn
optional

The optional resource CRN, if specified, only distribution lists related to this resource will be returned.

string

ListDistributionListsResponse

The response object for listing the distribution lists.

Name Description Schema

distributionLists
optional

List of distribution lists.

< DistributionList > array

nextPageToken
optional

The token to use when requesting the next set of results. If not present, there are no additional results.

string

totalSubscriptions
optional

This field represents the total number of resource subscriptions.

integer (int32)

ListResourceEventCatalogRequest

The request object to list all the types of resource events available in the catalog.

Name Description Schema

resourceCrn
required

The resource CRN to which the resource catalog events are associated with.

string

ListResourceEventCatalogResponse

The response object to list all the types of resource events available in the catalog.

Name Description Schema

resourceEvents
optional

List of resource events that the user can potentially subscribe to.

< EventCatalog > array

ListResourceSubscriptionsRequest

The request object for listing the resource subscriptions.

Name Description Schema

pageSize
optional

The page size.
Minimum value : 1
Maximum value : 50

integer (int32)

pageToken
optional

A token to specify where to start paginating. This is the nextToken from a previously truncated response.

string

resourceCrn
optional

The optional resource CRN, if specified, only subscriptions related to this resource will be returned.

string

ListResourceSubscriptionsResponse

The response object for listing the resource subscriptions.

Name Description Schema

nextPageToken
optional

The token to use when requesting the next set of results. If not present, there are no additional results.

string

resourceSubscriptions
optional

List of resource subscriptions for the user.

totalSubscriptions
optional

This field represents the total number of resource subscriptions.

integer (int32)

NotificationAppType

Contains details regarding Notification Type SLACK - default

Type : enum (SLACK)

ResourceSubscription

ResourceSubscription holds a list of subscribed events and delivery details for a particular resource.

Name Description Schema

parentResourceCrn
optional

CRN of the parent resource of the resource for which the notification event is subscribed.

string

resourceCrn
optional

CRN of resource for which the event is subscribed.

string

resourceName
optional

Name of the resource for which the event is scoped to. This should be resource name as represented in a CRN.

string

serviceName
optional

Name of the service for which the event is scoped to. This should be service name as represented in a CRN.

string

subscribedEvents
optional

List of all events subscribed under the given resource.

< SubscribedEvents > array

subscriptionId
optional

The Subscription identifier.

string

SubscribedEvents

Details related to a subscribed event.

Name Description Schema

channels
optional

Subscribed channel preferences of the event.

< ChannelType > array

description
optional

Description of the event.

string

eventName
optional

Name of an event.

string

eventSeverityLists
optional

The list of severity for the event.

< string > array

eventTypeId
optional

ID of an event.

string

SubscriptionDetails

Contains details of the subscription created.

Name Description Schema

resourceCrn
optional

The resourceCrn of the subscription.

string

subscriptionId
optional

Identifier of the newly created subscription.

string

userCrn
optional

The userCrn of the subscription.

string

TargetedEventType

Represents the type of the targeted event.

Type : enum (RESOURCE_TARGETED, USER_TARGETED)

UpdateAppAuthorizationCodeRequest

Request object for getting the temporary authorization code.

Name Description Schema

notificationType
optional

Notification identifier for the apps

temporaryAuthorizationCode
required

The App temporary authorization code which needs to be passed to backend notification service.

string

UpdateAppAuthorizationCodeResponse

Response object for the UpdateAppAuthorizationCode.

Type : object


Copyright © 2025 Cloudera, Inc. All rights reserved.