Notification | AIsuru Docs

Creates a new Notification object.

post

Path parameters

strTokenstringRequired

The login token

Body

Specifications of a Notification object.

notificationIDstring | nullableOptional

Notificaiton ID. Unique and assigned by the system.

timestampstring · date-timeOptional

Timestamp UTC of the notification.

severitystring | nullableOptional

Severity level. May be one of the following: INFO: the notification is an information AWARD: the notification is an award WARN: the notification is a warning ALERT: the notification is an alert

typestring | nullableOptional

Notification type. /// May be one of the following: BROADCAST: the notification is a broadcast TENANT: the notification is a tenant notification USER: the notification is a user notification

tenantstring | nullableOptional

Tenant ID of the notification.

userNamestring | nullableOptional

The Username of the user that the notification is addressed to.

validFromstring · date-time | nullableOptional

The date and time from which the notification is valid. Used when creating and modifying the notification. Ignored otherwise.

validTostring · date-time | nullableOptional

The date and time until which the notification is valid. Used when creating and modifying the notification. Ignored otherwise.

Responses

200

Success

post

POST /api/v2/Notifications/{strToken} HTTP/1.1
Host: 
Content-Type: application/json-patch+json
Accept: */*
Content-Length: 301

{
  "notificationID": "text",
  "timestamp": "2025-07-23T11:30:34.652Z",
  "severity": "text",
  "texts": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  },
  "additionalInfo": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  },
  "type": "text",
  "tenant": "text",
  "userName": "text",
  "validFrom": "2025-07-23T11:30:34.652Z",
  "validTo": "2025-07-23T11:30:34.652Z"
}

200

Success

{
  "notification": {
    "notificationID": "text",
    "timestamp": "2025-07-23T11:30:34.652Z",
    "severity": "text",
    "texts": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    },
    "additionalInfo": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    },
    "type": "text",
    "tenant": "text",
    "userName": "text",
    "validFrom": "2025-07-23T11:30:34.652Z",
    "validTo": "2025-07-23T11:30:34.652Z"
  },
  "requestID": 1,
  "requestDateTime": "2025-07-23T11:30:34.652Z",
  "resultCode": 1,
  "resultMessage": "text"
}

Gets a specific Notification object.

get

Path parameters

strTokenstringRequired

The login token

strNotificationIDstringRequired

The ID of the notification

Responses

200

Success

get

GET /api/v2/Notifications/{strToken}/{strNotificationID} HTTP/1.1
Host: 
Accept: */*

200

Success

{
  "notification": {
    "notificationID": "text",
    "timestamp": "2025-07-23T11:30:34.652Z",
    "severity": "text",
    "texts": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    },
    "additionalInfo": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    },
    "type": "text",
    "tenant": "text",
    "userName": "text",
    "validFrom": "2025-07-23T11:30:34.652Z",
    "validTo": "2025-07-23T11:30:34.652Z"
  },
  "requestID": 1,
  "requestDateTime": "2025-07-23T11:30:34.652Z",
  "resultCode": 1,
  "resultMessage": "text"
}

Deletes a Notification object.

delete

Path parameters

strTokenstringRequired

The login token

strNotificationIDstringRequired

The ID of the notification

Responses

200

Success

delete

DELETE /api/v2/Notifications/{strToken}/{strNotificationID} HTTP/1.1
Host: 
Accept: */*

200

Success

{
  "requestID": 1,
  "requestDateTime": "2025-07-23T11:30:34.652Z",
  "resultCode": 1,
  "resultMessage": "text"
}

Updates a Notification object.

patch

Path parameters

strTokenstringRequired

strNotificationIDstringRequired

Body

Specifications of a Notification object.

notificationIDstring | nullableOptional

Notificaiton ID. Unique and assigned by the system.

timestampstring · date-timeOptional

Timestamp UTC of the notification.

severitystring | nullableOptional

Severity level. May be one of the following: INFO: the notification is an information AWARD: the notification is an award WARN: the notification is a warning ALERT: the notification is an alert

typestring | nullableOptional

Notification type. /// May be one of the following: BROADCAST: the notification is a broadcast TENANT: the notification is a tenant notification USER: the notification is a user notification

tenantstring | nullableOptional

Tenant ID of the notification.

userNamestring | nullableOptional

The Username of the user that the notification is addressed to.

validFromstring · date-time | nullableOptional

The date and time from which the notification is valid. Used when creating and modifying the notification. Ignored otherwise.

validTostring · date-time | nullableOptional

The date and time until which the notification is valid. Used when creating and modifying the notification. Ignored otherwise.

Responses

200

Success

patch

PATCH /api/v2/Notifications/{strToken}/{strNotificationID} HTTP/1.1
Host: 
Content-Type: application/json-patch+json
Accept: */*
Content-Length: 301

