Notifications

Endpoints related to receiving hub notifications.

Hub Notification Pipeline Auth

Initializes authorization for the Hub notification pipeline. The Hub notification pipeline is a one-way streaming websocket that sends real-time 'notifications' as things are happening on the Hub. These notifications tell some basic information about an event, and it is up to the user to fetch additional details, if deemed necessary.

Requesting this endpoint without a ?token=<token> URL parameter will result in receiving a short lived token in the response body. That token can then be applied to the URL parameter to the same endpoint to upgrade the connection to a WebSocket.

Requires the apionly-notifications-listen capability.

SecuritybearerAuth and hubAuth
Responses
101

WebSocket protocol upgrade response, connection is upgraded to WebSocket.

200

Returns the credentials necessary for upgrading this connection into a web socket.

default

General error response from the platform

get/v1/hubs/current/notifications
Response samples
application/json
{
  • "data": {
    }
}