アラート

Retrieve in‑app alert notifications for the current authenticated user.

API エンドポイント

GET https://cloud.uipath.com/{organizationName}/notificationservice_/notificationserviceapi/odata/v1/Alerts

要求ヘッダー

--header 'Authorization: Bearer {access_token}'\
--header 'Content-Type: application/json'

クエリ パラメーター

The endpoint supports standard OData query options on the Alerts collection:

1. $filter: Filter alerts.
   例: ?$filter=Severity eq 'High'
2. $orderby: Sort alerts.
   例: ?$orderby=CreationTime desc
3. $top: Limit the number of results returned.
   例: ?$top=50
4. $skip: Skip a number of results (paging).
   例: ?$skip=50&$top=50
5. $count: Request total count of items.
   Note: Must be a valid Boolean literal: "true" or "false".

Filter examples

Check out the following filter examples:

1. By component: ?$filter=component eq 'Process'.
2. By read state (unread only) ?$filter=component eq 'Process' and state eq 'Unread'.
3. By severity: The severity field is an enum. Only equality comparisons on severity are supported, for example:
   • severity eq 'Warning'
   • severity in ('Info','Warning')
   Inequality (ne) and range comparisons (gt, ge, lt, le) on severity are not supported and must not be used in $filter expressions.
   例: ?$filter=component eq 'Process' and severity eq 'Warning'
4. By time range: ?$filter=component eq 'Process' and creationTime ge 2025-01-01T00:00:00Z and creationTime lt 2025-02-01T00:00:00Z
5. Search in alert message or context (data): ?$filter=component eq 'Process' and contains(data,'Timeout')

応答

200 OK

In-app alert notifications for the authenticated user were retrieved successfully.

400 Bad Request

• Invalid OData query, particularly an invalid $count value (non-Boolean).

• Response body is a standard JSON error object with a message indicating the invalid count query option.

401 未承認

Missing or invalid bearer token.

403 Forbidden

Token valid but does not satisfy the UserContext policy or required permissions.

5xx Server Errors

Unexpected server-side failures.

要求の例

要求:

curl --location --request GET \
  'https://cloud.uipath.com/{organizationName}/notificationservice_/notificationserviceapi/odata/v1/Alerts?$top=50&$skip=0&$orderby=creationTime desc&$count=true' \
  --header 'Authorization: Bearer {access_token}' \
  --header 'Accept: application/json'

応答:

{
  "value": [
    {
      "id": "<identifier>",
      "notificationName": "Robot.StatusChanged.NotResponding",
      "data": "{\"robotId\": 123, \"machineName\": \"<machineName>\"}",
      "component": "Orchestrator",
      "severity": "Warning",
      "creationTime": "2025-01-01T12:34:56Z",
      "state": "Unread",
      "userNotificationId": "<userNotificationId>",
      "deepLinkRelativeUrl": "/alerts/deeplink/robot-not-responding?robotId=123"
    }
  ],
  "@odata.count": 1
}