For the complete documentation index, see llms.txt. This page is also available as Markdown.

Chat Messages

List the messages of the specified channel.

get
Authorizations
AuthorizationstringRequired

The Bearer API key of your user more info.

Path parameters
channelIdinteger · int64Required

the id of the channel the messages belong to, for the channel type ALERT this is the id of the alert

Query parameters
channel-typestring · enumRequired

the type of the channel

Possible values:
start-indexintegerOptional

index of the first item to return

Default: 0
max-resultsinteger · max: 100Optional

maximum number of items to return

Default: 25
Responses
200

the list of messages, newest first

application/json
idinteger · int64Read-onlyOptional
createdstring · date-timeRead-onlyOptional
updatedstring · date-timeRead-onlyOptional
authorTypestring · enumRead-onlyOptional

Who wrote the message: a user of the account, an ilert bot, or an external author, e.g. when the message was submitted with an event.

Possible values:
authorIdinteger · int64Read-onlyOptional

The id of the user who wrote the message. Only set when authorType is USER.

botNamestringRead-onlyOptional

The name of the bot that wrote the message. Only set when authorType is BOT.

contentstring · max: 40000Required

The text of the message. Longer content is truncated.

contentTypestring · enumRequired

The type of the content, currently only TEXT is supported.

Possible values:
messageStylestring · enumRead-onlyOptional

How the message is meant to be rendered. Messages written by users always carry the style DEFAULT. ilert uses further styles internally, e.g. for the intermediate steps of its AI agents. If you display messages in your own interface, only render those with the style DEFAULT, otherwise internal styles may show up as regular messages.

Possible values:
editedbooleanRead-onlyOptional
deletedbooleanRead-onlyOptional

Set to true once the message has been deleted. The content is replaced by a placeholder.

externalCreatorNamestringRead-onlyOptional

The name of the author as it was submitted with the event. Only set when authorType is EXTERNAL.

resolveCommentbooleanRead-onlyOptional

Set to true when the message was added while resolving the alert.

threadbooleanRead-onlyOptional

Set to true when the message has thread replies.

