# All real-time notification endpoints of Cumulocity

**URL:** <https://community.cumulocity.com/t/all-real-time-notification-endpoints-of-cumulocity/7565>\
**Category:** Forum\
**Tags:** real-time-notifcations, cumulocity\
**Created:** [December 18, 2023, 9:33am UTC](https://community.cumulocity.com/t/all-real-time-notification-endpoints-of-cumulocity/7565 "2023-12-18T09:33:51Z")\
**Posts on this page:** 5\
**Page:** 1

<div class="post-metadata">

**Author:** ![Christian\_Winter1](https://avatars.discourse-cdn.com/v4/letter/c/a9a28c/32.png) [@Christian\_Winter1](https://community.cumulocity.com/u/Christian_Winter1)\
**Post date:** [December 18, 2023, 9:33am UTC](https://community.cumulocity.com/t/all-real-time-notification-endpoints-of-cumulocity/7565/1 "2023-12-18T09:33:52Z")

</div>

What are all available real-time notification endpoints of Cumulocity IoT? What are relevant documentation sources beyond the current [API documentation](https://cumulocity.com/api/core/)?

#### _ **Product/components** used and **version/fix** level:_

Cumulocity IoT – main interest is on the features of the current version 10.18, but I also have a bit of interest in the history. 😉

#### _Detailed explanation of the problem:_

The current [API documentation](https://cumulocity.com/api/core/) knows two endpionts for real-time notifications:

- `/notification/realtime`: General endpoint for all kinds of notifications (alarms, events, managed objects, measurements, operations).
- `/notification/operations`: Special endpoint for operation notifications (providing channels for agents instead of devices).

While reading other documents (older version of the Cumulocity IoT documentation, source code of the client SDK etc.), I came accross various other endpoints, probably mostly deprecated:

- `/cep/realtime`: Is this just a deprecated alternative to `/notification/realtime`?
- `/cep/modules`: If I understand it correctly, this was used with Esper CEL before Apama was integrated into Cumulocity IoT and is not supported any more. Right?
- `/cep/notifications` and `/cep/customnotifications`: I’m not sure what this is/was. Has it been removed? Is there a replacement?
- `/devicecontrol/notifications`: Is this just a deprecated alternative to `/notification/operations`?

Are there any other endpoints I’ve missed, especially something that is not outdated/deprecated?

If someone has knowledge about the listed or other endpoints, I’d be happy to see some comments regarding these endpoints.

I’m aware that there is also the [Notifications 2.0 API](https://cumulocity.com/api/core/#tag/Notification-2.0-API), which uses a different high-level communication procedure compared to real-time notifications (while also supporting WebSockets and MQTT as low-level protocols, but not long-polling). However, this is not in the focus of this question.

---

<div class="post-metadata">

**Author:** ![Stefan\_Witschel](https://dub1.discourse-cdn.com/flex005/user_avatar/community.cumulocity.com/stefan_witschel/32/31955_2.png) [@Stefan\_Witschel](https://community.cumulocity.com/u/Stefan_Witschel)\
**Post date:** [December 18, 2023, 12:26pm UTC](https://community.cumulocity.com/t/all-real-time-notification-endpoints-of-cumulocity/7565/2 "2023-12-18T12:26:26Z")

</div>

What’s the purpose of finding “old” and “deprecated” endpoints which shouldn’t been used anymore?

The two you are mentioned are the two which are currently officially supported.  
Why is Notification 2.0 not in focus of your question?

All CEP endpoints are deprecated and has been partially replaced by `/notification/realtime`.  
For `/cep/modules` and `/cep/notifications` there is no replacement because they were deprecated with Esper CEP.

For `devicecontrol/notifications` it is stated that this has been deprecated and replaced by `/notification/operations`

> **Info:** The old endpoint `/devicecontrol/notifications` is deprecated. Switch your applications to `/notification/operations` if not already done.

---

<div class="post-metadata">

**Author:** ![Christian\_Winter1](https://avatars.discourse-cdn.com/v4/letter/c/a9a28c/32.png) [@Christian\_Winter1](https://community.cumulocity.com/u/Christian_Winter1)\
**Post date:** [December 18, 2023, 12:46pm UTC](https://community.cumulocity.com/t/all-real-time-notification-endpoints-of-cumulocity/7565/3 "2023-12-18T12:46:05Z")

</div>

Thank you, @Stefan_Witschel!  
I was asking about the old endpoints in order to learn whether these are really outdated or whether they still have valid use cases not covered by the new endpoints. Furthermore, my intention was to learn whether there are endpoints I missed so far (the set of endpoints is like islands in an ocean; without a detailed, complete map, you never know whether there’s still something to discover).  
I’ve excluded Notifications 2.0 because it’s a different high-level protocol.  
Best regards,  
Christian

---

<div class="post-metadata">

**Author:** ![Stefan\_Witschel](https://dub1.discourse-cdn.com/flex005/user_avatar/community.cumulocity.com/stefan_witschel/32/31955_2.png) [@Stefan\_Witschel](https://community.cumulocity.com/u/Stefan_Witschel)\
**Post date:** [December 18, 2023, 1:10pm UTC](https://community.cumulocity.com/t/all-real-time-notification-endpoints-of-cumulocity/7565/4 "2023-12-18T13:10:16Z")

</div>

I understand! For the API it is pretty simple, so no need to deeply investigate “old stuff”:  
If they are not documented anymore in the current documentation they shouldn’t been used as they are not supported anymore.

If you dig out old endpoints it could lead to bad architecture or decisions in your implementation.

Notifcation 2.0 is actually the upcoming successor of the current realtime API. Very soon the “old” realtime API will be deprecated and notification 2.0 will succeed it. So I wouldn’t exclude it to get a full picture. Also currently in almost all cases I would use the notification 2.0 API instead the realtime API. It uses a different but much more reliable protocol but for the same purpose the realtime API was designed for.

---

<div class="post-metadata">

**Author:** ![system](https://dub1.discourse-cdn.com/flex005/user_avatar/community.cumulocity.com/system/32/31990_2.png) [@system](https://community.cumulocity.com/u/system)\
**Post date:** [June 15, 2024, 1:11pm UTC](https://community.cumulocity.com/t/all-real-time-notification-endpoints-of-cumulocity/7565/5 "2024-06-15T13:11:08Z")

</div>

Closed on June 15, 2024, 1:11pm UTC

This topic was automatically closed 180 days after the last reply. New replies are no longer allowed.
