Notification Unsubscribe Message

Notification Unsubscribe Message - Get

HTTP Request

GET /api/v1/notification/unsubscribe/{id}

Interactive Demo

📋 Description: Unsubscribes a user from notifications associated with the specified ID, ensuring that they no longer receive updates related to that notification.

Parameters

Name	In	Type	Required	Description
id	path	integer(int64)	true	Unique identifier for the resource

Responses

Status	Meaning	Description	Schema
200	OK	OK	ResponseNotificationUnsubscribeMessageDto

Example Responses

{
  "code": "UPDATED",
  "errors": {
    "all": [
      {
        "type": "GENERIC",
        "errorMessage": "string",
        "source": {},
        "field": "string",
        "errorKey": "string"
      }
    ]
  },
  "object": {
    "id": 0,
    "targetId": "string",
    "targetType": "string",
    "topicApplication": "NFS",
    "topicName": "string",
    "topicPriority": "HIGH",
    "topicEnCaption": "string",
    "topicFrCaption": "string",
    "username": "string",
    "action": "SUBSCRIBE"
  }
}

🔐 Authentication: To perform this operation, you must be authenticated by means of one of the following methods: API key

Notification Unsubscribe Message - Update

HTTP Request

PUT /api/v1/notification/unsubscribe/{id}

Interactive Demo

📋 Description: Unsubscribes a user from notifications associated with the specified ID, ensuring that they no longer receive updates related to that notification. This operation is essential for managing user preferences and enhancing the overall user experience.

Parameters

Name	In	Type	Required	Description
id	path	integer(int64)	true	Unique identifier for the resource
body	body	NotificationUnsubscribeMessageDto	true	Request body containing the user ID and reason for unsubscribing from notifications, ensuring proper management of user preferences.

Body Parameters

{
  "id": 0,
  "targetId": "string",
  "targetType": "string",
  "topicApplication": "NFS",
  "topicName": "string",
  "topicPriority": "HIGH",
  "topicEnCaption": "string",
  "topicFrCaption": "string",
  "username": "string",
  "action": "SUBSCRIBE"
}

Responses

Status	Meaning	Description	Schema
200	OK	OK	ResponseNotificationUnsubscribeMessageDto

Example Responses

{
  "code": "UPDATED",
  "errors": {
    "all": [
      {
        "type": "GENERIC",
        "errorMessage": "string",
        "source": {},
        "field": "string",
        "errorKey": "string"
      }
    ]
  },
  "object": {
    "id": 0,
    "targetId": "string",
    "targetType": "string",
    "topicApplication": "NFS",
    "topicName": "string",
    "topicPriority": "HIGH",
    "topicEnCaption": "string",
    "topicFrCaption": "string",
    "username": "string",
    "action": "SUBSCRIBE"
  }
}

🔐 Authentication: To perform this operation, you must be authenticated by means of one of the following methods: API key

Notification Unsubscribe Message - Create Or Update Bulk

HTTP Request

PUT /api/v1/notification/unsubscribe/createOrUpdate/bulk

Interactive Demo

📋 Description: Updates or creates multiple unsubscribe notifications in bulk, allowing businesses to efficiently manage user preferences for notifications. This operation streamlines the process of maintaining accurate communication preferences across large user segments.

Parameters

Name	In	Type	Required	Description
body	body	NotificationUnsubscribeMessageDto	true	Request body containing a list of notification preferences for bulk unsubscribe operations, including user identifiers and subscription details.

Body Parameters

[
  {
    "id": 0,
    "targetId": "string",
    "targetType": "string",
    "topicApplication": "NFS",
    "topicName": "string",
    "topicPriority": "HIGH",
    "topicEnCaption": "string",
    "topicFrCaption": "string",
    "username": "string",
    "action": "SUBSCRIBE"
  }
]

Responses

Status	Meaning	Description	Schema
200	OK	OK	ResponseListNotificationUnsubscribeMessageDto

