# Email

Email sending

## GET /cmn/emails/{id}

>

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.14.3"},"tags":[{"name":"Email","description":"Email sending"}],"servers":[{"url":"http://localhost:52177/api","description":"Generated server url"}],"paths":{"/cmn/emails/{id}":{"get":{"tags":["Email"],"operationId":"getEmailList","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/common-email-EmailList"}}}}}}}},"components":{"schemas":{"common-email-EmailList":{"properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"type":{"type":"string","description":"type","enum":["INBOUND","OUTBOUND"]},"from":{"type":"string","description":"Absender Email-Adresse"},"fromPersonal":{"type":"string","description":"Absender Vollname"},"to":{"type":"string","description":"Empfänger"},"cc":{"type":"string","description":"CC"},"bcc":{"type":"string","description":"BCC"},"subject":{"type":"string","description":"Betreff"},"content":{"$ref":"#/components/schemas/common-email-EmailContent"},"attachmentObjectReferences":{"type":"string","description":"Referenz zum Anhang"},"state":{"type":"string","description":"Stand dieser Email","enum":["TO_DELIVER","DELIVERED","DELIVER_FAILED","RECEIVED"]}}},"core-api-MetaInfo":{"description":"MetaInformations for this Object","properties":{"createdAt":{"type":"string","format":"date-time","description":"Created At Timestamp","readOnly":true},"createdFrom":{"type":"string","description":"TenantUser-Identifier of the creator","readOnly":true},"updatedAt":{"type":"string","format":"date-time","description":"Last Updated AT Timestamp","readOnly":true},"updatedFrom":{"type":"string","description":"TenantUser-Identifier of most recent updater","readOnly":true}}},"common-email-EmailContent":{"description":"content","properties":{"html":{"type":"string","description":"Inhalt-Html"},"text":{"type":"string","description":"Inhalt-Text"}}}}}}
```

## PUT /cmn/emails/{id}

>

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.14.3"},"tags":[{"name":"Email","description":"Email sending"}],"servers":[{"url":"http://localhost:52177/api","description":"Generated server url"}],"paths":{"/cmn/emails/{id}":{"put":{"tags":["Email"],"operationId":"updateEmailListState","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"state","in":"query","required":true,"schema":{"type":"string","enum":["TO_DELIVER","DELIVERED","DELIVER_FAILED","RECEIVED"]}}],"responses":{"200":{"description":"OK"}}}}}}
```

## DELETE /cmn/emails/{id}

>

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.14.3"},"tags":[{"name":"Email","description":"Email sending"}],"servers":[{"url":"http://localhost:52177/api","description":"Generated server url"}],"paths":{"/cmn/emails/{id}":{"delete":{"tags":["Email"],"operationId":"deleteEmailList","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK"}}}}}}
```

## GET /cmn/emails/failures/{failureId}

>

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.14.3"},"tags":[{"name":"Email","description":"Email sending"}],"servers":[{"url":"http://localhost:52177/api","description":"Generated server url"}],"paths":{"/cmn/emails/failures/{failureId}":{"get":{"tags":["Email"],"operationId":"getEmailFailure","parameters":[{"name":"failureId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/common-email-EmailFailure"}}}}}}}},"components":{"schemas":{"common-email-EmailFailure":{"properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"type":{"type":"string","description":"Typ","enum":["BOUNCE","COMPLAINT"]},"reason":{"type":"string","description":"Grund für den Fehler"},"status":{"type":"array","items":{"$ref":"#/components/schemas/common-email-EmailNotificationStatus"}},"timestamp":{"type":"string","format":"date-time","description":"Zeitstempel"}}},"core-api-MetaInfo":{"description":"MetaInformations for this Object","properties":{"createdAt":{"type":"string","format":"date-time","description":"Created At Timestamp","readOnly":true},"createdFrom":{"type":"string","description":"TenantUser-Identifier of the creator","readOnly":true},"updatedAt":{"type":"string","format":"date-time","description":"Last Updated AT Timestamp","readOnly":true},"updatedFrom":{"type":"string","description":"TenantUser-Identifier of most recent updater","readOnly":true}}},"common-email-EmailNotificationStatus":{"description":"Status","properties":{"status":{"type":"string"},"action":{"type":"string"},"diagnosticCode":{"type":"string"},"emailAddress":{"type":"string"}}}}}}
```