# AppMessage

App message queue entries

## GET /cmn/system/app-message/{id}

> Find an existing Instance by identifier

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.15.0"},"tags":[{"name":"AppMessage","description":"App message queue entries"}],"servers":[{"url":"http://localhost:57761/api","description":"Generated server url"}],"paths":{"/cmn/system/app-message/{id}":{"get":{"tags":["AppMessage"],"summary":"Find an existing Instance by identifier","operationId":"getById_106","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/common-api-AppMessageEntryGet"}}}},"404":{"description":"Resource with given ID was not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/core-error-ApiError"}}}}}}}},"components":{"schemas":{"common-api-AppMessageEntryGet":{"properties":{"event":{"type":"string","description":"Event/Nachricht"},"eventTopic":{"type":"string","description":"Event/Nachricht -Topic/Headline-"},"destinationOwner":{"type":"string","description":"owner (optional)"},"destinationQueue":{"type":"string","description":"queue"},"userRef":{"type":"string","description":"User-ID"},"id":{"type":"integer","format":"int64","description":"id","readOnly":true},"recipients":{"type":"array","description":"recipients","items":{"$ref":"#/components/schemas/common-api-AppMessageEntryRecipient"},"readOnly":true,"uniqueItems":true}},"required":["destinationQueue","event"]},"common-api-AppMessageEntryRecipient":{"description":"recipients","properties":{"response":{"type":"string","description":"Antwort, falls vorhanden","readOnly":true},"state":{"type":"string","description":"Status der Nachricht","enum":["QUEUED","SENT","FAILED","ERRONEOUS","INACTIVE"],"readOnly":true},"sentTimestamp":{"type":"string","format":"date-time","description":"Zeitpunkt, wann die Nachricht versendet wurde","readOnly":true},"sentAttempts":{"type":"integer","format":"int32","description":"Anzahl der Sendeversuche","readOnly":true},"webhook":{"$ref":"#/components/schemas/common-api-AppMessageWebhookGet"}}},"common-api-AppMessageWebhookGet":{"description":"Webhook","properties":{"url":{"type":"string","description":"url des webhooks. üblicherweise http(s)://host:port/etc"},"destinationOwner":{"type":"string","description":"owner (optional)"},"destinationQueue":{"type":"string","description":"queue"},"appIdentifier":{"type":"string","format":"uuid","description":"appIdentifier (registrar)"},"id":{"type":"integer","format":"int64","description":"id","readOnly":true}},"required":["destinationQueue","url"]},"core-error-ApiError":{"properties":{"instance":{"type":"string","description":"the resource that produced the error","readOnly":true},"trackingId":{"type":"string","description":"Internal tracking number for this Error","readOnly":true},"timeOfOccurence":{"type":"string","format":"date-time","description":"Internal timestamp, when this error happened","readOnly":true},"errors":{"$ref":"#/components/schemas/core-error-ApiError.Errors"},"decisions":{"type":"array","description":"all decisions, we need to take care of","items":{"$ref":"#/components/schemas/core-error-ApiErrorDecision"},"readOnly":true,"uniqueItems":true},"httpStatus":{"type":"integer","format":"int32","description":"HTTP-Status code"},"debug-info-url":{"type":"string","format":"uri","description":"optional url to get a more detailed stack trace","readOnly":true}},"required":["decisions","errors","instance","timeOfOccurence","trackingId"]},"core-error-ApiError.Errors":{"description":"all occured errors","properties":{"fieldErrors":{"type":"object","additionalProperties":{"type":"array","description":"One or more validation errors","items":{"$ref":"#/components/schemas/core-error-ApiErrorDetail"},"readOnly":true,"uniqueItems":true},"description":"One or more validation errors","readOnly":true},"services":{"type":"array","description":"One or more generel service errors","items":{"$ref":"#/components/schemas/core-error-ApiErrorDetail"},"readOnly":true,"uniqueItems":true}},"readOnly":true,"required":["fieldErrors","services"]},"core-error-ApiErrorDetail":{"description":"One or more generel service errors","properties":{"message":{"$ref":"#/components/schemas/core-api-LocalizeableMessage"},"property":{"type":"string","description":"property that has a constraint violation  (optional)"}},"readOnly":true},"core-api-LocalizeableMessage":{"description":"localizeable message","properties":{"messageCode":{"type":"string","description":"Internal unique identifier/key for this message"},"messageParameters":{"type":"object","additionalProperties":{"type":"object","description":"list of parameters to fill a formattable message"},"description":"list of parameters to fill a formattable message"},"formattedMessage":{"type":"string","description":"formatted message (default language)"}}},"core-error-ApiErrorDecision":{"description":"all decisions, we need to take care of","properties":{"message":{"$ref":"#/components/schemas/core-api-LocalizeableMessage"},"title":{"$ref":"#/components/schemas/core-api-LocalizeableMessage"},"multipleAnswersAllowed":{"type":"boolean","default":false,"description":"true, if an array of answers is required","readOnly":true},"textInput":{"type":"boolean","default":false,"description":"true, if text input instead of decisions is required","readOnly":true},"options":{"type":"array","description":"possible options for this decision","items":{"$ref":"#/components/schemas/core-error-ApiErrorDecision.DecisionOption"},"readOnly":true},"answerProperty":{"type":"string","description":"property to fill the decision into","readOnly":true},"answerPropertyType":{"type":"string","description":"type of the target property","enum":["FIELD","PARAMETER"],"readOnly":true},"searchDialog":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"}},"readOnly":true},"core-error-ApiErrorDecision.DecisionOption":{"description":"possible options for this decision","properties":{"message":{"$ref":"#/components/schemas/core-api-LocalizeableMessage"},"value":{"type":"string","description":"value for this decision","readOnly":true},"defaultOption":{"type":"boolean","default":false,"description":"default option","readOnly":true},"searchDialogs":{"type":"array","description":"Zu verwendende Search-Dialogs","items":{"$ref":"#/components/schemas/core-error-ApiErrorDecision.DecisionOptionSearchDialog"},"readOnly":true}}},"core-error-ApiErrorDecision.DecisionOptionSearchDialog":{"description":"Zu verwendende Search-Dialogs","properties":{"dialog":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"},"answerKey":{"type":"string","description":"Schlüssel für das Ergebnis vom Search-Dialog","readOnly":true}}},"unknownservice-unknownmodule-JsonNode":{"description":"Search-Dialog"}}}}
```

## PUT /cmn/system/app-message/{id}

> Update a Instance

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.15.0"},"tags":[{"name":"AppMessage","description":"App message queue entries"}],"servers":[{"url":"http://localhost:57761/api","description":"Generated server url"}],"paths":{"/cmn/system/app-message/{id}":{"put":{"tags":["AppMessage"],"summary":"Update a Instance","operationId":"update_98","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/common-api-AppMessageEntry"}}},"required":true},"responses":{"200":{"description":"successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/common-api-AppMessageEntryGet"}}}},"404":{"description":"Resource with given ID was not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/core-error-ApiError"}}}}}}}},"components":{"schemas":{"common-api-AppMessageEntry":{"properties":{"event":{"type":"string","description":"Event/Nachricht"},"eventTopic":{"type":"string","description":"Event/Nachricht -Topic/Headline-"},"destinationOwner":{"type":"string","description":"owner (optional)"},"destinationQueue":{"type":"string","description":"queue"},"userRef":{"type":"string","description":"User-ID"}},"required":["destinationQueue","event"]},"common-api-AppMessageEntryGet":{"properties":{"event":{"type":"string","description":"Event/Nachricht"},"eventTopic":{"type":"string","description":"Event/Nachricht -Topic/Headline-"},"destinationOwner":{"type":"string","description":"owner (optional)"},"destinationQueue":{"type":"string","description":"queue"},"userRef":{"type":"string","description":"User-ID"},"id":{"type":"integer","format":"int64","description":"id","readOnly":true},"recipients":{"type":"array","description":"recipients","items":{"$ref":"#/components/schemas/common-api-AppMessageEntryRecipient"},"readOnly":true,"uniqueItems":true}},"required":["destinationQueue","event"]},"common-api-AppMessageEntryRecipient":{"description":"recipients","properties":{"response":{"type":"string","description":"Antwort, falls vorhanden","readOnly":true},"state":{"type":"string","description":"Status der Nachricht","enum":["QUEUED","SENT","FAILED","ERRONEOUS","INACTIVE"],"readOnly":true},"sentTimestamp":{"type":"string","format":"date-time","description":"Zeitpunkt, wann die Nachricht versendet wurde","readOnly":true},"sentAttempts":{"type":"integer","format":"int32","description":"Anzahl der Sendeversuche","readOnly":true},"webhook":{"$ref":"#/components/schemas/common-api-AppMessageWebhookGet"}}},"common-api-AppMessageWebhookGet":{"description":"Webhook","properties":{"url":{"type":"string","description":"url des webhooks. üblicherweise http(s)://host:port/etc"},"destinationOwner":{"type":"string","description":"owner (optional)"},"destinationQueue":{"type":"string","description":"queue"},"appIdentifier":{"type":"string","format":"uuid","description":"appIdentifier (registrar)"},"id":{"type":"integer","format":"int64","description":"id","readOnly":true}},"required":["destinationQueue","url"]},"core-error-ApiError":{"properties":{"instance":{"type":"string","description":"the resource that produced the error","readOnly":true},"trackingId":{"type":"string","description":"Internal tracking number for this Error","readOnly":true},"timeOfOccurence":{"type":"string","format":"date-time","description":"Internal timestamp, when this error happened","readOnly":true},"errors":{"$ref":"#/components/schemas/core-error-ApiError.Errors"},"decisions":{"type":"array","description":"all decisions, we need to take care of","items":{"$ref":"#/components/schemas/core-error-ApiErrorDecision"},"readOnly":true,"uniqueItems":true},"httpStatus":{"type":"integer","format":"int32","description":"HTTP-Status code"},"debug-info-url":{"type":"string","format":"uri","description":"optional url to get a more detailed stack trace","readOnly":true}},"required":["decisions","errors","instance","timeOfOccurence","trackingId"]},"core-error-ApiError.Errors":{"description":"all occured errors","properties":{"fieldErrors":{"type":"object","additionalProperties":{"type":"array","description":"One or more validation errors","items":{"$ref":"#/components/schemas/core-error-ApiErrorDetail"},"readOnly":true,"uniqueItems":true},"description":"One or more validation errors","readOnly":true},"services":{"type":"array","description":"One or more generel service errors","items":{"$ref":"#/components/schemas/core-error-ApiErrorDetail"},"readOnly":true,"uniqueItems":true}},"readOnly":true,"required":["fieldErrors","services"]},"core-error-ApiErrorDetail":{"description":"One or more generel service errors","properties":{"message":{"$ref":"#/components/schemas/core-api-LocalizeableMessage"},"property":{"type":"string","description":"property that has a constraint violation  (optional)"}},"readOnly":true},"core-api-LocalizeableMessage":{"description":"localizeable message","properties":{"messageCode":{"type":"string","description":"Internal unique identifier/key for this message"},"messageParameters":{"type":"object","additionalProperties":{"type":"object","description":"list of parameters to fill a formattable message"},"description":"list of parameters to fill a formattable message"},"formattedMessage":{"type":"string","description":"formatted message (default language)"}}},"core-error-ApiErrorDecision":{"description":"all decisions, we need to take care of","properties":{"message":{"$ref":"#/components/schemas/core-api-LocalizeableMessage"},"title":{"$ref":"#/components/schemas/core-api-LocalizeableMessage"},"multipleAnswersAllowed":{"type":"boolean","default":false,"description":"true, if an array of answers is required","readOnly":true},"textInput":{"type":"boolean","default":false,"description":"true, if text input instead of decisions is required","readOnly":true},"options":{"type":"array","description":"possible options for this decision","items":{"$ref":"#/components/schemas/core-error-ApiErrorDecision.DecisionOption"},"readOnly":true},"answerProperty":{"type":"string","description":"property to fill the decision into","readOnly":true},"answerPropertyType":{"type":"string","description":"type of the target property","enum":["FIELD","PARAMETER"],"readOnly":true},"searchDialog":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"}},"readOnly":true},"core-error-ApiErrorDecision.DecisionOption":{"description":"possible options for this decision","properties":{"message":{"$ref":"#/components/schemas/core-api-LocalizeableMessage"},"value":{"type":"string","description":"value for this decision","readOnly":true},"defaultOption":{"type":"boolean","default":false,"description":"default option","readOnly":true},"searchDialogs":{"type":"array","description":"Zu verwendende Search-Dialogs","items":{"$ref":"#/components/schemas/core-error-ApiErrorDecision.DecisionOptionSearchDialog"},"readOnly":true}}},"core-error-ApiErrorDecision.DecisionOptionSearchDialog":{"description":"Zu verwendende Search-Dialogs","properties":{"dialog":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"},"answerKey":{"type":"string","description":"Schlüssel für das Ergebnis vom Search-Dialog","readOnly":true}}},"unknownservice-unknownmodule-JsonNode":{"description":"Search-Dialog"}}}}
```