Example Responses

{
  "code": "UPDATED",
  "errors": {
    "all": [
      {
        "type": "GENERIC",
        "errorMessage": "string",
        "source": {},
        "field": "string",
        "errorKey": "string"
      }
    ]
  },
  "object": [
    {
      "id": 0,
      "targetId": "string",
      "targetType": "string",
      "topicApplication": "NFS",
      "topicName": "string",
      "topicPriority": "HIGH",
      "topicEnCaption": "string",
      "topicFrCaption": "string",
      "username": "string",
      "action": "SUBSCRIBE"
    }
  ]
}

🔐 Authentication: To perform this operation, you must be authenticated by means of one of the following methods: API key

Notification Unsubscribe Message - Create Or Update

HTTP Request

PUT /api/v1/notification/unsubscribe/createOrUpdate

Interactive Demo

📋 Description: Creates or updates a user’s subscription status for notifications, allowing for effective management of communication preferences within the application.

Parameters

Name	In	Type	Required	Description
body	body	NotificationUnsubscribeMessageDto	true	Request body containing the notification subscription details, including user identifiers and subscription preferences, for creating or updating unsubscribe records.

Body Parameters

{
  "id": 0,
  "targetId": "string",
  "targetType": "string",
  "topicApplication": "NFS",
  "topicName": "string",
  "topicPriority": "HIGH",
  "topicEnCaption": "string",
  "topicFrCaption": "string",
  "username": "string",
  "action": "SUBSCRIBE"
}

Responses

Status	Meaning	Description	Schema
200	OK	OK	ResponseNotificationUnsubscribeMessageDto

Example Responses

{
  "code": "UPDATED",
  "errors": {
    "all": [
      {
        "type": "GENERIC",
        "errorMessage": "string",
        "source": {},
        "field": "string",
        "errorKey": "string"
      }
    ]
  },
  "object": {
    "id": 0,
    "targetId": "string",
    "targetType": "string",
    "topicApplication": "NFS",
    "topicName": "string",
    "topicPriority": "HIGH",
    "topicEnCaption": "string",
    "topicFrCaption": "string",
    "username": "string",
    "action": "SUBSCRIBE"
  }
}

🔐 Authentication: To perform this operation, you must be authenticated by means of one of the following methods: API key

Notification Unsubscribe Message - Bulk Update

HTTP Request

PUT /api/v1/notification/unsubscribe/bulk

Interactive Demo

📋 Description: Updates the subscription status for multiple notifications in bulk, allowing users to efficiently manage their notification preferences and reduce unwanted communications.

Parameters

Name	In	Type	Required	Description
body	body	NotificationUnsubscribeMessageDto	true	Request body containing an array of notification identifiers for bulk unsubscription from specified notifications.

Body Parameters

[
  {
    "id": 0,
    "targetId": "string",
    "targetType": "string",
    "topicApplication": "NFS",
    "topicName": "string",
    "topicPriority": "HIGH",
    "topicEnCaption": "string",
    "topicFrCaption": "string",
    "username": "string",
    "action": "SUBSCRIBE"
  }
]

Responses

Status	Meaning	Description	Schema
200	OK	OK	ResponseListNotificationUnsubscribeMessageDto

Example Responses

{
  "code": "UPDATED",
  "errors": {
    "all": [
      {
        "type": "GENERIC",
        "errorMessage": "string",
        "source": {},
        "field": "string",
        "errorKey": "string"
      }
    ]
  },
  "object": [
    {
      "id": 0,
      "targetId": "string",
      "targetType": "string",
      "topicApplication": "NFS",
      "topicName": "string",
      "topicPriority": "HIGH",
      "topicEnCaption": "string",
      "topicFrCaption": "string",
      "username": "string",
      "action": "SUBSCRIBE"
    }
  ]
}

🔐 Authentication: To perform this operation, you must be authenticated by means of one of the following methods: API key