threadMessageCountintegerRead-onlyOptional
lastReplyDatestring · date-timeRead-onlyOptional
lastReplyAuthorTypestring · enumRead-onlyOptionalPossible values:
lastReplyAuthorIdinteger · int64Read-onlyOptional
lastReplyBotNamestringRead-onlyOptional
get/chat-channels/{channelId}/messages
GET /api/chat-channels/{channelId}/messages?channel-type=ALERT HTTP/1.1
Authorization: YOUR_API_KEY
Accept: */*
200

the list of messages, newest first

[
  {
    "id": 1,
    "created": "2026-01-01T00:00:00.000Z",
    "updated": "2026-01-01T00:00:00.000Z",
    "authorType": "USER",
    "authorId": 1,
    "botName": "text",
    "content": "text",
    "contentType": "TEXT",
    "messageStyle": "DEFAULT",
    "edited": true,
    "deleted": true,
    "reactions": [
      {
        "code": "thumbs_up",
        "count": 1,
        "users": [
          1
        ],
        "bots": [
          1
        ]
      }
    ],
    "externalCreatorName": "text",
    "resolveComment": true,
    "thread": true,
    "threadMessageCount": 1,
    "lastReplyDate": "2026-01-01T00:00:00.000Z",
    "lastReplyAuthorType": "USER",
    "lastReplyAuthorId": 1,
    "lastReplyBotName": "text"
  }
]

Create a new message in the specified channel. The author of the message is the user the API key or access token belongs to.

post
Authorizations
AuthorizationstringRequired

The Bearer API key of your user more info.

Path parameters
channelIdinteger · int64Required

the id of the channel the messages belong to, for the channel type ALERT this is the id of the alert

Query parameters
channel-typestring · enumRequired

the type of the channel

Possible values:
Body
idinteger · int64Read-onlyOptional
createdstring · date-timeRead-onlyOptional
updatedstring · date-timeRead-onlyOptional
authorTypestring · enumRead-onlyOptional

Who wrote the message: a user of the account, an ilert bot, or an external author, e.g. when the message was submitted with an event.

Possible values:
authorIdinteger · int64Read-onlyOptional

The id of the user who wrote the message. Only set when authorType is USER.

botNamestringRead-onlyOptional

The name of the bot that wrote the message. Only set when authorType is BOT.

contentstring · max: 40000Required

The text of the message. Longer content is truncated.

contentTypestring · enumRequired

The type of the content, currently only TEXT is supported.

Possible values:
messageStylestring · enumRead-onlyOptional

How the message is meant to be rendered. Messages written by users always carry the style DEFAULT. ilert uses further styles internally, e.g. for the intermediate steps of its AI agents. If you display messages in your own interface, only render those with the style DEFAULT, otherwise internal styles may show up as regular messages.

Possible values:
editedbooleanRead-onlyOptional
deletedbooleanRead-onlyOptional

Set to true once the message has been deleted. The content is replaced by a placeholder.

externalCreatorNamestringRead-onlyOptional

The name of the author as it was submitted with the event. Only set when authorType is EXTERNAL.

resolveCommentbooleanRead-onlyOptional

Set to true when the message was added while resolving the alert.

threadbooleanRead-onlyOptional

Set to true when the message has thread replies.

threadMessageCountintegerRead-onlyOptional
lastReplyDatestring · date-timeRead-onlyOptional
lastReplyAuthorTypestring · enumRead-onlyOptionalPossible values:
lastReplyAuthorIdinteger · int64Read-onlyOptional
lastReplyBotNamestringRead-onlyOptional
Responses
201

the created message

application/json
idinteger · int64Read-onlyOptional
createdstring · date-timeRead-onlyOptional
updatedstring · date-timeRead-onlyOptional
authorTypestring · enumRead-onlyOptional

Who wrote the message: a user of the account, an ilert bot, or an external author, e.g. when the message was submitted with an event.

Possible values:
authorIdinteger · int64Read-onlyOptional

The id of the user who wrote the message. Only set when authorType is USER.

botNamestringRead-onlyOptional

The name of the bot that wrote the message. Only set when authorType is BOT.

contentstring · max: 40000Required

The text of the message. Longer content is truncated.

contentTypestring · enumRequired

The type of the content, currently only TEXT is supported.

Possible values:
messageStylestring · enumRead-onlyOptional

How the message is meant to be rendered. Messages written by users always carry the style DEFAULT. ilert uses further styles internally, e.g. for the intermediate steps of its AI agents. If you display messages in your own interface, only render those with the style DEFAULT, otherwise internal styles may show up as regular messages.

Possible values:
editedbooleanRead-onlyOptional
deletedbooleanRead-onlyOptional

Set to true once the message has been deleted. The content is replaced by a placeholder.

externalCreatorNamestringRead-onlyOptional

The name of the author as it was submitted with the event. Only set when authorType is EXTERNAL.

resolveCommentbooleanRead-onlyOptional

Set to true when the message was added while resolving the alert.

threadbooleanRead-onlyOptional

Set to true when the message has thread replies.

threadMessageCountintegerRead-onlyOptional
lastReplyDatestring · date-timeRead-onlyOptional
lastReplyAuthorTypestring · enumRead-onlyOptionalPossible values:
lastReplyAuthorIdinteger · int64Read-onlyOptional
lastReplyBotNamestringRead-onlyOptional
post/chat-channels/{channelId}/messages
POST /api/chat-channels/{channelId}/messages?channel-type=ALERT HTTP/1.1
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 39

{
  "content": "text",
  "contentType": "TEXT"
}
201

the created message

{
  "id": 1,
  "created": "2026-01-01T00:00:00.000Z",
  "updated": "2026-01-01T00:00:00.000Z",
  "authorType": "USER",
  "authorId": 1,
  "botName": "text",
  "content": "text",
  "contentType": "TEXT",
  "messageStyle": "DEFAULT",
  "edited": true,
  "deleted": true,
  "reactions": [
    {
      "code": "thumbs_up",
      "count": 1,
      "users": [
        1
      ],
      "bots": [
        1
      ]
    }
  ],
  "externalCreatorName": "text",
  "resolveComment": true,
  "thread": true,
  "threadMessageCount": 1,
  "lastReplyDate": "2026-01-01T00:00:00.000Z",
  "lastReplyAuthorType": "USER",
  "lastReplyAuthorId": 1,
  "lastReplyBotName": "text"
}

Get the message with the specified id.

get
Authorizations
AuthorizationstringRequired

The Bearer API key of your user more info.

Path parameters
channelIdinteger · int64Required

the id of the channel the messages belong to, for the channel type ALERT this is the id of the alert

idinteger · int64Required

the id of the message

Query parameters
channel-typestring · enumRequired

the type of the channel

Possible values:
Responses
200

the message

application/json
idinteger · int64Read-onlyOptional
createdstring · date-timeRead-onlyOptional
updatedstring · date-timeRead-onlyOptional
authorTypestring · enumRead-onlyOptional

Who wrote the message: a user of the account, an ilert bot, or an external author, e.g. when the message was submitted with an event.

Possible values:
authorIdinteger · int64Read-onlyOptional

The id of the user who wrote the message. Only set when authorType is USER.

botNamestringRead-onlyOptional

The name of the bot that wrote the message. Only set when authorType is BOT.

contentstring · max: 40000Required

The text of the message. Longer content is truncated.

contentTypestring · enumRequired

The type of the content, currently only TEXT is supported.

Possible values:
messageStylestring · enumRead-onlyOptional

How the message is meant to be rendered. Messages written by users always carry the style DEFAULT. ilert uses further styles internally, e.g. for the intermediate steps of its AI agents. If you display messages in your own interface, only render those with the style DEFAULT, otherwise internal styles may show up as regular messages.

Possible values:
editedbooleanRead-onlyOptional
deletedbooleanRead-onlyOptional

Set to true once the message has been deleted. The content is replaced by a placeholder.

externalCreatorNamestringRead-onlyOptional

The name of the author as it was submitted with the event. Only set when authorType is EXTERNAL.

resolveCommentbooleanRead-onlyOptional

Set to true when the message was added while resolving the alert.

threadbooleanRead-onlyOptional

Set to true when the message has thread replies.

threadMessageCountintegerRead-onlyOptional
lastReplyDatestring · date-timeRead-onlyOptional
lastReplyAuthorTypestring · enumRead-onlyOptionalPossible values:
lastReplyAuthorIdinteger · int64Read-onlyOptional
lastReplyBotNamestringRead-onlyOptional
get/chat-channels/{channelId}/messages/{id}
GET /api/chat-channels/{channelId}/messages/{id}?channel-type=ALERT HTTP/1.1
Authorization: YOUR_API_KEY
Accept: */*
200

the message

{
  "id": 1,
  "created": "2026-01-01T00:00:00.000Z",
  "updated": "2026-01-01T00:00:00.000Z",
  "authorType": "USER",
  "authorId": 1,
  "botName": "text",
  "content": "text",
  "contentType": "TEXT",
  "messageStyle": "DEFAULT",
  "edited": true,
  "deleted": true,
  "reactions": [
    {
      "code": "thumbs_up",
      "count": 1,
      "users": [
        1
      ],
      "bots": [
        1
      ]
    }
  ],
  "externalCreatorName": "text",
  "resolveComment": true,
  "thread": true,
  "threadMessageCount": 1,
  "lastReplyDate": "2026-01-01T00:00:00.000Z",
  "lastReplyAuthorType": "USER",
  "lastReplyAuthorId": 1,
  "lastReplyBotName": "text"
}

Update the message with the specified id. Only the author of a message may update it.

put
Authorizations
AuthorizationstringRequired

The Bearer API key of your user more info.

Path parameters
channelIdinteger · int64Required

the id of the channel the messages belong to, for the channel type ALERT this is the id of the alert

idinteger · int64Required

the id of the message

Query parameters
channel-typestring · enumRequired

the type of the channel