## PUT /cmn/system/app-message/{entryId}/app/{appId}/deactivate

>

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.15.0"},"tags":[{"name":"AppMessage","description":"App message queue entries"}],"servers":[{"url":"http://localhost:57761/api","description":"Generated server url"}],"paths":{"/cmn/system/app-message/{entryId}/app/{appId}/deactivate":{"put":{"tags":["AppMessage"],"operationId":"deactivateEntry","parameters":[{"name":"entryId","in":"path","description":"Entry-ID","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"appId","in":"path","description":"App-ID","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/common-api-AppMessageEntryGet"}}}}}}}},"components":{"schemas":{"common-api-AppMessageEntryGet":{"properties":{"event":{"type":"string","description":"Event/Nachricht"},"eventTopic":{"type":"string","description":"Event/Nachricht -Topic/Headline-"},"destinationOwner":{"type":"string","description":"owner (optional)"},"destinationQueue":{"type":"string","description":"queue"},"userRef":{"type":"string","description":"User-ID"},"id":{"type":"integer","format":"int64","description":"id","readOnly":true},"recipients":{"type":"array","description":"recipients","items":{"$ref":"#/components/schemas/common-api-AppMessageEntryRecipient"},"readOnly":true,"uniqueItems":true}},"required":["destinationQueue","event"]},"common-api-AppMessageEntryRecipient":{"description":"recipients","properties":{"response":{"type":"string","description":"Antwort, falls vorhanden","readOnly":true},"state":{"type":"string","description":"Status der Nachricht","enum":["QUEUED","SENT","FAILED","ERRONEOUS","INACTIVE"],"readOnly":true},"sentTimestamp":{"type":"string","format":"date-time","description":"Zeitpunkt, wann die Nachricht versendet wurde","readOnly":true},"sentAttempts":{"type":"integer","format":"int32","description":"Anzahl der Sendeversuche","readOnly":true},"webhook":{"$ref":"#/components/schemas/common-api-AppMessageWebhookGet"}}},"common-api-AppMessageWebhookGet":{"description":"Webhook","properties":{"url":{"type":"string","description":"url des webhooks. üblicherweise http(s)://host:port/etc"},"destinationOwner":{"type":"string","description":"owner (optional)"},"destinationQueue":{"type":"string","description":"queue"},"appIdentifier":{"type":"string","format":"uuid","description":"appIdentifier (registrar)"},"id":{"type":"integer","format":"int64","description":"id","readOnly":true}},"required":["destinationQueue","url"]}}}}
```

## PUT /cmn/system/app-message/app/{appId}/deactivate

>

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.15.0"},"tags":[{"name":"AppMessage","description":"App message queue entries"}],"servers":[{"url":"http://localhost:57761/api","description":"Generated server url"}],"paths":{"/cmn/system/app-message/app/{appId}/deactivate":{"put":{"tags":["AppMessage"],"operationId":"deactivateEntries","parameters":[{"name":"appId","in":"path","description":"App-ID","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK"}}}}}}
```

