POST api/Alert

Creates a new instance of an Alert in the database.

Request Information

URI Parameters

None.

Body Parameters

The model to use

Name	Description	Type	Additional information
RepeatCounter	The number of times this Alert has repeated	integer	None.
Category	Category for the Alert	string	None.
SubCategory	SubCategory for the Alert	string	None.
Message	Message for the Alert	string	None.
SMSFriendlyMessage	Message for the Alert in an "SMS Friendly" format	string	None.
AlertType	Type for the Alert, such as or	AlertType	None.
IsEmail	Whether or not this Alert is to utilise Email	boolean	None.
IsSMS	Whether or not this Alert is to utilise SMS	boolean	None.
RequiresAcknowledgement	Whether or not this Alert requires acknowledgement	boolean	None.
AcknowledgedDate	Date and Time for when this Alert has been acknowledged	date	None.
AcknowledgementUserID	ID of the User that has acknowledged this Alert	globally unique identifier	None.
AlertDate	Date and Time for when the Alert happened	date	None.
ResendWaitTimeMinutes	Resend Wait Time for the Alert (in minutes), to be used if it is to repeat	integer	None.
MaxRepeat	Maximum number of repeats for this Alert	integer	None.
ObjectID	ID for the Object this Alert is associated with	globally unique identifier	None.
ObjectType	Type for the Object this Alert is associated with	OwnerType	None.
IgnoreDate	Date and Time that this Alert has been ignored	date	None.
SourceID	ID of the Source of this Alert, if available	globally unique identifier	None.
SourceIntID	ID of the Source of this Alert, if available	integer	None.
SourceType	The Type for the object that is the Source of this Alert, such as a ReadingBand or Schedule	TriggerType	None.
SourceInfo	Information about the Source of this Alert	string	None.
GoodCounter	Counter for the number of consecutive "Good" readings	integer	None.
AlertRecipients	List of recipients for this Alert	Collection of AlertRecipient	None.
LastHandled	Date and Time this Alert was last handled	date	None.
ActionRequired	Whether or not an action is required for this alert	boolean	None.
ObjectInfo	Basic information for this object	ObjectInfo	None.
ID	Gets ID for this record	globally unique identifier	None.
IntID	Gets Integer ID for this record	integer	None.

Request Formats

application/json, text/json, text/html

Sample:

{
  "RepeatCounter": 1,
  "Category": "sample string 2",
  "SubCategory": "sample string 3",
  "Message": "sample string 4",
  "SMSFriendlyMessage": "sample string 5",
  "AlertType": 0,
  "IsEmail": true,
  "IsSMS": true,
  "RequiresAcknowledgement": true,
  "AcknowledgedDate": "2026-08-07T08:28:19.753687+10:00",
  "AcknowledgementUserID": "b054fc65-3082-475f-b139-ba71fb39a92b",
  "AlertDate": "2026-08-07T08:28:19.7693114",
  "ResendWaitTimeMinutes": 9,
  "MaxRepeat": 10,
  "ObjectID": "5fb41f28-162c-47a8-87d1-a66ed2065bda",
  "ObjectType": 10,
  "IgnoreDate": "2026-08-07T08:28:19.753687+10:00",
  "SourceID": "e70ce809-3d09-4c4b-816a-561bc0c7363f",
  "SourceIntID": 12,
  "SourceType": 0,
  "SourceInfo": "ReadingBand 12",
  "GoodCounter": 13,
  "AlertRecipients": [
    {
      "AlertID": "eb2a360f-6870-47d6-bea9-38cfdbc7aa6f",
      "UserID": "f10e8da7-e5e2-4691-9078-01b29c3b4403",
      "EmailSent": "2026-08-07T08:28:19.7693114+10:00",
      "SMSSent": "2026-08-07T08:28:19.7693114+10:00",
      "GetsEmail": true,
      "GetsSMS": true,
      "ID": "aa163a2e-6047-4bef-83a6-08fdc24e2bbf",
      "IntID": 0,
      "ObjectInfo": {
        "ID": "aa163a2e-6047-4bef-83a6-08fdc24e2bbf",
        "IntID": 0,
        "Type": -1,
        "Valid": false,
        "IsEmpty": false
      }
    },
    {
      "AlertID": "eb2a360f-6870-47d6-bea9-38cfdbc7aa6f",
      "UserID": "f10e8da7-e5e2-4691-9078-01b29c3b4403",
      "EmailSent": "2026-08-07T08:28:19.7693114+10:00",
      "SMSSent": "2026-08-07T08:28:19.7693114+10:00",
      "GetsEmail": true,
      "GetsSMS": true,
      "ID": "aa163a2e-6047-4bef-83a6-08fdc24e2bbf",
      "IntID": 0,
      "ObjectInfo": {
        "ID": "aa163a2e-6047-4bef-83a6-08fdc24e2bbf",
        "IntID": 0,
        "Type": -1,
        "Valid": false,
        "IsEmpty": false
      }
    }
  ],
  "LastHandled": "2026-08-07T08:28:19.7693114+10:00",
  "ActionRequired": true,
  "ObjectInfo": {
    "ID": "390e10bb-4844-4d96-9a0c-e171274ef5fd",
    "IntID": 0,
    "Type": 800,
    "Valid": true,
    "IsEmpty": false
  },
  "ID": "390e10bb-4844-4d96-9a0c-e171274ef5fd",
  "IntID": 0
}

