Sign in

v1

latestOpenAPI 3.1.02026-07-245531,0212.1 MB
Endpoints Reports

View Alert Report

This report provides details about all alerts generated for MSP customers. Specify the status of the alert to narrow down the data in your report. This filter parameter can have one of the following values:

Yes: To retrieve data for active alerts only. It lists the currently triggered alerts that require your attention.

No: To retrieve data for resolved or deleted alerts only.

This API may be updated without any prior notification. Check the API documentation for the latest updates regularly.

post/msp/reporting/v1/reports/mspEPAlert

Headers

Authorizationstring required

Specify the Bearer access token

Request body

pageTokenstring

Specify the token to access the results on the next page. Keep this field blank for the first request. To view the results on the next page, use the value received in the 'nextPageToken' parameter of the previous response.

Example request

{
  "filters": {
    "filterBy": [
      {
        "fieldName": "lastOccurance",
        "operator": "LT"
      }
    ]
  }
}

Response

Success

lastSyncTimestampstring date-time

The time stamp until which the report data was returned. The time is in the UTC time zone.

filtersobject

Filters applied on the report.

nextPageTokenstring

The token to access the next page of results. This parameter will be empty for the last page of the results. This token is valid for 5 minutes.

Example response

{
  "data": [
    {
      "customerGlobalId": "bde7f8c2-d063-4a4a-9a8f-c2ea5aff42f3-198",
      "accountName": "Druva",
      "customerName": "Druva",
      "entity": "user_iobvl:DESKTOP-514PMN2",
      "alertDetails": "Misconfigured Backup Folder",
      "firstOccurrence": "2022-12-01T13:50:35.369Z",
      "lastOccurrence": "2023-01-01T13:50:35.369Z",
      "active": "No",
      "severity": "Warning"
    }
  ],
  "nextPageToken": "YTBDNDk6Rjk1MmViY1FpTVpBejNFTU9lSWxzUT09OjA="
}