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
}