/[notificationID]: Notification

URL:
https://[root]/community/users/[userName]/notifications/[notificationID]
Methods:
GET
Operations:
Delete

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

ParameterDetails

[Common Parameter]

For a complete listing, see Common parameters.

Response Properties

PropertyDetails

id

The ID of the notification.

type

The notification type. See the Notification types section above for the list of notification types.

target

The intended user of the notification.

targetType

Currently, only "user" is acceptable, but in the future, there may be other target types for notifications.

received

Date the notification was received, in UNIX time in milliseconds.

data

The data for the notification. See the Notification types section above for data properties for each notification type.

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"
  }
}

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.

You can no longer sign into this site. Go to your ArcGIS portal or the ArcGIS Location Platform dashboard to perform management tasks.

Your ArcGIS portal

Create, manage, and access API keys and OAuth 2.0 developer credentials, hosted layers, and data services.

Your ArcGIS Location Platform dashboard

Manage billing, monitor service usage, and access additional resources.

Learn more about these changes in the What's new in Esri Developers June 2024 blog post.

Close