Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

On This Page

Table of Contents

Overview

User notifications allow you to send notifications to a user based on subscribed events. User notifications are dependent on the user account setup; the groups and roles assigned to the user determine what connectors and jobs the user can receive notifications for from DryvIQ. Only connectors and jobs a user has access to based on the user setup will trigger notifications. Notifications can be added to an existing user account or added when creating a new user account.

List Details for All Users

Execute a GET to retrieve details for all users, specifically user ID.

...

Code Block
{
            "id": "2f4543e407724398b38ec783a1e95574",
            "login": "user1",
            "name": "user1",
            "roles": [],
            "permissions": [
                {
                    "id": "47c6cd5954f041df8d79e1972cc1ce3b",
                    "name": "List Connections"
                },
                {
                    "id": "294eee9539354739b194da1a879bc163",
                    "name": "Manage Connections"
                }
            ],
            "status": "active",
            "disabled": false,
            "notifications": {
                "emails": true,
                "sms": false,
                "notification_types": [
                    "license-expired",
                    "job-completed"
                ]
            },
            "created_on": 1577119682.0,
            "created_by": "21d58cf305c3467da0e6753d1b8863be",
            "type": "user"
        }
    ]
}

List Available Categories Types

The following GET lists all the available notification categories.

...

Code Block
{
    "status": 200,
    "type": "notification_types",
    "notification_types": [
        {
            "id": "connection-failed",
            "name": "Connection failed",
            "description": "Receive a notification whenever a connection fails to open."
        },
        {
            "id": "product-upgrade-available",
            "name": "Upgrade available",
            "description": "Receive a notification when a new version of the software is available."
        },
        {
            "id": "license-expired",
            "name": "License has expired",
            "description": "Receive a notification when your license has expired."
        },
        {
            "id": "license-expiration-warning",
            "name": "License expiry approaching",
            "description": "Receive a notification when your license will expire soon."
        },
        {
            "id": "job-failed",
            "name": "Job failed",
            "description": "Receive a notification whenever a job fails."
        },
        {
            "id": "job-completed",
            "name": "Job completed",
            "description": "Receive a notification whenever a job meets its stop policy."
        }
    ]
}

Change Notifications a User Receives

This PATCH updates the current notification configuration to add or remove notification types a user receives.

...