Notification Unsubscribe Message - Search

HTTP Request

POST /api/v1/notification/unsubscribe/search

Interactive Demo

📋 Description: Unsubscribes a user from notifications based on specified search criteria, ensuring that they no longer receive updates that are no longer relevant to their interests.

Parameters

Name	In	Type	Required	Description
page	query	integer	false	Zero-based page index (0..N)
size	query	integer	false	The size of the page to be returned
sort	query	array[string]	false	Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.
body	body	NotificationUnsubscribeMessageDtoFilter	false	Request body containing the user identification details and notification preferences for processing the unsubscribe action.

Default Values

Parameter	Default	Type
page	0	query
size	100	query
sort	["createdAt,ASC"]	query

Parameter Constraints

Parameter	Constraints
page	Min: 0
size	Min: 1

Body Parameters

{
  "idIn": [
    0
  ],
  "idEqual": 0,
  "idLike": "string",
  "createdAtGreaterThanOrEqual": "2019-08-24T14:15:22Z",
  "createdAtLessThanOrEqual": "2019-08-24T14:15:22Z",
  "createdByLike": "string",
  "createdByEqual": "string",
  "modifiedAtGreaterThanOrEqual": "2019-08-24T14:15:22Z",
  "modifiedAtLessThanOrEqual": "2019-08-24T14:15:22Z",
  "modifiedByLike": "string",
  "modifiedByEqual": "string",
  "targetIdEqual": "string",
  "targetIdLike": "string",
  "targetTypeEqual": "string",
  "targetTypeLike": "string"
}

Responses

Status	Meaning	Description	Schema
200	OK	OK	PageNotificationUnsubscribeMessageDto

Example Responses

{
  "totalElements": 0,
  "totalPages": 0,
  "pageable": {
    "paged": true,
    "unpaged": true,
    "pageNumber": 0,
    "pageSize": 0,
    "offset": 0,
    "sort": {
      "unsorted": true,
      "sorted": true,
      "empty": true
    }
  },
  "numberOfElements": 0,
  "size": 0,
  "content": [
    {
      "id": 0,
      "targetId": "string",
      "targetType": "string",
      "topicApplication": "NFS",
      "topicName": "string",
      "topicPriority": "HIGH",
      "topicEnCaption": "string",
      "topicFrCaption": "string",
      "username": "string",
      "action": "SUBSCRIBE"
    }
  ],
  "number": 0,
  "sort": {
    "unsorted": true,
    "sorted": true,
    "empty": true
  },
  "first": true,
  "last": true,
  "empty": true
}

🔐 Authentication: To perform this operation, you must be authenticated by means of one of the following methods: API key

Notification Unsubscribe Message - Find All

HTTP Request

GET /api/v1/notification/unsubscribe

Interactive Demo

📋 Description: Unsubscribes a user from receiving notifications, allowing for better management of communication preferences and enhancing user experience.

Parameters

Name	In	Type	Required	Description
pageable	query	Pageable	true	Indicates whether the response should be paginated, allowing users to manage the volume of notifications returned in the unsubscribe process.

Responses

Status	Meaning	Description	Schema
200	OK	OK	PageNotificationUnsubscribeMessageDto

Example Responses

{
  "totalElements": 0,
  "totalPages": 0,
  "pageable": {
    "paged": true,
    "unpaged": true,
    "pageNumber": 0,
    "pageSize": 0,
    "offset": 0,
    "sort": {
      "unsorted": true,
      "sorted": true,
      "empty": true
    }
  },
  "numberOfElements": 0,
  "size": 0,
  "content": [
    {
      "id": 0,
      "targetId": "string",
      "targetType": "string",
      "topicApplication": "NFS",
      "topicName": "string",
      "topicPriority": "HIGH",
      "topicEnCaption": "string",
      "topicFrCaption": "string",
      "username": "string",
      "action": "SUBSCRIBE"
    }
  ],
  "number": 0,
  "sort": {
    "unsorted": true,
    "sorted": true,
    "empty": true
  },
  "first": true,
  "last": true,
  "empty": true
}

