Notification

Creates a new Notification object.

post

Path parameters

strTokenstringRequired

The login token

Body

application/json-patch+jsonapplication/jsontext/jsonapplication/*+json

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

text/plainapplication/jsontext/json

Response of a Create User Notification request.

requestIDinteger · int64Optional

Progressive number of the request (since the Server started). Use this number, together with the RequestDateTime property, to report an anomalous reponse.

requestDateTimestring · date-timeOptional

Timestamp of the request. Use this timestamp, together with the RequestID property, to report an anomalous reponse.

resultCodeinteger · int32Optional

Result code. A code of 0 means no errors. When the request fails, its value is indicative of the actual error.

resultMessagestring · nullableOptional

Result message. A message of Ok means no errors.

post

/api/v2/Notifications/{strToken}

HTTPcURLJavaScriptPython

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

{
  "notificationID": "text",
  "timestamp": "2026-03-06T21:17:43.010Z",
  "severity": "text",
  "texts": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  },
  "additionalInfo": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  },
  "type": "text",
  "tenant": "text",
  "userName": "text",
  "validFrom": "2026-03-06T21:17:43.010Z",
  "validTo": "2026-03-06T21:17:43.010Z"
}

application/json-patch+jsonapplication/jsontext/jsonapplication/*+json

200

Success

{
  "notification": {
    "notificationID": "text",
    "timestamp": "2026-03-06T21:17:43.010Z",
    "severity": "text",
    "texts": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    },
    "additionalInfo": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    },
    "type": "text",
    "tenant": "text",
    "userName": "text",
    "validFrom": "2026-03-06T21:17:43.010Z",
    "validTo": "2026-03-06T21:17:43.010Z"
  },
  "requestID": 1,
  "requestDateTime": "2026-03-06T21:17:43.010Z",
  "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

text/plainapplication/jsontext/json

requestIDinteger · int64Optional

Progressive number of the request (since the Server started). Use this number, together with the RequestDateTime property, to report an anomalous reponse.

requestDateTimestring · date-timeOptional

Timestamp of the request. Use this timestamp, together with the RequestID property, to report an anomalous reponse.

resultCodeinteger · int32Optional

Result code. A code of 0 means no errors. When the request fails, its value is indicative of the actual error.

resultMessagestring · nullableOptional

Result message. A message of Ok means no errors.

get

/api/v2/Notifications/{strToken}/{strNotificationID}

HTTPcURLJavaScriptPython

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

200

Success

{
  "notification": {
    "notificationID": "text",
    "timestamp": "2026-03-06T21:17:43.010Z",
    "severity": "text",
    "texts": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    },
    "additionalInfo": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    },
    "type": "text",
    "tenant": "text",
    "userName": "text",
    "validFrom": "2026-03-06T21:17:43.010Z",
    "validTo": "2026-03-06T21:17:43.010Z"
  },
  "requestID": 1,
  "requestDateTime": "2026-03-06T21:17:43.010Z",
  "resultCode": 1,
  "resultMessage": "text"
}

Deletes a Notification object.

delete

Path parameters

strTokenstringRequired

The login token

strNotificationIDstringRequired

The ID of the notification

Responses

200

Success

text/plainapplication/jsontext/json

Base response.

requestIDinteger · int64Optional

Progressive number of the request (since the Server started). Use this number, together with the RequestDateTime property, to report an anomalous reponse.

requestDateTimestring · date-timeOptional

Timestamp of the request. Use this timestamp, together with the RequestID property, to report an anomalous reponse.

resultCodeinteger · int32Optional

Result code. A code of 0 means no errors. When the request fails, its value is indicative of the actual error.

resultMessagestring · nullableOptional

Result message. A message of Ok means no errors.

delete

/api/v2/Notifications/{strToken}/{strNotificationID}

HTTPcURLJavaScriptPython

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

200

Success

{
  "requestID": 1,
  "requestDateTime": "2026-03-06T21:17:43.010Z",
  "resultCode": 1,
  "resultMessage": "text"
}

Updates a Notification object.

patch

Path parameters

strTokenstringRequired

strNotificationIDstringRequired

Body

application/json-patch+jsonapplication/jsontext/jsonapplication/*+json

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

text/plainapplication/jsontext/json

requestIDinteger · int64Optional

Progressive number of the request (since the Server started). Use this number, together with the RequestDateTime property, to report an anomalous reponse.

requestDateTimestring · date-timeOptional

Timestamp of the request. Use this timestamp, together with the RequestID property, to report an anomalous reponse.

resultCodeinteger · int32Optional

Result code. A code of 0 means no errors. When the request fails, its value is indicative of the actual error.

resultMessagestring · nullableOptional

Result message. A message of Ok means no errors.

patch

/api/v2/Notifications/{strToken}/{strNotificationID}

HTTPcURLJavaScriptPython

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

{
  "notificationID": "text",
  "timestamp": "2026-03-06T21:17:43.010Z",
  "severity": "text",
  "texts": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  },
  "additionalInfo": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  },
  "type": "text",
  "tenant": "text",
  "userName": "text",
  "validFrom": "2026-03-06T21:17:43.010Z",
  "validTo": "2026-03-06T21:17:43.010Z"
}

application/json-patch+jsonapplication/jsontext/jsonapplication/*+json

200

Success

{
  "notification": {
    "notificationID": "text",
    "timestamp": "2026-03-06T21:17:43.010Z",
    "severity": "text",
    "texts": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    },
    "additionalInfo": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    },
    "type": "text",
    "tenant": "text",
    "userName": "text",
    "validFrom": "2026-03-06T21:17:43.010Z",
    "validTo": "2026-03-06T21:17:43.010Z"
  },
  "requestID": 1,
  "requestDateTime": "2026-03-06T21:17:43.010Z",
  "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

text/plainapplication/jsontext/json

Response of a List Notifications request.

requestIDinteger · int64Optional

Progressive number of the request (since the Server started). Use this number, together with the RequestDateTime property, to report an anomalous reponse.

requestDateTimestring · date-timeOptional

Timestamp of the request. Use this timestamp, together with the RequestID property, to report an anomalous reponse.

resultCodeinteger · int32Optional

Result code. A code of 0 means no errors. When the request fails, its value is indicative of the actual error.

resultMessagestring · nullableOptional

Result message. A message of Ok means no errors.

get

/api/v2/ListAllNotifications/{strToken}/{notificationsFilter}

HTTPcURLJavaScriptPython

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

200

Success

{
  "notifications": [
    {
      "notificationID": "text",
      "timestamp": "2026-03-06T21:17:43.010Z",
      "severity": "text",
      "texts": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "additionalInfo": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "type": "text",
      "tenant": "text",
      "userName": "text",
      "validFrom": "2026-03-06T21:17:43.010Z",
      "validTo": "2026-03-06T21:17:43.010Z"
    }
  ],
  "requestID": 1,
  "requestDateTime": "2026-03-06T21:17:43.010Z",
  "resultCode": 1,
  "resultMessage": "text"
}

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

get

Path parameters

strTokenstringRequired

The login token

Responses

200

Success

text/plainapplication/jsontext/json

Response of a List Notifications request.

requestIDinteger · int64Optional

Progressive number of the request (since the Server started). Use this number, together with the RequestDateTime property, to report an anomalous reponse.

requestDateTimestring · date-timeOptional

Timestamp of the request. Use this timestamp, together with the RequestID property, to report an anomalous reponse.

resultCodeinteger · int32Optional

Result code. A code of 0 means no errors. When the request fails, its value is indicative of the actual error.

resultMessagestring · nullableOptional

Result message. A message of Ok means no errors.

get

/api/v2/UserNotifications/{strToken}

HTTPcURLJavaScriptPython

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

200

Success

{
  "notifications": [
    {
      "notificationID": "text",
      "timestamp": "2026-03-06T21:17:43.010Z",
      "severity": "text",
      "texts": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "additionalInfo": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "type": "text",
      "tenant": "text",
      "userName": "text",
      "validFrom": "2026-03-06T21:17:43.010Z",
      "validTo": "2026-03-06T21:17:43.010Z"
    }
  ],
  "requestID": 1,
  "requestDateTime": "2026-03-06T21:17:43.010Z",
  "resultCode": 1,
  "resultMessage": "text"
}

Gets the Notification objects for a specific Tenant.

get

Path parameters

tenantNamestringRequired

The name of the Tenant

Responses

200

Success

text/plainapplication/jsontext/json

Response of a List Notifications request.

requestIDinteger · int64Optional

Progressive number of the request (since the Server started). Use this number, together with the RequestDateTime property, to report an anomalous reponse.

requestDateTimestring · date-timeOptional

Timestamp of the request. Use this timestamp, together with the RequestID property, to report an anomalous reponse.

resultCodeinteger · int32Optional

Result code. A code of 0 means no errors. When the request fails, its value is indicative of the actual error.

resultMessagestring · nullableOptional

Result message. A message of Ok means no errors.

get

/api/v2/TenantNotifications/{tenantName}

HTTPcURLJavaScriptPython

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

200

Success

{
  "notifications": [
    {
      "notificationID": "text",
      "timestamp": "2026-03-06T21:17:43.010Z",
      "severity": "text",
      "texts": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "additionalInfo": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "type": "text",
      "tenant": "text",
      "userName": "text",
      "validFrom": "2026-03-06T21:17:43.010Z",
      "validTo": "2026-03-06T21:17:43.010Z"
    }
  ],
  "requestID": 1,
  "requestDateTime": "2026-03-06T21:17:43.010Z",
  "resultCode": 1,
  "resultMessage": "text"
}

Gets all the changelog Notification objects (including expired ones). This is a public endpoint that returns all changelog notifications for all tenants.

get

Path parameters

tenantNamestringRequired

The name of the Tenant

Responses

200

Success

text/plainapplication/jsontext/json

Response of a List Notifications request.

requestIDinteger · int64Optional

Progressive number of the request (since the Server started). Use this number, together with the RequestDateTime property, to report an anomalous reponse.

requestDateTimestring · date-timeOptional

Timestamp of the request. Use this timestamp, together with the RequestID property, to report an anomalous reponse.

resultCodeinteger · int32Optional

Result code. A code of 0 means no errors. When the request fails, its value is indicative of the actual error.

resultMessagestring · nullableOptional

Result message. A message of Ok means no errors.

get

/api/v2/ChangelogNotifications/{tenantName}

HTTPcURLJavaScriptPython

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

200

Success

{
  "notifications": [
    {
      "notificationID": "text",
      "timestamp": "2026-03-06T21:17:43.010Z",
      "severity": "text",
      "texts": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "additionalInfo": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "type": "text",
      "tenant": "text",
      "userName": "text",
      "validFrom": "2026-03-06T21:17:43.010Z",
      "validTo": "2026-03-06T21:17:43.010Z"
    }
  ],
  "requestID": 1,
  "requestDateTime": "2026-03-06T21:17:43.010Z",
  "resultCode": 1,
  "resultMessage": "text"
}