Possible values:
Body
idinteger · int64Read-onlyOptional
createdstring · date-timeRead-onlyOptional
updatedstring · date-timeRead-onlyOptional
authorTypestring · enumRead-onlyOptional

Who wrote the message: a user of the account, an ilert bot, or an external author, e.g. when the message was submitted with an event.

Possible values:
authorIdinteger · int64Read-onlyOptional

The id of the user who wrote the message. Only set when authorType is USER.

botNamestringRead-onlyOptional

The name of the bot that wrote the message. Only set when authorType is BOT.

contentstring · max: 40000Required

The text of the message. Longer content is truncated.

contentTypestring · enumRequired

The type of the content, currently only TEXT is supported.

Possible values:
messageStylestring · enumRead-onlyOptional

How the message is meant to be rendered. Messages written by users always carry the style DEFAULT. ilert uses further styles internally, e.g. for the intermediate steps of its AI agents. If you display messages in your own interface, only render those with the style DEFAULT, otherwise internal styles may show up as regular messages.

Possible values:
editedbooleanRead-onlyOptional
deletedbooleanRead-onlyOptional

Set to true once the message has been deleted. The content is replaced by a placeholder.

externalCreatorNamestringRead-onlyOptional

The name of the author as it was submitted with the event. Only set when authorType is EXTERNAL.

resolveCommentbooleanRead-onlyOptional

Set to true when the message was added while resolving the alert.

threadbooleanRead-onlyOptional

Set to true when the message has thread replies.

threadMessageCountintegerRead-onlyOptional
lastReplyDatestring · date-timeRead-onlyOptional
lastReplyAuthorTypestring · enumRead-onlyOptionalPossible values:
lastReplyAuthorIdinteger · int64Read-onlyOptional
lastReplyBotNamestringRead-onlyOptional
Responses
200

the updated message

application/json
idinteger · int64Read-onlyOptional
createdstring · date-timeRead-onlyOptional
updatedstring · date-timeRead-onlyOptional
authorTypestring · enumRead-onlyOptional

Who wrote the message: a user of the account, an ilert bot, or an external author, e.g. when the message was submitted with an event.

Possible values:
authorIdinteger · int64Read-onlyOptional

The id of the user who wrote the message. Only set when authorType is USER.

botNamestringRead-onlyOptional

The name of the bot that wrote the message. Only set when authorType is BOT.

contentstring · max: 40000Required

The text of the message. Longer content is truncated.

contentTypestring · enumRequired

The type of the content, currently only TEXT is supported.

Possible values:
messageStylestring · enumRead-onlyOptional

How the message is meant to be rendered. Messages written by users always carry the style DEFAULT. ilert uses further styles internally, e.g. for the intermediate steps of its AI agents. If you display messages in your own interface, only render those with the style DEFAULT, otherwise internal styles may show up as regular messages.

Possible values:
editedbooleanRead-onlyOptional
deletedbooleanRead-onlyOptional

Set to true once the message has been deleted. The content is replaced by a placeholder.

externalCreatorNamestringRead-onlyOptional

The name of the author as it was submitted with the event. Only set when authorType is EXTERNAL.

resolveCommentbooleanRead-onlyOptional

Set to true when the message was added while resolving the alert.

threadbooleanRead-onlyOptional

Set to true when the message has thread replies.

threadMessageCountintegerRead-onlyOptional
lastReplyDatestring · date-timeRead-onlyOptional
lastReplyAuthorTypestring · enumRead-onlyOptionalPossible values:
lastReplyAuthorIdinteger · int64Read-onlyOptional
lastReplyBotNamestringRead-onlyOptional
put/chat-channels/{channelId}/messages/{id}
PUT /api/chat-channels/{channelId}/messages/{id}?channel-type=ALERT HTTP/1.1
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 39

{
  "content": "text",
  "contentType": "TEXT"
}
200

the updated message

{
  "id": 1,
  "created": "2026-01-01T00:00:00.000Z",
  "updated": "2026-01-01T00:00:00.000Z",
  "authorType": "USER",
  "authorId": 1,
  "botName": "text",
  "content": "text",
  "contentType": "TEXT",
  "messageStyle": "DEFAULT",
  "edited": true,
  "deleted": true,
  "reactions": [
    {
      "code": "thumbs_up",
      "count": 1,
      "users": [
        1
      ],
      "bots": [
        1
      ]
    }
  ],
  "externalCreatorName": "text",
  "resolveComment": true,
  "thread": true,
  "threadMessageCount": 1,
  "lastReplyDate": "2026-01-01T00:00:00.000Z",
  "lastReplyAuthorType": "USER",
  "lastReplyAuthorId": 1,
  "lastReplyBotName": "text"
}

Delete the message with the specified id. Messages are deleted softly: the message remains in the list with `deleted` set to true and its content replaced by a placeholder. Only the author of a message may delete it.

delete
Authorizations
AuthorizationstringRequired

The Bearer API key of your user more info.

Path parameters
channelIdinteger · int64Required

the id of the channel the messages belong to, for the channel type ALERT this is the id of the alert

idinteger · int64Required

the id of the message

Query parameters
channel-typestring · enumRequired

the type of the channel

Possible values:
Responses
200

the deleted message

application/json
idinteger · int64Read-onlyOptional
createdstring · date-timeRead-onlyOptional
updatedstring · date-timeRead-onlyOptional
authorTypestring · enumRead-onlyOptional

Who wrote the message: a user of the account, an ilert bot, or an external author, e.g. when the message was submitted with an event.

Possible values:
authorIdinteger · int64Read-onlyOptional

The id of the user who wrote the message. Only set when authorType is USER.

botNamestringRead-onlyOptional

The name of the bot that wrote the message. Only set when authorType is BOT.

contentstring · max: 40000Required

The text of the message. Longer content is truncated.

contentTypestring · enumRequired

The type of the content, currently only TEXT is supported.

Possible values:
messageStylestring · enumRead-onlyOptional

How the message is meant to be rendered. Messages written by users always carry the style DEFAULT. ilert uses further styles internally, e.g. for the intermediate steps of its AI agents. If you display messages in your own interface, only render those with the style DEFAULT, otherwise internal styles may show up as regular messages.

