AIsuru Docs
AIsuru API
AIsuru API
  • Introduzione
  • Engine
    • ChatLogs
    • ContextVars
    • CorrelationPairs
    • CustomDictionary
    • Dialog
    • EventLogs
    • ExpertReferences
    • Functions
    • Intents
    • LocalizationKeys
    • Media
    • Memories
    • NLP
    • People
    • Search
    • Session
    • Stats
    • Topics
    • UnansweredQuestions
    • User
    • WebHooks
    • Models
  • Backend
    • ActionLog
    • Analysis
    • Asset
    • Badge
    • CompletionConfig
    • ConsumptionLog
    • ImportExport
    • Integration
    • Invitation
    • Memori
    • MemoriList
    • Notification
    • Process
    • Tenant
    • User
    • Models
Powered by GitBook
On this page
  1. Backend

Notification

PreviousMemoriListNextProcess

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-06-07T13:51:12.721Z",
  "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-06-07T13:51:12.721Z",
      "severity": "text",
      "texts": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "additionalInfo": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "type": "text",
      "tenant": "text",
      "userName": "text",
      "validFrom": "2025-06-07T13:51:12.721Z",
      "validTo": "2025-06-07T13:51:12.721Z"
    }
  ],
  "requestID": 1,
  "requestDateTime": "2025-06-07T13:51:12.721Z",
  "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-06-07T13:51:12.721Z",
      "severity": "text",
      "texts": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "additionalInfo": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "type": "text",
      "tenant": "text",
      "userName": "text",
      "validFrom": "2025-06-07T13:51:12.721Z",
      "validTo": "2025-06-07T13:51:12.721Z"
    }
  ],
  "requestID": 1,
  "requestDateTime": "2025-06-07T13:51:12.721Z",
  "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-06-07T13:51:12.721Z",
      "severity": "text",
      "texts": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "additionalInfo": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "type": "text",
      "tenant": "text",
      "userName": "text",
      "validFrom": "2025-06-07T13:51:12.721Z",
      "validTo": "2025-06-07T13:51:12.721Z"
    }
  ],
  "requestID": 1,
  "requestDateTime": "2025-06-07T13:51:12.721Z",
  "resultCode": 1,
  "resultMessage": "text"
}
  • POSTCreates a new Notification object.
  • GETGets a specific Notification object.
  • DELETEDeletes a Notification object.
  • PATCHUpdates a Notification object.
  • GETGets all the Notification objects
  • GETGets the Notification objects for the currently logged-in user.
  • GETGets the Notification objects for a specific Tenant.

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-06-07T13:51:12.721Z",
    "severity": "text",
    "texts": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    },
    "additionalInfo": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    },
    "type": "text",
    "tenant": "text",
    "userName": "text",
    "validFrom": "2025-06-07T13:51:12.721Z",
    "validTo": "2025-06-07T13:51:12.721Z"
  },
  "requestID": 1,
  "requestDateTime": "2025-06-07T13:51:12.721Z",
  "resultCode": 1,
  "resultMessage": "text"
}

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-06-07T13:51:12.721Z",
  "severity": "text",
  "texts": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  },
  "additionalInfo": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  },
  "type": "text",
  "tenant": "text",
  "userName": "text",
  "validFrom": "2025-06-07T13:51:12.721Z",
  "validTo": "2025-06-07T13:51:12.721Z"
}
200

Success

{
  "notification": {
    "notificationID": "text",
    "timestamp": "2025-06-07T13:51:12.721Z",
    "severity": "text",
    "texts": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    },
    "additionalInfo": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    },
    "type": "text",
    "tenant": "text",
    "userName": "text",
    "validFrom": "2025-06-07T13:51:12.721Z",
    "validTo": "2025-06-07T13:51:12.721Z"
  },
  "requestID": 1,
  "requestDateTime": "2025-06-07T13:51:12.721Z",
  "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-06-07T13:51:12.721Z",
  "severity": "text",
  "texts": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  },
  "additionalInfo": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  },
  "type": "text",
  "tenant": "text",
  "userName": "text",
  "validFrom": "2025-06-07T13:51:12.721Z",
  "validTo": "2025-06-07T13:51:12.721Z"
}
200

Success

{
  "notification": {
    "notificationID": "text",
    "timestamp": "2025-06-07T13:51:12.721Z",
    "severity": "text",
    "texts": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    },
    "additionalInfo": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    },
    "type": "text",
    "tenant": "text",
    "userName": "text",
    "validFrom": "2025-06-07T13:51:12.721Z",
    "validTo": "2025-06-07T13:51:12.721Z"
  },
  "requestID": 1,
  "requestDateTime": "2025-06-07T13:51:12.721Z",
  "resultCode": 1,
  "resultMessage": "text"
}