v1

latestOpenAPI 3.1.02026-07-245531,0212.1 MB

Events

List all MSP level events

Returns the list of events generated at MSP level. For the list of valid event types, see Supported MSP events.

get/msp/v2/events

Query parameters

pageSizeinteger

Specify the number of records you wish to receive in a single API response. The maximum allowed value is 500. Example - 30.

pageTokenstring

Specify the token to access the next page of results. Keep this field blank in the first request. Use the token value received in the previous response's parameter 'nextPageToken'

category'EVENT' | 'AUDIT' | 'ALERT'

Specify the category of events to be included in response.

typestring

Specify the type of events to be included in response. For all valid values of event types, please refer to : <a href="https://developer.druva.com/docs/supported-msp-events">Supported MSP Events</a>. New type of events will be added in the list with time.

syslogSeverity0 | 1 | 2 | 3 | 4 | 5 | 6 | 7

Specify the syslogSeverity of events to be included in response. Specify the severity code as follows:

For Emergency use 0

For Alert (action must be taken immediately) use 1

For Critical (critical conditions) use 2

For Error (error conditions) use 3

For Warning (warning conditions) use 4

For Notice (normal but significant condition) use 5

For Informational (informational messages) use 6

For Debug (debug-level messages) use 7

Headers

Authorizationstring required

Specify the Bearer access token

Response

nextPageTokenstring

The token to access the next page of results. Use the received token value in subsequent request's parameter 'pageToken'.

Example response

{
  "events": [
    {
      "category": "AUDIT",
      "details": {
        "initiatorType": "ADMIN",
        "initiatorId": "221",
        "initiatorName": "initator@admin.com",
        "adminId": "109",
        "oldState": null,
        "newState": {
          "email": "email@example.com",
          "firstName": "John",
          "lastName": "Smith",
          "phone": "12345678910",
          "role": 2,
          "lastLogin": "0001-01-01T00:00:00Z",
          "creatorAdminId": 1,
          "isActive": true
        }
      },
      "feature": "Admin",
      "globalID": "MSP:c8b3866b-aa9e-4a87-a316-133214f7d23f",
      "timeStamp": 1709208497,
      "syslogFacility": 14,
      "syslogSeverity": 6,
      "type": "AdminCreated"
    },
    {
      "category": "ALERT",
      "details": {
        "customerGlobalId": "c8b3866b-aa9e-4a87-a316-133214f7d23f",
        "customerName": "sampleCustomer",
        "productId": 2,
        "tenantId": "133214f7d23f-c8b3866b-4a87-a316-aa9e",
        "description": "SaaS Apps and Endpoints would be removed for sampleCustomer in the next 168 hours",
        "severity": "critical"
      },
      "feature": "Tenant",
      "globalID": "MSP:c8b3866b-aa9e-4a87-a316-133214f7d23f",
      "timeStamp": 1709213497,
      "syslogFacility": 14,
      "syslogSeverity": 1,
      "type": "TenantDeletionInitiated"
    }
  ],
  "nextPageToken": "eyJwYWdlTnVtYmVyIjoyLCJwYWdlU2l6ZSI6NTAwLCAiZmlsdGVycyI6bnVsbH0="
}