Possible values:
editedbooleanRead-onlyOptional
deletedbooleanRead-onlyOptional

Set to true once the message has been deleted. The content is replaced by a placeholder.

externalCreatorNamestringRead-onlyOptional

The name of the author as it was submitted with the event. Only set when authorType is EXTERNAL.

resolveCommentbooleanRead-onlyOptional

Set to true when the message was added while resolving the alert.

threadbooleanRead-onlyOptional

Set to true when the message has thread replies.

threadMessageCountintegerRead-onlyOptional
lastReplyDatestring · date-timeRead-onlyOptional
lastReplyAuthorTypestring · enumRead-onlyOptionalPossible values:
lastReplyAuthorIdinteger · int64Read-onlyOptional
lastReplyBotNamestringRead-onlyOptional
delete/chat-channels/{channelId}/messages/{id}
DELETE /api/chat-channels/{channelId}/messages/{id}?channel-type=ALERT HTTP/1.1
Authorization: YOUR_API_KEY
Accept: */*
200

the deleted message

{
  "id": 1,
  "created": "2026-01-01T00:00:00.000Z",
  "updated": "2026-01-01T00:00:00.000Z",
  "authorType": "USER",
  "authorId": 1,
  "botName": "text",
  "content": "text",
  "contentType": "TEXT",
  "messageStyle": "DEFAULT",
  "edited": true,
  "deleted": true,
  "reactions": [
    {
      "code": "thumbs_up",
      "count": 1,
      "users": [
        1
      ],
      "bots": [
        1
      ]
    }
  ],
  "externalCreatorName": "text",
  "resolveComment": true,
  "thread": true,
  "threadMessageCount": 1,
  "lastReplyDate": "2026-01-01T00:00:00.000Z",
  "lastReplyAuthorType": "USER",
  "lastReplyAuthorId": 1,
  "lastReplyBotName": "text"
}

Add a reaction of the authenticated user to the message with the specified id. Reacting twice with the same code, or exceeding the limit of reaction codes per message, answers 400.

post
Authorizations
AuthorizationstringRequired

The Bearer API key of your user more info.

Path parameters
channelIdinteger · int64Required

the id of the channel the messages belong to, for the channel type ALERT this is the id of the alert

idinteger · int64Required

the id of the message

Query parameters
channel-typestring · enumRequired

the type of the channel

Possible values:
Body
codestringRequired

The emoji of the reaction, written as its name in lower case with underscores, e.g. thumbs_up, red_heart, eyes or party_popper. Use the same spelling as the ilert apps, so that the reactions of a message stay together.

Example: thumbs_up
Responses
200

the updated message

application/json
idinteger · int64Read-onlyOptional
createdstring · date-timeRead-onlyOptional
updatedstring · date-timeRead-onlyOptional
authorTypestring · enumRead-onlyOptional

Who wrote the message: a user of the account, an ilert bot, or an external author, e.g. when the message was submitted with an event.

Possible values:
authorIdinteger · int64Read-onlyOptional

The id of the user who wrote the message. Only set when authorType is USER.

botNamestringRead-onlyOptional

The name of the bot that wrote the message. Only set when authorType is BOT.

contentstring · max: 40000Required

The text of the message. Longer content is truncated.

contentTypestring · enumRequired

The type of the content, currently only TEXT is supported.

Possible values:
messageStylestring · enumRead-onlyOptional

How the message is meant to be rendered. Messages written by users always carry the style DEFAULT. ilert uses further styles internally, e.g. for the intermediate steps of its AI agents. If you display messages in your own interface, only render those with the style DEFAULT, otherwise internal styles may show up as regular messages.

Possible values:
editedbooleanRead-onlyOptional
deletedbooleanRead-onlyOptional

Set to true once the message has been deleted. The content is replaced by a placeholder.

externalCreatorNamestringRead-onlyOptional

The name of the author as it was submitted with the event. Only set when authorType is EXTERNAL.

resolveCommentbooleanRead-onlyOptional

Set to true when the message was added while resolving the alert.

threadbooleanRead-onlyOptional

Set to true when the message has thread replies.

threadMessageCountintegerRead-onlyOptional
lastReplyDatestring · date-timeRead-onlyOptional
lastReplyAuthorTypestring · enumRead-onlyOptionalPossible values:
lastReplyAuthorIdinteger · int64Read-onlyOptional
lastReplyBotNamestringRead-onlyOptional
post/chat-channels/{channelId}/messages/{id}/reactions
POST /api/chat-channels/{channelId}/messages/{id}/reactions?channel-type=ALERT HTTP/1.1
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 20

{
  "code": "thumbs_up"
}
200

the updated message

{
  "id": 1,
  "created": "2026-01-01T00:00:00.000Z",
  "updated": "2026-01-01T00:00:00.000Z",
  "authorType": "USER",
  "authorId": 1,
  "botName": "text",
  "content": "text",
  "contentType": "TEXT",
  "messageStyle": "DEFAULT",
  "edited": true,
  "deleted": true,
  "reactions": [
    {
      "code": "thumbs_up",
      "count": 1,
      "users": [
        1
      ],
      "bots": [
        1
      ]
    }
  ],
  "externalCreatorName": "text",
  "resolveComment": true,
  "thread": true,
  "threadMessageCount": 1,
  "lastReplyDate": "2026-01-01T00:00:00.000Z",
  "lastReplyAuthorType": "USER",
  "lastReplyAuthorId": 1,
  "lastReplyBotName": "text"
}

Remove the reaction of the authenticated user from the message with the specified id.

delete
Authorizations
AuthorizationstringRequired

The Bearer API key of your user more info.

Path parameters
channelIdinteger · int64Required

the id of the channel the messages belong to, for the channel type ALERT this is the id of the alert

idinteger · int64Required

the id of the message

codestringRequired

the code of the reaction to remove, e.g. thumbs_up

Example: thumbs_up
Query parameters
channel-typestring · enumRequired

the type of the channel

Possible values:
Responses
200

the updated message

application/json
idinteger · int64Read-onlyOptional
createdstring · date-timeRead-onlyOptional
updatedstring · date-timeRead-onlyOptional
authorTypestring · enumRead-onlyOptional

Who wrote the message: a user of the account, an ilert bot, or an external author, e.g. when the message was submitted with an event.

Possible values:
authorIdinteger · int64Read-onlyOptional

The id of the user who wrote the message. Only set when authorType is USER.

botNamestringRead-onlyOptional

The name of the bot that wrote the message. Only set when authorType is BOT.

contentstring · max: 40000Required

The text of the message. Longer content is truncated.

contentTypestring · enumRequired

The type of the content, currently only TEXT is supported.

Possible values:
messageStylestring · enumRead-onlyOptional

How the message is meant to be rendered. Messages written by users always carry the style DEFAULT. ilert uses further styles internally, e.g. for the intermediate steps of its AI agents. If you display messages in your own interface, only render those with the style DEFAULT, otherwise internal styles may show up as regular messages.

Possible values:
editedbooleanRead-onlyOptional
deletedbooleanRead-onlyOptional

Set to true once the message has been deleted. The content is replaced by a placeholder.

externalCreatorNamestringRead-onlyOptional

The name of the author as it was submitted with the event. Only set when authorType is EXTERNAL.

resolveCommentbooleanRead-onlyOptional

Set to true when the message was added while resolving the alert.

threadbooleanRead-onlyOptional

Set to true when the message has thread replies.

threadMessageCountintegerRead-onlyOptional
lastReplyDatestring · date-timeRead-onlyOptional
lastReplyAuthorTypestring · enumRead-onlyOptionalPossible values:
lastReplyAuthorIdinteger · int64Read-onlyOptional
lastReplyBotNamestringRead-onlyOptional
delete/chat-channels/{channelId}/messages/{id}/reactions/{code}
DELETE /api/chat-channels/{channelId}/messages/{id}/reactions/{code}?channel-type=ALERT HTTP/1.1
Authorization: YOUR_API_KEY
Accept: */*
200

