Update event notification recipients in bulk

Update recipients for email notifications of an event in bulk.

Only recipients included in this call receive email notificaitons. A recipient who was previously receiving notifications but was not included in this call is removed from the list of recipients receiving notifications.

Note: PUT calls update data entirely. Any data not mentioned in the call, will be deleted.

Request
Security:
bearerAuth
path Parameters
required
Configurable Events (string) or Unconfigurable Events (string) (All Events)

Event type

Request Body schema: application/json
One of:
organizationId
required
number (Organization ID)

The ID of the organization. Obtain this from GET /organizations.

groupIds
Array of integers (Group ID) non-empty

The IDs of the requested groups. Obtain group IDs from GET /organizations/{orgId}/devices.

notificationRecipients
required
Array of strings <email> (Email)

The recipient emails.

Responses
200

Successful operation

400

Bad request error

401

Unauthorized error

403

Forbidden error

404

Not found error

500

Internal server error

put/devices/events/{eventType}/notification-recipients
Request samples
application/json
putBulkEventNotificationRecipientsOrganization
putBulkEventNotificationRecipientsOrganization
putBulkEventNotificationRecipientsImeis
{
  • "organizationId": 17,
  • "groupIds": [
    ],
  • "notificationRecipients": [
    ]
}
Response samples
    1 more
    500
application/json
{
  • "requestId": "06327cae-e075-42ca-b620-c5cfdd3b4e37"
}