## POST /cmn/system/app-message-webhook/register

> register a webhook

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.15.0"},"tags":[{"name":"AppMessage","description":"App message queue entries"}],"servers":[{"url":"http://localhost:57761/api","description":"Generated server url"}],"paths":{"/cmn/system/app-message-webhook/register":{"post":{"tags":["AppMessage"],"summary":"register a webhook","operationId":"register_2","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/common-api-AppMessageWebhook"}}},"required":true},"responses":{"200":{"description":"successful operation"},"404":{"description":"Resource with given ID was not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/core-error-ApiError"}}}}}}}},"components":{"schemas":{"common-api-AppMessageWebhook":{"properties":{"url":{"type":"string","description":"url des webhooks. üblicherweise http(s)://host:port/etc"},"destinationOwner":{"type":"string","description":"owner (optional)"},"destinationQueue":{"type":"string","description":"queue"},"appIdentifier":{"type":"string","format":"uuid","description":"appIdentifier (registrar)"}},"required":["destinationQueue","url"]},"core-error-ApiError":{"properties":{"instance":{"type":"string","description":"the resource that produced the error","readOnly":true},"trackingId":{"type":"string","description":"Internal tracking number for this Error","readOnly":true},"timeOfOccurence":{"type":"string","format":"date-time","description":"Internal timestamp, when this error happened","readOnly":true},"errors":{"$ref":"#/components/schemas/core-error-ApiError.Errors"},"decisions":{"type":"array","description":"all decisions, we need to take care of","items":{"$ref":"#/components/schemas/core-error-ApiErrorDecision"},"readOnly":true,"uniqueItems":true},"httpStatus":{"type":"integer","format":"int32","description":"HTTP-Status code"},"debug-info-url":{"type":"string","format":"uri","description":"optional url to get a more detailed stack trace","readOnly":true}},"required":["decisions","errors","instance","timeOfOccurence","trackingId"]},"core-error-ApiError.Errors":{"description":"all occured errors","properties":{"fieldErrors":{"type":"object","additionalProperties":{"type":"array","description":"One or more validation errors","items":{"$ref":"#/components/schemas/core-error-ApiErrorDetail"},"readOnly":true,"uniqueItems":true},"description":"One or more validation errors","readOnly":true},"services":{"type":"array","description":"One or more generel service errors","items":{"$ref":"#/components/schemas/core-error-ApiErrorDetail"},"readOnly":true,"uniqueItems":true}},"readOnly":true,"required":["fieldErrors","services"]},"core-error-ApiErrorDetail":{"description":"One or more generel service errors","properties":{"message":{"$ref":"#/components/schemas/core-api-LocalizeableMessage"},"property":{"type":"string","description":"property that has a constraint violation  (optional)"}},"readOnly":true},"core-api-LocalizeableMessage":{"description":"localizeable message","properties":{"messageCode":{"type":"string","description":"Internal unique identifier/key for this message"},"messageParameters":{"type":"object","additionalProperties":{"type":"object","description":"list of parameters to fill a formattable message"},"description":"list of parameters to fill a formattable message"},"formattedMessage":{"type":"string","description":"formatted message (default language)"}}},"core-error-ApiErrorDecision":{"description":"all decisions, we need to take care of","properties":{"message":{"$ref":"#/components/schemas/core-api-LocalizeableMessage"},"title":{"$ref":"#/components/schemas/core-api-LocalizeableMessage"},"multipleAnswersAllowed":{"type":"boolean","default":false,"description":"true, if an array of answers is required","readOnly":true},"textInput":{"type":"boolean","default":false,"description":"true, if text input instead of decisions is required","readOnly":true},"options":{"type":"array","description":"possible options for this decision","items":{"$ref":"#/components/schemas/core-error-ApiErrorDecision.DecisionOption"},"readOnly":true},"answerProperty":{"type":"string","description":"property to fill the decision into","readOnly":true},"answerPropertyType":{"type":"string","description":"type of the target property","enum":["FIELD","PARAMETER"],"readOnly":true},"searchDialog":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"}},"readOnly":true},"core-error-ApiErrorDecision.DecisionOption":{"description":"possible options for this decision","properties":{"message":{"$ref":"#/components/schemas/core-api-LocalizeableMessage"},"value":{"type":"string","description":"value for this decision","readOnly":true},"defaultOption":{"type":"boolean","default":false,"description":"default option","readOnly":true},"searchDialogs":{"type":"array","description":"Zu verwendende Search-Dialogs","items":{"$ref":"#/components/schemas/core-error-ApiErrorDecision.DecisionOptionSearchDialog"},"readOnly":true}}},"core-error-ApiErrorDecision.DecisionOptionSearchDialog":{"description":"Zu verwendende Search-Dialogs","properties":{"dialog":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"},"answerKey":{"type":"string","description":"Schlüssel für das Ergebnis vom Search-Dialog","readOnly":true}}},"unknownservice-unknownmodule-JsonNode":{"description":"Search-Dialog"}}}}
```

## POST /cmn/system/app-message-webhook/deregister

> deregister an existing webhook

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.15.0"},"tags":[{"name":"AppMessage","description":"App message queue entries"}],"servers":[{"url":"http://localhost:57761/api","description":"Generated server url"}],"paths":{"/cmn/system/app-message-webhook/deregister":{"post":{"tags":["AppMessage"],"summary":"deregister an existing webhook","operationId":"deregister_2","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/common-api-AppMessageWebhook"}}},"required":true},"responses":{"200":{"description":"successful operation"},"404":{"description":"Resource with given ID was not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/core-error-ApiError"}}}}}}}},"components":{"schemas":{"common-api-AppMessageWebhook":{"properties":{"url":{"type":"string","description":"url des webhooks. üblicherweise http(s)://host:port/etc"},"destinationOwner":{"type":"string","description":"owner (optional)"},"destinationQueue":{"type":"string","description":"queue"},"appIdentifier":{"type":"string","format":"uuid","description":"appIdentifier (registrar)"}},"required":["destinationQueue","url"]},"core-error-ApiError":{"properties":{"instance":{"type":"string","description":"the resource that produced the error","readOnly":true},"trackingId":{"type":"string","description":"Internal tracking number for this Error","readOnly":true},"timeOfOccurence":{"type":"string","format":"date-time","description":"Internal timestamp, when this error happened","readOnly":true},"errors":{"$ref":"#/components/schemas/core-error-ApiError.Errors"},"decisions":{"type":"array","description":"all decisions, we need to take care of","items":{"$ref":"#/components/schemas/core-error-ApiErrorDecision"},"readOnly":true,"uniqueItems":true},"httpStatus":{"type":"integer","format":"int32","description":"HTTP-Status code"},"debug-info-url":{"type":"string","format":"uri","description":"optional url to get a more detailed stack trace","readOnly":true}},"required":["decisions","errors","instance","timeOfOccurence","trackingId"]},"core-error-ApiError.Errors":{"description":"all occured errors","properties":{"fieldErrors":{"type":"object","additionalProperties":{"type":"array","description":"One or more validation errors","items":{"$ref":"#/components/schemas/core-error-ApiErrorDetail"},"readOnly":true,"uniqueItems":true},"description":"One or more validation errors","readOnly":true},"services":{"type":"array","description":"One or more generel service errors","items":{"$ref":"#/components/schemas/core-error-ApiErrorDetail"},"readOnly":true,"uniqueItems":true}},"readOnly":true,"required":["fieldErrors","services"]},"core-error-ApiErrorDetail":{"description":"One or more generel service errors","properties":{"message":{"$ref":"#/components/schemas/core-api-LocalizeableMessage"},"property":{"type":"string","description":"property that has a constraint violation  (optional)"}},"readOnly":true},"core-api-LocalizeableMessage":{"description":"localizeable message","properties":{"messageCode":{"type":"string","description":"Internal unique identifier/key for this message"},"messageParameters":{"type":"object","additionalProperties":{"type":"object","description":"list of parameters to fill a formattable message"},"description":"list of parameters to fill a formattable message"},"formattedMessage":{"type":"string","description":"formatted message (default language)"}}},"core-error-ApiErrorDecision":{"description":"all decisions, we need to take care of","properties":{"message":{"$ref":"#/components/schemas/core-api-LocalizeableMessage"},"title":{"$ref":"#/components/schemas/core-api-LocalizeableMessage"},"multipleAnswersAllowed":{"type":"boolean","default":false,"description":"true, if an array of answers is required","readOnly":true},"textInput":{"type":"boolean","default":false,"description":"true, if text input instead of decisions is required","readOnly":true},"options":{"type":"array","description":"possible options for this decision","items":{"$ref":"#/components/schemas/core-error-ApiErrorDecision.DecisionOption"},"readOnly":true},"answerProperty":{"type":"string","description":"property to fill the decision into","readOnly":true},"answerPropertyType":{"type":"string","description":"type of the target property","enum":["FIELD","PARAMETER"],"readOnly":true},"searchDialog":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"}},"readOnly":true},"core-error-ApiErrorDecision.DecisionOption":{"description":"possible options for this decision","properties":{"message":{"$ref":"#/components/schemas/core-api-LocalizeableMessage"},"value":{"type":"string","description":"value for this decision","readOnly":true},"defaultOption":{"type":"boolean","default":false,"description":"default option","readOnly":true},"searchDialogs":{"type":"array","description":"Zu verwendende Search-Dialogs","items":{"$ref":"#/components/schemas/core-error-ApiErrorDecision.DecisionOptionSearchDialog"},"readOnly":true}}},"core-error-ApiErrorDecision.DecisionOptionSearchDialog":{"description":"Zu verwendende Search-Dialogs","properties":{"dialog":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"},"answerKey":{"type":"string","description":"Schlüssel für das Ergebnis vom Search-Dialog","readOnly":true}}},"unknownservice-unknownmodule-JsonNode":{"description":"Search-Dialog"}}}}
```

