SaaS Alerts actions & endpoints
Introduction
The Saas Alerts Integration with Rewst delivers a robust set of actions and endpoints for interacting with Saas Alerts. Below is a summary of each section, highlighting the diverse capabilities and opportunities provided through the Saas Alerts Integration:
Actions
Generic Request
SaaS Alerts API Request
GET
<example>.com/<url_path>
Generic action for making authenticated requests against the SaaS Alerts API
Processed Event Webhooks
List Subscriptions Items
GET
<example>.com/outgoingWebhookApi/api/v1/subscriptions
Retrieve list of active subscriptions for current partner
Create Subscription Item
POST
<example>.com/outgoingWebhookApi/api/v1/subscriptions
Create new subscription
List Of Disabled Subscriptions Items
GET
<example>.com/outgoingWebhookApi/api/v1/subscriptions/disabled
Retrieve list of disabled subscriptions for current partner
Delete Subscription Item
DELETE
<example>.com/outgoingWebhookApi/api/v1/subscriptions/{channelId}
Delete subscription
Update Subscription Item
PATCH
<example>.com/outgoingWebhookApi/api/v1/subscriptions/{channelId}
Update new subscription
Authorization Get Apikey
GET
<example>.com/outgoingWebhookApi/api/v1/tools/apiKey
get ApiKey by idToken (This method is used via the Saas Alerts UI.), idToken - issued by 1 hour, apiKey - long life till reset it manually
Authorization Reset Apikey
POST
<example>.com/outgoingWebhookApi/api/v1/tools/apiKey
reset ApiKey by idToken (This method is used via the Saas Alerts UI)
Domain Verification List Of Items
GET
<example>.com/outgoingWebhookApi/api/v1/domains
Get List of verified domains (This method is used via the Saas Alerts UI)
Domain Verification Verify And Add Domain
POST
<example>.com/outgoingWebhookApi/api/v1/domains
validate domain and save it in success case (This method is used via the Saas Alerts UI)
Domain Verification Delete Item
DELETE
<example>.com/outgoingWebhookApi/api/v1/domains/{id}
delete validated domain (This method is used via the Saas Alerts UI)
Get Customers
GET
<example>.com/outgoingWebhookApi/api/v1/misc/customers
Get List of Customers
Get Alert Types
GET
<example>.com/outgoingWebhookApi/api/v1/misc/alertTypes
Get List of Alert Types
Subscription Test Event
POST
<example>.com/outgoingWebhookApi/api/v1/misc/sendTestEvent
Send Test Event
Queue List Of Unsent Packs
GET
<example>.com/outgoingWebhookApi/api/v1/queue
Retrieve list of unsent packs of events for current partner
Queue List Of Unsent Packs
GET
<example>.com/outgoingWebhookApi/api/v1/queue/channels/{channelId}
Retrieve list of unsent packs of events for current channel
Queue List Of Events
GET
<example>.com/outgoingWebhookApi/api/v1/queue/{queueId}/channels/{channelId}/events
Retrieve list of events for current channel
Queue Delete Item
DELETE
<example>.com/outgoingWebhookApi/api/v1/queue/{queueId}/channels/{channelId}
Delete channel from queue
Processed Events Data
Event Data Query
POST
<example>.com/reportApi/api/v1/reports/events/query
Retrieve events for specific query
Events Count Query
POST
<example>.com/reportApi/api/v1/reports/events/count/query
Retrieve a count of events for a specific query
Raw Event Webhooks
Get Subscriptions
GET
<example>.com/outgoingWebhookRawApi/api/v1/raw/subscriptions
Get a list of Saas Alert subcriptions against the Saas Alerts API
Create Subscription
POST
<example>.com/outgoingWebhookRawApi/api/v1/raw/subscriptions
Create a subscription by channelId against the Saas Alerts API
Get Disabled Subscriptions
GET
<example>.com/outgoingWebhookRawApi/api/v1/raw/subscriptions/disabled
Get a list of disabled SaaS Alert subscriptions.
Update Subscription
PATCH
<example>.com/outgoingWebhookRawApi/api/v1/raw/subscriptions/{channelId}
Update a subscription by channelId against the Saas Alerts API
Delete Subscription
DELETE
<example>.com/outgoingWebhookRawApi/api/v1/raw/subscriptions/{channelId}
Delete a subscription against the Saas Alerts API
Raw Send Test Event
POST
<example>.com/outgoingWebhookRawApi/api/v1/misc/sendTestEvent
Create a debug test event against the Saas Alerts API
Get Endpoints
GET
<example>.com/outgoingWebhookRawApi/api/v1/misc/endpoints/{productType}
Get a list of endpoints based on product type
Get Queues
GET
<example>.com/outgoingWebhookRawApi/api/v1/queue
Get a list of unsent queues against the Saas Alerts API
Get Queues by Channel Id
GET
<example>.com/outgoingWebhookRawApi/api/v1/queue/channels/{channelId}
Get a list of unsent queues by channel id
Get Events for Current Channel
GET
<example>.com/outgoingWebhookRawApi/api/v1/queue/{queueId}/channels/{channelId}/events
Retrieve list of events for current channel
Delete a Channel
DELETE
<example>.com/outgoingWebhookRawApi/api/v1/queue/{queueId}/channels/{channelId}
Queue - Delete a channel
Reports
Get Scheduled Reports
GET
<example>.com/reportApi/api/v1/reports/scheduled-report
Retrieve all the scheduled reports of the partner
Add Scheduled Report
POST
<example>.com/reportApi/api/v1/reports/scheduled-report
Add a scheduled report to the database
Get Scheduled Report by Id
GET
<example>.com/reportApi/api/v1/reports/scheduled-report/{scheduledReportId}
Retrieve a scheduled report by scheduledReportId
Delete Scheduled Report
DELETE
<example>.com/reportApi/api/v1/reports/scheduled-report/{scheduledReportId}
Delete scheduled report by scheduledReportId
Send Email Mailgun
POST
<example>.com/reportApi/api/v1/reports/send-email
Send email via mailgun
Get Partner Info
GET
<example>.com/reportApi/api/v1/reports/partners/profile
Retrieve Partner Profile information Name, Address. Phone…etc
Get MSP User Info
GET
<example>.com/reportApi/api/v1/reports/msp-user
Retrieve MSP User Information ID, Name, Email, Role, PartnerId
Get Customer by Id
GET
<example>.com/reportApi/api/v1/reports/customers/{id}
Retrieve customer by customer id
Get List of Customers
GET
<example>.com/reportApi/api/v1/reports/customers
Retrieve a list of customers for the authenticated partner