Skip to Content
Uptimeify Docs

SMTP-Versandprotokolle abrufen

Gibt die letzten SMTP-Versandereignis-Logs aus Redis zurück. Nur für Admins.

GET /api/organization/smtp/logs

Query Parameter

ParameterTypeDefaultDescription
limitnumber100Maximale Anzahl zurückzugebender Ereignisse (1-500)
envelopestringkeineritems: 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 Unauthorized wenn du nicht authentifiziert bist
  • 403 Forbidden wenn du kein Admin bist

Auf dieser Seite