the updated message

{
  "id": 1,
  "created": "2026-01-01T00:00:00.000Z",
  "updated": "2026-01-01T00:00:00.000Z",
  "authorType": "USER",
  "authorId": 1,
  "botName": "text",
  "content": "text",
  "contentType": "TEXT",
  "messageStyle": "DEFAULT",
  "edited": true,
  "deleted": true,
  "reactions": [
    {
      "code": "thumbs_up",
      "count": 1,
      "users": [
        1
      ],
      "bots": [
        1
      ]
    }
  ],
  "externalCreatorName": "text",
  "resolveComment": true,
  "thread": true,
  "threadMessageCount": 1,
  "lastReplyDate": "2026-01-01T00:00:00.000Z",
  "lastReplyAuthorType": "USER",
  "lastReplyAuthorId": 1,
  "lastReplyBotName": "text"
}

List the replies of the specified thread, newest first.

get
Authorizations
AuthorizationstringRequired

The Bearer API key of your user more info.

Path parameters
channelIdinteger · int64Required

the id of the channel the messages belong to, for the channel type ALERT this is the id of the alert

threadIdinteger · int64Required

the id of the message that opens the thread

Query parameters
channel-typestring · enumRequired

the type of the channel

Possible values:
start-indexintegerOptional

index of the first item to return

Default: 0
max-resultsinteger · max: 100Optional

maximum number of items to return

Default: 25
Responses
200

the list of thread replies

application/json
idinteger · int64Read-onlyOptional
createdstring · date-timeRead-onlyOptional
updatedstring · date-timeRead-onlyOptional
authorTypestring · enumRead-onlyOptional

Who wrote the message: a user of the account, an ilert bot, or an external author, e.g. when the message was submitted with an event.

Possible values:
authorIdinteger · int64Read-onlyOptional

The id of the user who wrote the message. Only set when authorType is USER.

botNamestringRead-onlyOptional

The name of the bot that wrote the message. Only set when authorType is BOT.

contentstring · max: 40000Required

The text of the message. Longer content is truncated.

contentTypestring · enumRequired

The type of the content, currently only TEXT is supported.

Possible values:
messageStylestring · enumRead-onlyOptional

How the message is meant to be rendered. Messages written by users always carry the style DEFAULT. ilert uses further styles internally, e.g. for the intermediate steps of its AI agents. If you display messages in your own interface, only render those with the style DEFAULT, otherwise internal styles may show up as regular messages.

Possible values:
editedbooleanRead-onlyOptional
deletedbooleanRead-onlyOptional

Set to true once the message has been deleted. The content is replaced by a placeholder.

threadIdinteger · int64Read-onlyOptional

The id of the message this reply belongs to.