application/x-www-form-urlencoded

Sample:

Sample not available.

Response Information

Resource Description

Http Status code indicating result.

GetAlertResponse

Name	Description	Type	Additional information
Alerts	Array of Alerts	Collection of AlertStruct	None.
Messages	Array of messages	Collection of Message	None.
ServerInformation	Relevant information regarding the Server	ServerInformation	None.
VersionInformation	Relevant information regarding the API's version	VersionInformation	None.

Response Formats

application/json, text/json, text/html

Sample:

{
  "Alerts": [
    {
      "ID": "9a3aba10-330a-49d9-a428-d2e58c39f6ec",
      "LastHandled": "2026-08-07T08:28:19.8161822+10:00",
      "Message": "sample string 2",
      "AlertType": 0,
      "AlertDate": "2026-08-07T08:28:19.8161822+10:00",
      "RepeatCounter": 4,
      "Category": "sample string 5",
      "SubCategory": "sample string 6",
      "IsEmail": true,
      "IsSMS": true,
      "RequiresAcknowledgement": true,
      "AcknowledgedDate": "2026-08-07T08:28:19.8161822+10:00",
      "AcknowledgementUserId": "1b89b2a5-b6d4-4467-b6f6-451b02c63f2b",
      "ResendWaitTimeMinutes": 10,
      "ObjectType": 10,
      "ObjectId": "5fe1d3bd-fd24-461e-8fa0-ab1c191e6aac",
      "IgnoreDate": "2026-08-07T08:28:19.8161822+10:00",
      "SourceID": 1,
      "SourceType": 0,
      "AlertRecipients": [
        {
          "AlertId": "99e50b84-fe35-4179-a1ed-b5d7b8c270af",
          "GetsEmail": true,
          "GetsSMS": true,
          "EmailSent": "2026-08-07T08:28:19.8161822+10:00",
          "SMSSent": "2026-08-07T08:28:19.8161822+10:00"
        },
        {
          "AlertId": "99e50b84-fe35-4179-a1ed-b5d7b8c270af",
          "GetsEmail": true,
          "GetsSMS": true,
          "EmailSent": "2026-08-07T08:28:19.8161822+10:00",
          "SMSSent": "2026-08-07T08:28:19.8161822+10:00"
        }
      ]
    },
    {
      "ID": "9a3aba10-330a-49d9-a428-d2e58c39f6ec",
      "LastHandled": "2026-08-07T08:28:19.8161822+10:00",
      "Message": "sample string 2",
      "AlertType": 0,
      "AlertDate": "2026-08-07T08:28:19.8161822+10:00",
      "RepeatCounter": 4,
      "Category": "sample string 5",
      "SubCategory": "sample string 6",
      "IsEmail": true,
      "IsSMS": true,
      "RequiresAcknowledgement": true,
      "AcknowledgedDate": "2026-08-07T08:28:19.8161822+10:00",
      "AcknowledgementUserId": "1b89b2a5-b6d4-4467-b6f6-451b02c63f2b",
      "ResendWaitTimeMinutes": 10,
      "ObjectType": 10,
      "ObjectId": "5fe1d3bd-fd24-461e-8fa0-ab1c191e6aac",
      "IgnoreDate": "2026-08-07T08:28:19.8161822+10:00",
      "SourceID": 1,
      "SourceType": 0,
      "AlertRecipients": [
        {
          "AlertId": "99e50b84-fe35-4179-a1ed-b5d7b8c270af",
          "GetsEmail": true,
          "GetsSMS": true,
          "EmailSent": "2026-08-07T08:28:19.8161822+10:00",
          "SMSSent": "2026-08-07T08:28:19.8161822+10:00"
        },
        {
          "AlertId": "99e50b84-fe35-4179-a1ed-b5d7b8c270af",
          "GetsEmail": true,
          "GetsSMS": true,
          "EmailSent": "2026-08-07T08:28:19.8161822+10:00",
          "SMSSent": "2026-08-07T08:28:19.8161822+10:00"
        }
      ]
    }
  ],
  "Messages": [
    {
      "Severity": 0,
      "MessageCode": 1,
      "CodeDesc": 2,
      "MessageText": "sample string 3",
      "RecordNumber": 4
    },
    {
      "Severity": 0,
      "MessageCode": 1,
      "CodeDesc": 2,
      "MessageText": "sample string 3",
      "RecordNumber": 4
    }
  ],
  "ServerInformation": {
    "CurrentTimeUTC": "2026-08-07T08:28:19.8161822+10:00",
    "BuildDateUTC": "2026-08-07T08:28:19.8161822+10:00"
  },
  "VersionInformation": {
    "Major": 1,
    "Minor": 8,
    "Hotfix": 0,
    "Beta": true,
    "Version": "1.8.0.BETA"
  }
}