🔐 Authentication: To perform this operation, you must be authenticated by means of one of the following methods: API key

Notification Unsubscribe Message - Unsubscribe

HTTP Request

POST /api/v1/notification/unsubscribe

Interactive Demo

📋 Description: Unsubscribes a user from receiving notifications, ensuring they no longer receive updates related to their preferences. This operation is essential for managing user engagement and maintaining communication preferences.

Parameters

Name	In	Type	Required	Description
body	body	NotificationUnsubscribeMessageDto	true	Request body containing the user identification and notification preferences to process the unsubscription from notifications.

Body Parameters

[
  {
    "id": 0,
    "targetId": "string",
    "targetType": "string",
    "topicApplication": "NFS",
    "topicName": "string",
    "topicPriority": "HIGH",
    "topicEnCaption": "string",
    "topicFrCaption": "string",
    "username": "string",
    "action": "SUBSCRIBE"
  }
]

Responses

Status	Meaning	Description	Schema
200	OK	OK	Inline

Example Responses

[
  {
    "id": 0,
    "subscribeMessage": {
      "id": 0,
      "targetId": "string",
      "targetType": "string",
      "topicApplication": "NFS",
      "topicName": "string",
      "topicPriority": "HIGH",
      "topicEnCaption": "string",
      "topicFrCaption": "string",
      "username": "string",
      "action": "SUBSCRIBE",
      "captionKey": "string",
      "en_message": "string",
      "fr_message": "string",
      "url": "string",
      "parameters": [
        {
          "name": "string",
          "dataType": "NUMBER",
          "value": "string"
        }
      ],
      "onlyAfterNow": true,
      "startTime": "2019-08-24T14:15:22Z",
      "cronExpression": "string",
      "endTime": "2019-08-24T14:15:22Z",
      "content": "string"
    },
    "unsubscribeMessage": {
      "id": 0,
      "targetId": "string",
      "targetType": "string",
      "topicApplication": "NFS",
      "topicName": "string",
      "topicPriority": "HIGH",
      "topicEnCaption": "string",
      "topicFrCaption": "string",
      "username": "string",
      "action": "SUBSCRIBE"
    },
    "scheduledTime": "2019-08-24T14:15:22Z",
    "user": {
      "id": 0,
      "accountId": 0,
      "fullName": "string",
      "firstName": "string",
      "lastName": "string",
      "username": "string",
      "email": "string",
      "accountName": "string",
      "profile": "string"
    },
    "state": "ACTIVE",
    "status": "UNREAD"
  }
]

Response Schema

Status Code 200

