/[notificationID]: Notification

Example Usage

URL for Notification

1
https://www.arcgis.com/sharing/rest/community/users/jsmith/notifications/9315e22b2f99423f8d06228d04719efe

Description

An individual notification for the given user that can be of different types as described in the Notification types section below. Available only to the user recipient of the notification.

In the JSON response for a notification, the data property will vary based on the notification type.

Notification types

Notifications can be generated for many types of events—user applying to join a group, acceptance of a group application, rejection of a group application, and so on. Notifications are categorized by their notificationType. In the JSON response for a notification, the data property will vary based on the notification type.

The supported notification types along with their data property examples are listed below. More types will be added as needed, and developers should ignore types they're unfamiliar with rather than throw an error.

group_join

A notification of this type is generated when a user applies to join a group.

data property—Includes the ID and title of the group that received the application.

1
2
3
4
{
  "groupId": "cc5f73ab367544d6b954d82cc9c6dab7",
  "groupTitle": "Street Maps"
}

group_application_accepted

A notification of this type is generated when the user's application to join a group has been accepted.

data property—Includes the ID and title of the group that accepted the application.

1
2
3
4
{
  "groupId": "cc5f73ab367544d6b954d82cc9c6dab7",
  "groupTitle": "Street Maps"
}

group_application_declined

A notification of this type is generated when the user's application to join a group has been declined.

data property—Includes the ID and title of the group that declined the application.

1
2
3
4
{
  "groupId": "cc5f73ab367544d6b954d82cc9c6dab7",
  "groupTitle": "Street Maps"
}

user_invite

A notification of this type is generated when a user is invited to a group.

data property—Includes the ID and title of the group that invited the user.

1
2
3
4
{
  "groupId": "cc5f73ab367544d6b954d82cc9c6dab7",
  "groupTitle": "Street Maps"
}

user_invitation_accepted

A notification of this type is generated when the user accepts an invitation to join a group.

data property—Includes the ID and title of the group for which the invitation was accepted.

1
2
3
4
{
  "groupId": "cc5f73ab367544d6b954d82cc9c6dab7",
  "groupTitle": "Street Maps"
}

user_invitation_declined

A notification of this type is generated when the user declines an invitation to join a group.

data property—Includes the ID and title of the group for which the invitation was declined.

1
2
3
4
{
  "groupId": "cc5f73ab367544d6b954d82cc9c6dab7",
  "groupTitle": "Street Maps"
}

Request Parameters

Response Properties

JSON Response Syntax

1
2
3
4
5
6
7
8
9
10
11
12
{
  "id": "<notification id>",
  "type": "group join | group_application_accepted | group_application_declined | user_invite | user_invitation_accepted |
           user_invitation_declined",
  "target": "<recipient username>",
  "targetType": "user",
  "received": date received,
  "data": {
    "groupId": "<group id>",
    "groupTitle": "<group title>"
  }
}

JSON Response Example

1
2
3
4
5
6
7
8
9
10
11
{
  "id": "9315e22b2f99423f8d06228d04719efe",
  "type": "group_application_declined",
  "target": "jsmith",
  "targetType": "user",
  "received": 1230072232000,
  "data": {
    "groupId": "cc5f73ab367544d6b954d82cc9c6dab7",
    "groupTitle": "Street Maps"
  }
}