User Message

the user message API

mark messages as seen

put

Path parameters

idinteger · int64Required

Query parameters

lastReadstring · date-timeRequired

Responses

200

OK

No content

put/cmn/users/{id}/messages/last_read

PUT /api/cmn/users/{id}/messages/last_read?lastRead=2026-01-01T00%3A00%3A00.000Z HTTP/1.1
Host: 10.102.24.197:32795
Accept: */*

200

OK

No content

mark current user messages as seen

put

Query parameters

lastReadstring · date-timeRequired

Responses

200

OK

No content

put/cmn/users/my/messages/last_read

PUT /api/cmn/users/my/messages/last_read?lastRead=2026-01-01T00%3A00%3A00.000Z HTTP/1.1
Host: 10.102.24.197:32795
Accept: */*

200

OK

No content

update a message

put

Path parameters

idinteger · int64Required

Body

localizeable message

messageCodestringOptional

Internal unique identifier/key for this message

formattedMessagestringOptional

formatted message (default language)

Responses

200

OK

*/*

Nachricht

versionstringOptional

Version Identifier for this Object (for PUT)

idstringOptional

Unique identifier of the Object

senderBotAliasstringRead-onlyOptional

Versender (Bot Name), falls kein user der Sender war

sendTimestring · date-timeRead-onlyOptional

Zeitstempel: Gesendet

updateTimestring · date-timeRead-onlyOptional

Zeitstempel: Aktualisierungszeit

lastReadstring · date-timeRead-onlyOptional

Zeitstempel: Gelesen

statestring · enumRead-onlyOptional

Status

Possible values:

prioritystring · enumRead-onlyOptional

Priorität der Nachricht

Possible values:

put/cmn/users/me/messages/{id}

PUT /api/cmn/users/me/messages/{id} HTTP/1.1
Host: 10.102.24.197:32795
Content-Type: application/json
Accept: */*
Content-Length: 99

{
  "messageCode": "text",
  "messageParameters": {
    "ANY_ADDITIONAL_PROPERTY": {}
  },
  "formattedMessage": "text"
}

200

OK

{
  "version": "text",
  "info": {
    "createdAt": "2026-01-01T00:00:00.000Z",
    "createdFrom": "text",
    "updatedAt": "2026-01-01T00:00:00.000Z",
    "updatedFrom": "text"
  },
  "id": "text",
  "recipientRef": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  },
  "senderRef": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  },
  "senderBotAlias": "text",
  "sendTime": "2026-01-01T00:00:00.000Z",
  "updateTime": "2026-01-01T00:00:00.000Z",
  "lastRead": "2026-01-01T00:00:00.000Z",
  "state": "SEEN",
  "message": {
    "messageCode": "text",
    "messageParameters": {
      "ANY_ADDITIONAL_PROPERTY": {}
    },
    "formattedMessage": "text"
  },
  "priority": "HIGH"
}

delete a message

delete

Path parameters

idinteger · int64Required

Responses

200

OK

*/*

contextstringOptional

message context

messageValuestringOptional

message

delete/cmn/users/me/messages/{id}

DELETE /api/cmn/users/me/messages/{id} HTTP/1.1
Host: 10.102.24.197:32795
Accept: */*

200

OK

{
  "context": "text",
  "messageValue": "text"
}

post a message

post

Body

Nachricht-Umschlag zum verschicken

recipientUserIdsinteger · int64[]Optional

Empfänger User

recipientGroupIdsinteger · int64[]Optional

Empfänger User-Gruppen (werden zu Usern)

senderBotAliasstringOptional

optional ein BotName als versender. Nur für interne Apps und darf nur mit leeren userIds/groupIds verwendet werden

Responses

200

OK

*/*

Nachricht

versionstringOptional

Version Identifier for this Object (for PUT)

idstringOptional

Unique identifier of the Object

senderBotAliasstringRead-onlyOptional

Versender (Bot Name), falls kein user der Sender war

sendTimestring · date-timeRead-onlyOptional

Zeitstempel: Gesendet

updateTimestring · date-timeRead-onlyOptional

Zeitstempel: Aktualisierungszeit

lastReadstring · date-timeRead-onlyOptional

Zeitstempel: Gelesen

statestring · enumRead-onlyOptional

Status

Possible values:

prioritystring · enumRead-onlyOptional

Priorität der Nachricht

Possible values:

post/cmn/users/me/messages

POST /api/cmn/users/me/messages HTTP/1.1
Host: 10.102.24.197:32795
Content-Type: application/json
Accept: */*
Content-Length: 182

{
  "recipientUserIds": [
    1
  ],
  "recipientGroupIds": [
    1
  ],
  "senderBotAlias": "text",
  "message": {
    "messageCode": "text",
    "messageParameters": {
      "ANY_ADDITIONAL_PROPERTY": {}
    },
    "formattedMessage": "text"
  }
}

200

OK

{
  "version": "text",
  "info": {
    "createdAt": "2026-01-01T00:00:00.000Z",
    "createdFrom": "text",
    "updatedAt": "2026-01-01T00:00:00.000Z",
    "updatedFrom": "text"
  },
  "id": "text",
  "recipientRef": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  },
  "senderRef": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  },
  "senderBotAlias": "text",
  "sendTime": "2026-01-01T00:00:00.000Z",
  "updateTime": "2026-01-01T00:00:00.000Z",
  "lastRead": "2026-01-01T00:00:00.000Z",
  "state": "SEEN",
  "message": {
    "messageCode": "text",
    "messageParameters": {
      "ANY_ADDITIONAL_PROPERTY": {}
    },
    "formattedMessage": "text"
  },
  "priority": "HIGH"
}

return message count for specific user

get

Path parameters

idinteger · int64Required

Query parameters

statestring · enumOptionalPossible values:

Responses

200

OK

*/*

integer · int64Optional

get/cmn/users/{id}/messages/count

GET /api/cmn/users/{id}/messages/count HTTP/1.1
Host: 10.102.24.197:32795
Accept: */*

200

OK

1

return message count for user

get

Query parameters

statestring · enumOptionalPossible values:

Responses

200

OK

*/*

integer · int64Optional

get/cmn/users/me/messages/count

GET /api/cmn/users/me/messages/count HTTP/1.1
Host: 10.102.24.197:32795
Accept: */*

200

OK

1

delete a message

delete

Path parameters

userIdinteger · int64Required

idinteger · int64Required

Responses

200

OK

*/*

contextstringOptional

message context

messageValuestringOptional

message

delete/cmn/users/{userId}/messages/{id}

DELETE /api/cmn/users/{userId}/messages/{id} HTTP/1.1
Host: 10.102.24.197:32795
Accept: */*

200

OK

{
  "context": "text",
  "messageValue": "text"
}

delete all seen messages

delete

Responses

200

OK

*/*

contextstringOptional

message context

messageValuestringOptional

message

delete/cmn/users/me/seen-messages

DELETE /api/cmn/users/me/seen-messages HTTP/1.1
Host: 10.102.24.197:32795
Accept: */*

200

OK

{
  "context": "text",
  "messageValue": "text"
}

delete all messages

delete

Responses

200

OK

*/*

contextstringOptional

message context

messageValuestringOptional

message

delete/cmn/users/me/all-messages

DELETE /api/cmn/users/me/all-messages HTTP/1.1
Host: 10.102.24.197:32795
Accept: */*

200

OK

{
  "context": "text",
  "messageValue": "text"
}