get/chat-channels/{channelId}/messages/{threadId}/thread-replies
GET /api/chat-channels/{channelId}/messages/{threadId}/thread-replies?channel-type=ALERT HTTP/1.1
Authorization: YOUR_API_KEY
Accept: */*
200

the list of thread replies

[
  {
    "id": 1,
    "created": "2026-01-01T00:00:00.000Z",
    "updated": "2026-01-01T00:00:00.000Z",
    "authorType": "USER",
    "authorId": 1,
    "botName": "text",
    "content": "text",
    "contentType": "TEXT",
    "messageStyle": "DEFAULT",
    "edited": true,
    "deleted": true,
    "reactions": [
      {
        "code": "thumbs_up",
        "count": 1,
        "users": [
          1
        ],
        "bots": [
          1
        ]
      }
    ],
    "threadId": 1
  }
]

Reply to the specified message. The first reply turns the message into a thread. The author of the reply is the user the API key or access token belongs to.

post
Authorizations
AuthorizationstringRequired

The Bearer API key of your user more info.

Path parameters
channelIdinteger · int64Required

the id of the channel the messages belong to, for the channel type ALERT this is the id of the alert

threadIdinteger · int64Required

the id of the message that opens the thread

Query parameters
channel-typestring · enumRequired

the type of the channel

Possible values:
Body
idinteger · int64Read-onlyOptional
createdstring · date-timeRead-onlyOptional
updatedstring · date-timeRead-onlyOptional
authorTypestring · enumRead-onlyOptional

Who wrote the message: a user of the account, an ilert bot, or an external author, e.g. when the message was submitted with an event.

Possible values:
authorIdinteger · int64Read-onlyOptional

The id of the user who wrote the message. Only set when authorType is USER.

botNamestringRead-onlyOptional

The name of the bot that wrote the message. Only set when authorType is BOT.

contentstring · max: 40000Required

The text of the message. Longer content is truncated.

contentTypestring · enumRequired

The type of the content, currently only TEXT is supported.

Possible values:
messageStylestring · enumRead-onlyOptional

How the message is meant to be rendered. Messages written by users always carry the style DEFAULT. ilert uses further styles internally, e.g. for the intermediate steps of its AI agents. If you display messages in your own interface, only render those with the style DEFAULT, otherwise internal styles may show up as regular messages.

Possible values:
editedbooleanRead-onlyOptional
deletedbooleanRead-onlyOptional

Set to true once the message has been deleted. The content is replaced by a placeholder.

threadIdinteger · int64Read-onlyOptional

The id of the message this reply belongs to.

Responses
201

the created thread reply

application/json
idinteger · int64Read-onlyOptional
createdstring · date-timeRead-onlyOptional
updatedstring · date-timeRead-onlyOptional
authorTypestring · enumRead-onlyOptional

Who wrote the message: a user of the account, an ilert bot, or an external author, e.g. when the message was submitted with an event.

Possible values:
authorIdinteger · int64Read-onlyOptional

The id of the user who wrote the message. Only set when authorType is USER.

botNamestringRead-onlyOptional

The name of the bot that wrote the message. Only set when authorType is BOT.

contentstring · max: 40000Required

The text of the message. Longer content is truncated.

contentTypestring · enumRequired

The type of the content, currently only TEXT is supported.

Possible values:
messageStylestring · enumRead-onlyOptional

How the message is meant to be rendered. Messages written by users always carry the style DEFAULT. ilert uses further styles internally, e.g. for the intermediate steps of its AI agents. If you display messages in your own interface, only render those with the style DEFAULT, otherwise internal styles may show up as regular messages.

Possible values:
editedbooleanRead-onlyOptional
deletedbooleanRead-onlyOptional

Set to true once the message has been deleted. The content is replaced by a placeholder.

threadIdinteger · int64Read-onlyOptional

The id of the message this reply belongs to.

post/chat-channels/{channelId}/messages/{threadId}/thread-replies
POST /api/chat-channels/{channelId}/messages/{threadId}/thread-replies?channel-type=ALERT HTTP/1.1
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 39

{
  "content": "text",
  "contentType": "TEXT"
}
201

the created thread reply

{
  "id": 1,
  "created": "2026-01-01T00:00:00.000Z",
  "updated": "2026-01-01T00:00:00.000Z",
  "authorType": "USER",
  "authorId": 1,
  "botName": "text",
  "content": "text",
  "contentType": "TEXT",
  "messageStyle": "DEFAULT",
  "edited": true,
  "deleted": true,
  "reactions": [
    {
      "code": "thumbs_up",
      "count": 1,
      "users": [
        1
      ],
      "bots": [
        1
      ]
    }
  ],
  "threadId": 1
}

Get the thread reply with the specified id.

get
Authorizations
AuthorizationstringRequired

The Bearer API key of your user more info.

Path parameters
channelIdinteger · int64Required

the id of the channel the messages belong to, for the channel type ALERT this is the id of the alert

threadIdinteger · int64Required

the id of the message that opens the thread

idinteger · int64Required

the id of the thread reply

Query parameters
channel-typestring · enumRequired

the type of the channel

Possible values:
Responses
200

the thread reply

application/json
idinteger · int64Read-onlyOptional
createdstring · date-timeRead-onlyOptional
updatedstring · date-timeRead-onlyOptional
authorTypestring · enumRead-onlyOptional

Who wrote the message: a user of the account, an ilert bot, or an external author, e.g. when the message was submitted with an event.

Possible values:
authorIdinteger · int64Read-onlyOptional

The id of the user who wrote the message. Only set when authorType is USER.

botNamestringRead-onlyOptional

The name of the bot that wrote the message. Only set when authorType is BOT.

contentstring · max: 40000Required

The text of the message. Longer content is truncated.

contentTypestring · enumRequired

The type of the content, currently only TEXT is supported.

Possible values:
messageStylestring · enumRead-onlyOptional

How the message is meant to be rendered. Messages written by users always carry the style DEFAULT. ilert uses further styles internally, e.g. for the intermediate steps of its AI agents. If you display messages in your own interface, only render those with the style DEFAULT, otherwise internal styles may show up as regular messages.

Possible values:
editedbooleanRead-onlyOptional
deletedbooleanRead-onlyOptional

Set to true once the message has been deleted. The content is replaced by a placeholder.

threadIdinteger · int64Read-onlyOptional

The id of the message this reply belongs to.

get/chat-channels/{channelId}/messages/{threadId}/thread-replies/{id}
GET /api/chat-channels/{channelId}/messages/{threadId}/thread-replies/{id}?channel-type=ALERT HTTP/1.1
Authorization: YOUR_API_KEY
Accept: */*
200

the thread reply

{
  "id": 1,
  "created": "2026-01-01T00:00:00.000Z",
  "updated": "2026-01-01T00:00:00.000Z",
  "authorType": "USER",
  "authorId": 1,
  "botName": "text",
  "content": "text",
  "contentType": "TEXT",
  "messageStyle": "DEFAULT",
  "edited": true,
  "deleted": true,
  "reactions": [
    {
      "code": "thumbs_up",
      "count": 1,
      "users": [
        1
      ],
      "bots": [
        1
      ]
    }
  ],
  "threadId": 1
}

Update the thread reply with the specified id. Only the author of a thread reply may update it.

put
Authorizations
AuthorizationstringRequired

The Bearer API key of your user more info.

Path parameters
channelIdinteger · int64Required