## POST /cmn/system/app-message

> Create a Instance

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.15.0"},"tags":[{"name":"AppMessage","description":"App message queue entries"}],"servers":[{"url":"http://localhost:57761/api","description":"Generated server url"}],"paths":{"/cmn/system/app-message":{"post":{"tags":["AppMessage"],"summary":"Create a Instance","operationId":"create_90","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/common-api-AppMessageEntry"}}},"required":true},"responses":{"200":{"description":"successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/common-api-AppMessageEntryGet"}}}},"422":{"description":"Resource was unable to create","content":{"application/json":{"schema":{"$ref":"#/components/schemas/core-error-ApiError"}}}}}}}},"components":{"schemas":{"common-api-AppMessageEntry":{"properties":{"event":{"type":"string","description":"Event/Nachricht"},"eventTopic":{"type":"string","description":"Event/Nachricht -Topic/Headline-"},"destinationOwner":{"type":"string","description":"owner (optional)"},"destinationQueue":{"type":"string","description":"queue"},"userRef":{"type":"string","description":"User-ID"}},"required":["destinationQueue","event"]},"common-api-AppMessageEntryGet":{"properties":{"event":{"type":"string","description":"Event/Nachricht"},"eventTopic":{"type":"string","description":"Event/Nachricht -Topic/Headline-"},"destinationOwner":{"type":"string","description":"owner (optional)"},"destinationQueue":{"type":"string","description":"queue"},"userRef":{"type":"string","description":"User-ID"},"id":{"type":"integer","format":"int64","description":"id","readOnly":true},"recipients":{"type":"array","description":"recipients","items":{"$ref":"#/components/schemas/common-api-AppMessageEntryRecipient"},"readOnly":true,"uniqueItems":true}},"required":["destinationQueue","event"]},"common-api-AppMessageEntryRecipient":{"description":"recipients","properties":{"response":{"type":"string","description":"Antwort, falls vorhanden","readOnly":true},"state":{"type":"string","description":"Status der Nachricht","enum":["QUEUED","SENT","FAILED","ERRONEOUS","INACTIVE"],"readOnly":true},"sentTimestamp":{"type":"string","format":"date-time","description":"Zeitpunkt, wann die Nachricht versendet wurde","readOnly":true},"sentAttempts":{"type":"integer","format":"int32","description":"Anzahl der Sendeversuche","readOnly":true},"webhook":{"$ref":"#/components/schemas/common-api-AppMessageWebhookGet"}}},"common-api-AppMessageWebhookGet":{"description":"Webhook","properties":{"url":{"type":"string","description":"url des webhooks. üblicherweise http(s)://host:port/etc"},"destinationOwner":{"type":"string","description":"owner (optional)"},"destinationQueue":{"type":"string","description":"queue"},"appIdentifier":{"type":"string","format":"uuid","description":"appIdentifier (registrar)"},"id":{"type":"integer","format":"int64","description":"id","readOnly":true}},"required":["destinationQueue","url"]},"core-error-ApiError":{"properties":{"instance":{"type":"string","description":"the resource that produced the error","readOnly":true},"trackingId":{"type":"string","description":"Internal tracking number for this Error","readOnly":true},"timeOfOccurence":{"type":"string","format":"date-time","description":"Internal timestamp, when this error happened","readOnly":true},"errors":{"$ref":"#/components/schemas/core-error-ApiError.Errors"},"decisions":{"type":"array","description":"all decisions, we need to take care of","items":{"$ref":"#/components/schemas/core-error-ApiErrorDecision"},"readOnly":true,"uniqueItems":true},"httpStatus":{"type":"integer","format":"int32","description":"HTTP-Status code"},"debug-info-url":{"type":"string","format":"uri","description":"optional url to get a more detailed stack trace","readOnly":true}},"required":["decisions","errors","instance","timeOfOccurence","trackingId"]},"core-error-ApiError.Errors":{"description":"all occured errors","properties":{"fieldErrors":{"type":"object","additionalProperties":{"type":"array","description":"One or more validation errors","items":{"$ref":"#/components/schemas/core-error-ApiErrorDetail"},"readOnly":true,"uniqueItems":true},"description":"One or more validation errors","readOnly":true},"services":{"type":"array","description":"One or more generel service errors","items":{"$ref":"#/components/schemas/core-error-ApiErrorDetail"},"readOnly":true,"uniqueItems":true}},"readOnly":true,"required":["fieldErrors","services"]},"core-error-ApiErrorDetail":{"description":"One or more generel service errors","properties":{"message":{"$ref":"#/components/schemas/core-api-LocalizeableMessage"},"property":{"type":"string","description":"property that has a constraint violation  (optional)"}},"readOnly":true},"core-api-LocalizeableMessage":{"description":"localizeable message","properties":{"messageCode":{"type":"string","description":"Internal unique identifier/key for this message"},"messageParameters":{"type":"object","additionalProperties":{"type":"object","description":"list of parameters to fill a formattable message"},"description":"list of parameters to fill a formattable message"},"formattedMessage":{"type":"string","description":"formatted message (default language)"}}},"core-error-ApiErrorDecision":{"description":"all decisions, we need to take care of","properties":{"message":{"$ref":"#/components/schemas/core-api-LocalizeableMessage"},"title":{"$ref":"#/components/schemas/core-api-LocalizeableMessage"},"multipleAnswersAllowed":{"type":"boolean","default":false,"description":"true, if an array of answers is required","readOnly":true},"textInput":{"type":"boolean","default":false,"description":"true, if text input instead of decisions is required","readOnly":true},"options":{"type":"array","description":"possible options for this decision","items":{"$ref":"#/components/schemas/core-error-ApiErrorDecision.DecisionOption"},"readOnly":true},"answerProperty":{"type":"string","description":"property to fill the decision into","readOnly":true},"answerPropertyType":{"type":"string","description":"type of the target property","enum":["FIELD","PARAMETER"],"readOnly":true},"searchDialog":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"}},"readOnly":true},"core-error-ApiErrorDecision.DecisionOption":{"description":"possible options for this decision","properties":{"message":{"$ref":"#/components/schemas/core-api-LocalizeableMessage"},"value":{"type":"string","description":"value for this decision","readOnly":true},"defaultOption":{"type":"boolean","default":false,"description":"default option","readOnly":true},"searchDialogs":{"type":"array","description":"Zu verwendende Search-Dialogs","items":{"$ref":"#/components/schemas/core-error-ApiErrorDecision.DecisionOptionSearchDialog"},"readOnly":true}}},"core-error-ApiErrorDecision.DecisionOptionSearchDialog":{"description":"Zu verwendende Search-Dialogs","properties":{"dialog":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"},"answerKey":{"type":"string","description":"Schlüssel für das Ergebnis vom Search-Dialog","readOnly":true}}},"unknownservice-unknownmodule-JsonNode":{"description":"Search-Dialog"}}}}
```

## GET /cmn/system/app-message-webhook/destinations

> list all available webhook-queues

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.15.0"},"tags":[{"name":"AppMessage","description":"App message queue entries"}],"servers":[{"url":"http://localhost:57761/api","description":"Generated server url"}],"paths":{"/cmn/system/app-message-webhook/destinations":{"get":{"tags":["AppMessage"],"summary":"list all available webhook-queues","operationId":"getDestinations","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/common-system-AppMessageQueueDefinition.QueueDestinationDescription"}}}}}}}}},"components":{"schemas":{"common-system-AppMessageQueueDefinition.QueueDestinationDescription":{"properties":{"owner":{"type":"string"},"queue":{"type":"string"},"description":{"type":"string"}}}}}}
```