Name	Type	Required	Restrictions	Description
anonymous	[NotificationDto]	false	none	[Data transfer object representing a notification that conveys important updates or alerts to users, facilitating timely communication and enhancing user engagement within the application.]
» id	integer(int64)	false	none	Unique identifier for the resource
» subscribeMessage	NotificationSubscribeMessageDto	false	none	Data transfer object representing a subscription request for notifications, enabling users to receive timely updates and alerts relevant to their interests or activities within the platform.
»» id	integer(int64)	false	none	Unique identifier for the resource
»» targetId	string	true	none	Unique identifier for the target
»» targetType	string	true	none	Type of the target
»» topicApplication	string	true	none	Specifies the application topic for which notifications are being subscribed, enabling targeted communication within the system.
»» topicName	string	true	none	Name of the topic
»» topicPriority	string	true	none	Priority of the topic
»» topicEnCaption	string	false	none	Descriptive caption of the topic in English, used to provide clarity and context for notifications related to subscription messages.
»» topicFrCaption	string	false	none	Caption for the French version of the notification topic, used to enhance user engagement in multilingual communication.
»» username	string	true	none	Unique identifier for the user subscribing to notifications, ensuring personalized communication and engagement within the platform.
»» action	string	false	none	Specifies the type of action to be performed in the notification subscription process.
»» captionKey	string	false	none	Key used to retrieve the localized caption for notifications, ensuring effective communication with users in their preferred language.
»» en_message	string	false	none	Contains the English language message for the notification subscription, facilitating clear communication with users.
»» fr_message	string	false	none	Contains the message content for subscription notifications, facilitating effective communication between the system and users.
»» url	string	false	none	Specifies the endpoint URL to which notifications will be sent upon subscription.
»» parameters	[NotificationParameterDto]	false	none	An array of parameters that define the specific criteria for subscribing to notifications within the system.
»»» name	string	false	none	Name of the resource
»»» dataType	string	false	none	Type of the data
»»» value	string	false	none	Represents the specific value associated with a notification parameter, used to customize alerts and communications within the system.
»» onlyAfterNow	boolean	false	none	Indicates whether notifications should only be sent for events occurring after the current time, allowing users to manage their alert preferences effectively.
»» startTime	string(date-time)	false	none	Time of the start
»» cronExpression	string	false	none	Specifies the schedule for recurring notifications in a cron format, enabling precise timing for automated alerts.
»» endTime	string(date-time)	false	none	Time of the end
»» content	string	false	none	Contains the message content for the notification subscription, enabling effective communication with users.
» unsubscribeMessage	NotificationUnsubscribeMessageDto	false	none	Data transfer object representing a user’s request to unsubscribe from notifications, facilitating the management of user preferences and enhancing engagement strategies.
»» id	integer(int64)	false	none	Unique identifier for the resource
»» targetId	string	true	none	Unique identifier for the target
»» targetType	string	true	none	Type of the target
»» topicApplication	string	true	none	Specifies the application topic for which the user wishes to unsubscribe from notifications.
»» topicName	string	true	none	Name of the topic
»» topicPriority	string	true	none	Priority of the topic
»» topicEnCaption	string	false	none	Descriptive label for the topic in English associated with the notification unsubscribe message, facilitating clear communication with users.
»» topicFrCaption	string	false	none	Caption for the topic in French, used to provide localized content for notifications related to user subscriptions.
»» username	string	true	none	Unique identifier for the user opting to unsubscribe from notifications, ensuring accurate processing of subscription preferences.
»» action	string	false	none	Specifies the type of action to be taken in relation to the notification unsubscribe request.
» scheduledTime	string(date-time)	false	none	Time of the scheduled
» user	UserDto	false	none	Data transfer object representing a user profile, encapsulating essential attributes such as user identification, contact information, and role within the organization to facilitate user management and access control.
»» id	integer(int64)	false	none	Unique identifier for the resource
»» accountId	integer(int64)	false	none	Unique identifier for the account
»» fullName	string	false	none	Full name of the resource
»» firstName	string	false	none	Name of the first
»» lastName	string	false	none	Name of the last
»» username	string	true	none	Represents the unique username associated with a user account, essential for authentication and user identification within the system.
»» email	string	false	none	Email address of the user, used for communication and account verification purposes within the system.
»» accountName	string	false	none	Name of the account
»» profile	string	false	none	Represents the user’s profile information, providing essential details for personalized interactions within the application.
» state	string	false	none	Represents the current status of the notification, indicating its progress within the workflow.
» status	string	false	none	Status of the resource

Enumerated Values

Attribute	Value
action	SUBSCRIBE, UNSUBSCRIBE
dataType	CURRENCY, DATE, DATE_TIME, NUMBER, TEXT
state	ACTIVE, DECOMMISSIONED
status	READ, UNREAD
topicApplication	AP, FOS, NFS, SPB, SSB
topicPriority	HIGH, LOW, MEDIUM

🔐 Authentication: To perform this operation, you must be authenticated by means of one of the following methods: API key

---