the id of the channel the messages belong to, for the channel type ALERT this is the id of the alert

threadIdinteger · int64Required

the id of the message that opens the thread

idinteger · int64Required

the id of the thread reply

Query parameters
channel-typestring · enumRequired

the type of the channel

Possible values:
Body
idinteger · int64Read-onlyOptional
createdstring · date-timeRead-onlyOptional
updatedstring · date-timeRead-onlyOptional
authorTypestring · enumRead-onlyOptional

Who wrote the message: a user of the account, an ilert bot, or an external author, e.g. when the message was submitted with an event.

Possible values:
authorIdinteger · int64Read-onlyOptional

The id of the user who wrote the message. Only set when authorType is USER.

botNamestringRead-onlyOptional

The name of the bot that wrote the message. Only set when authorType is BOT.

contentstring · max: 40000Required

The text of the message. Longer content is truncated.

contentTypestring · enumRequired

The type of the content, currently only TEXT is supported.

Possible values:
messageStylestring · enumRead-onlyOptional

How the message is meant to be rendered. Messages written by users always carry the style DEFAULT. ilert uses further styles internally, e.g. for the intermediate steps of its AI agents. If you display messages in your own interface, only render those with the style DEFAULT, otherwise internal styles may show up as regular messages.

Possible values:
editedbooleanRead-onlyOptional
deletedbooleanRead-onlyOptional

Set to true once the message has been deleted. The content is replaced by a placeholder.

threadIdinteger · int64Read-onlyOptional

The id of the message this reply belongs to.

Responses
200

the updated thread reply

application/json
idinteger · int64Read-onlyOptional
createdstring · date-timeRead-onlyOptional
updatedstring · date-timeRead-onlyOptional
authorTypestring · enumRead-onlyOptional

Who wrote the message: a user of the account, an ilert bot, or an external author, e.g. when the message was submitted with an event.

Possible values:
authorIdinteger · int64Read-onlyOptional

The id of the user who wrote the message. Only set when authorType is USER.

botNamestringRead-onlyOptional

The name of the bot that wrote the message. Only set when authorType is BOT.

contentstring · max: 40000Required

The text of the message. Longer content is truncated.

contentTypestring · enumRequired

The type of the content, currently only TEXT is supported.

Possible values:
messageStylestring · enumRead-onlyOptional

How the message is meant to be rendered. Messages written by users always carry the style DEFAULT. ilert uses further styles internally, e.g. for the intermediate steps of its AI agents. If you display messages in your own interface, only render those with the style DEFAULT, otherwise internal styles may show up as regular messages.

Possible values:
editedbooleanRead-onlyOptional
deletedbooleanRead-onlyOptional

Set to true once the message has been deleted. The content is replaced by a placeholder.

threadIdinteger · int64Read-onlyOptional

The id of the message this reply belongs to.

put/chat-channels/{channelId}/messages/{threadId}/thread-replies/{id}
PUT /api/chat-channels/{channelId}/messages/{threadId}/thread-replies/{id}?channel-type=ALERT HTTP/1.1
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 39

{
  "content": "text",
  "contentType": "TEXT"
}
200

the updated thread reply

{
  "id": 1,
  "created": "2026-01-01T00:00:00.000Z",
  "updated": "2026-01-01T00:00:00.000Z",
  "authorType": "USER",
  "authorId": 1,
  "botName": "text",
  "content": "text",
  "contentType": "TEXT",
  "messageStyle": "DEFAULT",
  "edited": true,
  "deleted": true,
  "reactions": [
    {
      "code": "thumbs_up",
      "count": 1,
      "users": [
        1
      ],
      "bots": [
        1
      ]
    }
  ],
  "threadId": 1
}

Delete the thread reply with the specified id. Thread replies are deleted softly: the reply remains in the list with `deleted` set to true and its content replaced by a placeholder. Only the author of a thread reply may delete it.

delete
Authorizations
AuthorizationstringRequired

The Bearer API key of your user more info.

Path parameters
channelIdinteger · int64Required

the id of the channel the messages belong to, for the channel type ALERT this is the id of the alert

threadIdinteger · int64Required

the id of the message that opens the thread

idinteger · int64Required

the id of the thread reply

Query parameters
channel-typestring · enumRequired

the type of the channel

Possible values:
Responses
200

the deleted thread reply

application/json
idinteger · int64Read-onlyOptional
createdstring · date-timeRead-onlyOptional
updatedstring · date-timeRead-onlyOptional
authorTypestring · enumRead-onlyOptional

Who wrote the message: a user of the account, an ilert bot, or an external author, e.g. when the message was submitted with an event.

Possible values:
authorIdinteger · int64Read-onlyOptional

The id of the user who wrote the message. Only set when authorType is USER.

botNamestringRead-onlyOptional

The name of the bot that wrote the message. Only set when authorType is BOT.

contentstring · max: 40000Required

The text of the message. Longer content is truncated.

contentTypestring · enumRequired

The type of the content, currently only TEXT is supported.

Possible values:
messageStylestring · enumRead-onlyOptional

How the message is meant to be rendered. Messages written by users always carry the style DEFAULT. ilert uses further styles internally, e.g. for the intermediate steps of its AI agents. If you display messages in your own interface, only render those with the style DEFAULT, otherwise internal styles may show up as regular messages.

Possible values:
editedbooleanRead-onlyOptional
deletedbooleanRead-onlyOptional

Set to true once the message has been deleted. The content is replaced by a placeholder.

threadIdinteger · int64Read-onlyOptional

The id of the message this reply belongs to.

