SMTP-Versandprotokolle abrufen
Gibt die letzten SMTP-Versandereignis-Logs aus Redis zurück. Nur für Admins.
GET /api/organization/smtp/logs
Query Parameter
| Parameter | Type | Default | Description |
|---|---|---|---|
limit | number | 100 | Maximale Anzahl zurückzugebender Ereignisse (1-500) |
envelope | string | keiner | items: Antwort als { items, total, page, perPage }. Ab 18.01.2027 Standard. |
Beispiel (cURL)
curl -X GET "$BASE_URL/api/organization/smtp/logs?limit=50&envelope=items" \
-H "Cookie: $SESSION_COOKIE" \
-H "Accept: application/json"Antwort (Response)
{
"items": [
{
"type": "smtp_send",
"timestamp": "2026-04-15T12:00:00.000Z",
"to": "admin@deinkunde.com",
"subject": "Website Down: deinkunde.com",
"status": "sent"
}
],
"total": 1,
"page": 1,
"perPage": 1
}Listenform: Mit envelope=items kommt die Liste als { items, total, page, perPage }. Ohne den Parameter antwortet der Endpunkt noch in der bisherigen Form ({ "events": [...] }); sie ist veraltet, ab dem 18.01.2027 ist { items, ... } der Standard.
Gibt eine leere Liste zurück ("items": []; in der bisherigen Form { "events": [] }), wenn keine Logs vorhanden sind oder bei Redis-Fehlern (fail-open).
Häufige Fehler
401 Unauthorizedwenn du nicht authentifiziert bist403 Forbiddenwenn du kein Admin bist
Organisations-SMTP
Konfiguriere eigene SMTP-Einstellungen, damit die Benachrichtigungs-E-Mails deiner Organisation über deinen eigenen Mailserver versendet werden. Alle SMTP-Endpunkte erfordern die Admin-Rolle.
SMTP-Verbindung testen
Testet die SMTP-Konfiguration durch Versand einer Test-E-Mail. Alle Parameter sind optional. Wenn weggelassen, werden die gespeicherten Konfigurationswerte verwendet. So kannst du neue Zugangsdaten testen, bevor du sie speicherst. Nur für Admins.