{
  "notificationID": "text",
  "timestamp": "2025-07-23T11:30:34.652Z",
  "severity": "text",
  "texts": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  },
  "additionalInfo": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  },
  "type": "text",
  "tenant": "text",
  "userName": "text",
  "validFrom": "2025-07-23T11:30:34.652Z",
  "validTo": "2025-07-23T11:30:34.652Z"
}

200

Success

{
  "notification": {
    "notificationID": "text",
    "timestamp": "2025-07-23T11:30:34.652Z",
    "severity": "text",
    "texts": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    },
    "additionalInfo": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    },
    "type": "text",
    "tenant": "text",
    "userName": "text",
    "validFrom": "2025-07-23T11:30:34.652Z",
    "validTo": "2025-07-23T11:30:34.652Z"
  },
  "requestID": 1,
  "requestDateTime": "2025-07-23T11:30:34.652Z",
  "resultCode": 1,
  "resultMessage": "text"
}

Gets all the Notification objects

get

Path parameters

strTokenstringRequired

The login token

notificationsFilterstringRequired

Filters the notifications to show. May be one of the following:ACTIVE_AND_FUTURE: Only active and future notificationsONLY_FUTURE : Only future notificationsALL : All notifications

Default: ACTIVE_AND_FUTURE

Responses

200

Success

get

GET /api/v2/ListAllNotifications/{strToken}/{notificationsFilter} HTTP/1.1
Host: 
Accept: */*

200

Success

{
  "notifications": [
    {
      "notificationID": "text",
      "timestamp": "2025-07-23T11:30:34.652Z",
      "severity": "text",
      "texts": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "additionalInfo": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "type": "text",
      "tenant": "text",
      "userName": "text",
      "validFrom": "2025-07-23T11:30:34.652Z",
      "validTo": "2025-07-23T11:30:34.652Z"
    }
  ],
  "requestID": 1,
  "requestDateTime": "2025-07-23T11:30:34.652Z",
  "resultCode": 1,
  "resultMessage": "text"
}

Gets the Notification objects for the currently logged-in user.

get

Path parameters

strTokenstringRequired

The login token

Responses

200

Success

get

GET /api/v2/UserNotifications/{strToken} HTTP/1.1
Host: 
Accept: */*

200

Success

{
  "notifications": [
    {
      "notificationID": "text",
      "timestamp": "2025-07-23T11:30:34.652Z",
      "severity": "text",
      "texts": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "additionalInfo": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "type": "text",
      "tenant": "text",
      "userName": "text",
      "validFrom": "2025-07-23T11:30:34.652Z",
      "validTo": "2025-07-23T11:30:34.652Z"
    }
  ],
  "requestID": 1,
  "requestDateTime": "2025-07-23T11:30:34.652Z",
  "resultCode": 1,
  "resultMessage": "text"
}

Gets the Notification objects for a specific Tenant.

get

Path parameters

tenantNamestringRequired

The name of the Tenant

Responses

200

Success

get

GET /api/v2/TenantNotifications/{tenantName} HTTP/1.1
Host: 
Accept: */*

200

Success

{
  "notifications": [
    {
      "notificationID": "text",
      "timestamp": "2025-07-23T11:30:34.652Z",
      "severity": "text",
      "texts": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "additionalInfo": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "type": "text",
      "tenant": "text",
      "userName": "text",
      "validFrom": "2025-07-23T11:30:34.652Z",
      "validTo": "2025-07-23T11:30:34.652Z"
    }
  ],
  "requestID": 1,
  "requestDateTime": "2025-07-23T11:30:34.652Z",
  "resultCode": 1,
  "resultMessage": "text"
}