Welcome

Rooms save notification POST

Sets the notifications settings of specific channel.

URL Requires Auth HTTP Method
/api/v1/rooms.saveNotification yes POST

Payload

Argument Example Required Description
roomId 5of4weEXaH7yncxz9 Required The channel’s id
notifications.desktopNotifications nothing Optional: ‘nothing’, ‘all’, ‘mentions’, ‘default’ The value for desktop notifications
notifications.disableNotifications '0' Optional: ‘0’ or ‘1’ The value to disable/enable channel’s notifications.
notifications.emailNotifications nothing Optional: ‘nothing’, ‘all’, ‘mentions’, ‘default’ The value for email notifications.
notifications.audioNotifications nothing Optional: ‘nothing’, ‘all’, ‘mentions’, ‘default’ The value for audio notifications.
notifications.mobilePushNotifications nothing Optional: ‘nothing’, ‘all’, ‘mentions’, ‘default’ The value for mobile push notifications.
notifications.audioNotificationValue beep Optional The value for audio notification sound.
notifications.desktopNotificationDuration '0' Optional The value for desktop notification duration.
notifications.unreadAlert nothing Optional: ‘nothing’, ‘all’, ‘mentions’, ‘default’ The value for unread alerts notifications.
notifications.hideUnreadStatus '0' Optional: ‘0’ or ‘1’ The value to disable/enable number of unread messages.

Example payload

{
    "roomId": "5of4weEXaH7yncxz9",
    "notifications" :{
        "desktopNotifications": "all",
        "disableNotifications": "0",
        "emailNotifications": "nothing",
        "audioNotificationValue": "beep",
        "desktopNotificationDuration": "2",
        "audioNotifications": "all",
        "unreadAlert": "nothing",
        "hideUnreadStatus": "all",
        "mobilePushNotifications": "mentions"
    }
}

Example Call

curl -H "X-Auth-Token: 9HqLlyZOugoStsXCUfD_0YdwnNnunAJF8V47U3QHXSq" \
     -H "X-User-Id: aobEdbYhXfu5hkeqG" \
     -H "Content-type: application/json" \
     http://localhost:3000/api/v1/rooms.saveNotification \
     -d '{"roomId": "5of4weEXaH7yncxz9", "notifications" :{ "desktopNotifications": "all", "disableNotifications": "0", \
     "emailNotifications": "nothing", "audioNotificationValue": "beep", "desktopNotificationDuration": "2", "audioNotifications": "all", \
       "unreadAlert": "nothing", "hideUnreadStatus": "all", "mobilePushNotifications": "mentions"} }'

Example Result

{
   "success": true
}

Change Log

Version Description
0.63.0 Added