delete/chat-channels/{channelId}/messages/{threadId}/thread-replies/{id}
DELETE /api/chat-channels/{channelId}/messages/{threadId}/thread-replies/{id}?channel-type=ALERT HTTP/1.1
Authorization: YOUR_API_KEY
Accept: */*
200

the deleted thread reply

{
  "id": 1,
  "created": "2026-01-01T00:00:00.000Z",
  "updated": "2026-01-01T00:00:00.000Z",
  "authorType": "USER",
  "authorId": 1,
  "botName": "text",
  "content": "text",
  "contentType": "TEXT",
  "messageStyle": "DEFAULT",
  "edited": true,
  "deleted": true,
  "reactions": [
    {
      "code": "thumbs_up",
      "count": 1,
      "users": [
        1
      ],
      "bots": [
        1
      ]
    }
  ],
  "threadId": 1
}

Add a reaction of the authenticated user to the thread reply with the specified id. Reacting twice with the same code, or exceeding the limit of reaction codes per thread reply, answers 400.

post
Authorizations
AuthorizationstringRequired

The Bearer API key of your user more info.

Path parameters
channelIdinteger · int64Required

the id of the channel the messages belong to, for the channel type ALERT this is the id of the alert

threadIdinteger · int64Required

the id of the message that opens the thread

idinteger · int64Required

the id of the thread reply

Query parameters
channel-typestring · enumRequired

the type of the channel

Possible values:
Body
codestringRequired

The emoji of the reaction, written as its name in lower case with underscores, e.g. thumbs_up, red_heart, eyes or party_popper. Use the same spelling as the ilert apps, so that the reactions of a message stay together.

Example: thumbs_up
Responses
200

the updated thread reply

application/json
idinteger · int64Read-onlyOptional
createdstring · date-timeRead-onlyOptional
updatedstring · date-timeRead-onlyOptional
authorTypestring · enumRead-onlyOptional

Who wrote the message: a user of the account, an ilert bot, or an external author, e.g. when the message was submitted with an event.

Possible values:
authorIdinteger · int64Read-onlyOptional

The id of the user who wrote the message. Only set when authorType is USER.

botNamestringRead-onlyOptional

The name of the bot that wrote the message. Only set when authorType is BOT.

contentstring · max: 40000Required

The text of the message. Longer content is truncated.

contentTypestring · enumRequired

The type of the content, currently only TEXT is supported.

Possible values:
messageStylestring · enumRead-onlyOptional

How the message is meant to be rendered. Messages written by users always carry the style DEFAULT. ilert uses further styles internally, e.g. for the intermediate steps of its AI agents. If you display messages in your own interface, only render those with the style DEFAULT, otherwise internal styles may show up as regular messages.

Possible values:
editedbooleanRead-onlyOptional
deletedbooleanRead-onlyOptional

Set to true once the message has been deleted. The content is replaced by a placeholder.

threadIdinteger · int64Read-onlyOptional

The id of the message this reply belongs to.

post/chat-channels/{channelId}/messages/{threadId}/thread-replies/{id}/reactions
POST /api/chat-channels/{channelId}/messages/{threadId}/thread-replies/{id}/reactions?channel-type=ALERT HTTP/1.1
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 20

{
  "code": "thumbs_up"
}
200

the updated thread reply

{
  "id": 1,
  "created": "2026-01-01T00:00:00.000Z",
  "updated": "2026-01-01T00:00:00.000Z",
  "authorType": "USER",
  "authorId": 1,
  "botName": "text",
  "content": "text",
  "contentType": "TEXT",
  "messageStyle": "DEFAULT",
  "edited": true,
  "deleted": true,
  "reactions": [
    {
      "code": "thumbs_up",
      "count": 1,
      "users": [
        1
      ],
      "bots": [
        1
      ]
    }
  ],
  "threadId": 1
}

Remove the reaction of the authenticated user from the thread reply with the specified id.

delete
Authorizations
AuthorizationstringRequired

The Bearer API key of your user more info.

Path parameters
channelIdinteger · int64Required

the id of the channel the messages belong to, for the channel type ALERT this is the id of the alert

threadIdinteger · int64Required

the id of the message that opens the thread

idinteger · int64Required

the id of the thread reply

codestringRequired

the code of the reaction to remove, e.g. thumbs_up

Example: thumbs_up
Query parameters
channel-typestring · enumRequired

the type of the channel

Possible values:
Responses
200

the updated thread reply

application/json
idinteger · int64Read-onlyOptional
createdstring · date-timeRead-onlyOptional
updatedstring · date-timeRead-onlyOptional
authorTypestring · enumRead-onlyOptional

Who wrote the message: a user of the account, an ilert bot, or an external author, e.g. when the message was submitted with an event.

Possible values:
authorIdinteger · int64Read-onlyOptional

The id of the user who wrote the message. Only set when authorType is USER.

botNamestringRead-onlyOptional

The name of the bot that wrote the message. Only set when authorType is BOT.

contentstring · max: 40000Required

The text of the message. Longer content is truncated.

contentTypestring · enumRequired

The type of the content, currently only TEXT is supported.

Possible values:
messageStylestring · enumRead-onlyOptional

How the message is meant to be rendered. Messages written by users always carry the style DEFAULT. ilert uses further styles internally, e.g. for the intermediate steps of its AI agents. If you display messages in your own interface, only render those with the style DEFAULT, otherwise internal styles may show up as regular messages.

Possible values:
editedbooleanRead-onlyOptional
deletedbooleanRead-onlyOptional

Set to true once the message has been deleted. The content is replaced by a placeholder.

threadIdinteger · int64Read-onlyOptional

The id of the message this reply belongs to.

delete/chat-channels/{channelId}/messages/{threadId}/thread-replies/{id}/reactions/{code}
DELETE /api/chat-channels/{channelId}/messages/{threadId}/thread-replies/{id}/reactions/{code}?channel-type=ALERT HTTP/1.1
Authorization: YOUR_API_KEY
Accept: */*
200

the updated thread reply

{
  "id": 1,
  "created": "2026-01-01T00:00:00.000Z",
  "updated": "2026-01-01T00:00:00.000Z",
  "authorType": "USER",
  "authorId": 1,
  "botName": "text",
  "content": "text",
  "contentType": "TEXT",
  "messageStyle": "DEFAULT",
  "edited": true,
  "deleted": true,
  "reactions": [
    {
      "code": "thumbs_up",
      "count": 1,
      "users": [
        1
      ],
      "bots": [
        1
      ]
    }
  ],
  "threadId": 1
}

Last updated

Was this helpful?