POST api/v1/alerts

Raise a new alert.

Request Information

URI Parameters

None.

Body Parameters

Name	Description	Type	Additional information
Message		string	None.
Level		AlertLevel	None.
Distribution		DistributionLevel	None.
UserId	If the distribution is user, then we need to user Id to assign the alert to.	globally unique identifier	None.
ActionRequired		boolean	None.

Request Formats

application/json, text/json, application/senml+json

Sample:

{
  "Message": "sample string 1",
  "Level": 0,
  "Distribution": 0,
  "UserId": "7a6979d8-a02f-4ea6-a09f-279e813df9e4",
  "ActionRequired": true,
  "Tags": [
    "sample string 1",
    "sample string 2"
  ],
  "Lite": true
}

application/xml, text/xml

Sample:

<RaiseAlertViewModel xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/AnalysisUK.Tinamous.www.ApiControllers.Models.Alerts">
  <ActionRequired>true</ActionRequired>
  <Distribution>All</Distribution>
  <Level>Warning</Level>
  <Lite>true</Lite>
  <Message>sample string 1</Message>
  <Tags xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <d2p1:string>sample string 1</d2p1:string>
    <d2p1:string>sample string 2</d2p1:string>
  </Tags>
  <UserId>7a6979d8-a02f-4ea6-a09f-279e813df9e4</UserId>
</RaiseAlertViewModel>

application/x-www-form-urlencoded

Sample:

Sample not available.

Response Information

Resource Description

AlertViewModel

Name	Description	Type	Additional information
Id	Unique identifier of the alert.	globally unique identifier	None.
Url		string	None.
Message	The alert message.	string	None.
ActionRequired	If action is required.	boolean	None.
Level	The level of the alert.	AlertLevel	None.
Distribution	Who the alert should be distributed to.	DistributionLevel	None.
Cleared	If the alert has been cleared.	boolean	None.
DateAdded	When the alert was raised/added to the system.	date	None.
LastUpdated	When the alert was last updated.	date	None.
RaisedById	Here to help the population of RaisedBy	globally unique identifier	None.
RaisedByUser	Model of the user who raised the alert.	UserDto	None.
MoreLink	Additional links.	LinkDto	None.
Links		Collection of LinkDto	None.
AssignedToUserId		globally unique identifier	None.
RaisedByUserId		globally unique identifier	None.
PostedOn		date	None.
Tags		Collection of string	None.
Private		boolean	None.

Response Formats

application/json, text/json, application/senml+json

Sample:

{
  "Id": "59fd5665-f243-424d-a483-7746d1fd9189",
  "Url": "sample string 2",
  "Message": "sample string 3",
  "ActionRequired": true,
  "Level": "Warning",
  "Distribution": "All",
  "Cleared": true,
  "DateAdded": "2025-11-04T10:40:43.7821317+00:00",
  "LastUpdated": "2025-11-04T10:40:43.7821317+00:00",
  "RaisedById": "ff977666-2907-4619-baaf-10d0edeb1898",
  "RaisedByUser": {
    "Id": "2cf97d9c-044d-4dd3-b5b0-3cd38c3d4a94",
    "Url": "sample string 2",
    "AccountId": "sample string 3",
    "Name": "sample string 4",
    "UserName": "sample string 5",
    "FullUserName": "sample string 6",
    "DisplayName": "sample string 7",
    "Avatar": {
      "Href": "sample string 1",
      "Rel": "sample string 2",
      "Action": "sample string 3"
    },
    "TimeLine": {
      "Href": "sample string 1",
      "Rel": "sample string 2",
      "Action": "sample string 3"
    },
    "Profile": {
      "Href": "sample string 1",
      "Rel": "sample string 2",
      "Action": "sample string 3"
    },
    "Tags": [
      "sample string 1",
      "sample string 2"
    ],
    "Links": [
      {
        "Href": "sample string 1",
        "Rel": "sample string 2",
        "Action": "sample string 3"
      },
      {
        "Href": "sample string 1",
        "Rel": "sample string 2",
        "Action": "sample string 3"
      }
    ],
    "Actions": [
      {
        "Href": "sample string 1",
        "Rel": "sample string 2",
        "Action": "sample string 3"
      },
      {
        "Href": "sample string 1",
        "Rel": "sample string 2",
        "Action": "sample string 3"
      }
    ]
  },
  "MoreLink": {
    "Href": "sample string 1",
    "Rel": "sample string 2",
    "Action": "sample string 3"
  },
  "Links": [
    {
      "Href": "sample string 1",
      "Rel": "sample string 2",
      "Action": "sample string 3"
    },
    {
      "Href": "sample string 1",
      "Rel": "sample string 2",
      "Action": "sample string 3"
    }
  ],
  "AssignedToUserId": "b0045cc8-6417-4cf9-948e-201f3ee1aa5a",
  "RaisedByUserId": "26c4d2f3-0654-49b2-abb1-bf50cd3f609f",
  "PostedOn": "2025-11-04T10:40:43.7821317+00:00",
  "Tags": [
    "sample string 1",
    "sample string 2"
  ],
  "Private": true
}

application/xml, text/xml

Sample:

<AlertViewModel xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/AnalysisUK.Tinamous.www.ApiControllers.Models.Alerts">
  <ActionRequired>true</ActionRequired>
  <AssignedToUserId>b0045cc8-6417-4cf9-948e-201f3ee1aa5a</AssignedToUserId>
  <Cleared>true</Cleared>
  <DateAdded>2025-11-04T10:40:43.7821317+00:00</DateAdded>
  <Distribution>All</Distribution>
  <Id>59fd5665-f243-424d-a483-7746d1fd9189</Id>
  <LastUpdated>2025-11-04T10:40:43.7821317+00:00</LastUpdated>
  <Level>Warning</Level>
  <Links xmlns:d2p1="http://schemas.datacontract.org/2004/07/AnalysisUK.Tinamous.www.ApiControllers.Models.Shared">
    <d2p1:LinkViewModel>
      <d2p1:Action>sample string 3</d2p1:Action>
      <d2p1:Href>sample string 1</d2p1:Href>
      <d2p1:Rel>sample string 2</d2p1:Rel>
    </d2p1:LinkViewModel>
    <d2p1:LinkViewModel>
      <d2p1:Action>sample string 3</d2p1:Action>
      <d2p1:Href>sample string 1</d2p1:Href>
      <d2p1:Rel>sample string 2</d2p1:Rel>
    </d2p1:LinkViewModel>
  </Links>
  <Message>sample string 3</Message>
  <MoreLink xmlns:d2p1="http://schemas.datacontract.org/2004/07/AnalysisUK.Tinamous.www.ApiControllers.Models.Shared">
    <d2p1:Action>sample string 3</d2p1:Action>
    <d2p1:Href>sample string 1</d2p1:Href>
    <d2p1:Rel>sample string 2</d2p1:Rel>
  </MoreLink>
  <PostedOn>2025-11-04T10:40:43.7821317+00:00</PostedOn>
  <Private>true</Private>
  <RaisedById>ff977666-2907-4619-baaf-10d0edeb1898</RaisedById>
  <RaisedByUser xmlns:d2p1="http://schemas.datacontract.org/2004/07/AnalysisUK.Tinamous.www.ApiControllers.Models.Shared">
    <d2p1:AccountId>sample string 3</d2p1:AccountId>
    <d2p1:Actions>
      <d2p1:LinkViewModel>
        <d2p1:Action>sample string 3</d2p1:Action>
        <d2p1:Href>sample string 1</d2p1:Href>
        <d2p1:Rel>sample string 2</d2p1:Rel>
      </d2p1:LinkViewModel>
      <d2p1:LinkViewModel>
        <d2p1:Action>sample string 3</d2p1:Action>
        <d2p1:Href>sample string 1</d2p1:Href>
        <d2p1:Rel>sample string 2</d2p1:Rel>
      </d2p1:LinkViewModel>
    </d2p1:Actions>
    <d2p1:Avatar>
      <d2p1:Action>sample string 3</d2p1:Action>
      <d2p1:Href>sample string 1</d2p1:Href>
      <d2p1:Rel>sample string 2</d2p1:Rel>
    </d2p1:Avatar>
    <d2p1:DisplayName>sample string 7</d2p1:DisplayName>
    <d2p1:FullUserName>sample string 6</d2p1:FullUserName>
    <d2p1:Id>2cf97d9c-044d-4dd3-b5b0-3cd38c3d4a94</d2p1:Id>
    <d2p1:Links>
      <d2p1:LinkViewModel>
        <d2p1:Action>sample string 3</d2p1:Action>
        <d2p1:Href>sample string 1</d2p1:Href>
        <d2p1:Rel>sample string 2</d2p1:Rel>
      </d2p1:LinkViewModel>
      <d2p1:LinkViewModel>
        <d2p1:Action>sample string 3</d2p1:Action>
        <d2p1:Href>sample string 1</d2p1:Href>
        <d2p1:Rel>sample string 2</d2p1:Rel>
      </d2p1:LinkViewModel>
    </d2p1:Links>
    <d2p1:Name>sample string 4</d2p1:Name>
    <d2p1:Profile>
      <d2p1:Action>sample string 3</d2p1:Action>
      <d2p1:Href>sample string 1</d2p1:Href>
      <d2p1:Rel>sample string 2</d2p1:Rel>
    </d2p1:Profile>
    <d2p1:Tags xmlns:d3p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
      <d3p1:string>sample string 1</d3p1:string>
      <d3p1:string>sample string 2</d3p1:string>
    </d2p1:Tags>
    <d2p1:TimeLine>
      <d2p1:Action>sample string 3</d2p1:Action>
      <d2p1:Href>sample string 1</d2p1:Href>
      <d2p1:Rel>sample string 2</d2p1:Rel>
    </d2p1:TimeLine>
    <d2p1:Url>sample string 2</d2p1:Url>
    <d2p1:UserName>sample string 5</d2p1:UserName>
  </RaisedByUser>
  <RaisedByUserId>26c4d2f3-0654-49b2-abb1-bf50cd3f609f</RaisedByUserId>
  <Tags xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <d2p1:string>sample string 1</d2p1:string>
    <d2p1:string>sample string 2</d2p1:string>
  </Tags>
  <Url>sample string 2</Url>
</AlertViewModel>