IMAP/POP Monitor aktualisieren

PATCH /api/imap-pop-monitors/:imapPopMonitorPublicId

Authentifizierung

Erfordert eine gültige Session.

• Header: Authorization: Bearer <token>

Parameter

• imapPopMonitorPublicId (Pfad, erforderlich): Öffentliche UUID des IMAP/POP Monitors.

Request Body

• status (optional)
• Erlaubt: active, maintenance, disabled, paused, inactive
• Hinweis: paused / inactive werden zu disabled normalisiert.
• name, hostname, port, checkInterval, timeoutSeconds (optional)
• allowedCheckCountryCodes (optional)
• Wird zu Uppercase normalisiert und dedupliziert.
• checkMode (optional)
• Erlaubt: protocol | tcp. Muss einer dieser beiden Werte sein, sonst schlägt der Request mit 400 / data.code: "invalidCheckMode" fehl.
• Beim Wechsel zu tcp werden gespeicherte Zugangsdaten gelöscht: der Monitor führt nur eine reine TCP-Port-Erreichbarkeitsprüfung durch und imapPopConfig wird nicht gespeichert. Beim Zurückwechseln zu protocol läuft wieder die vollständige IMAP/POP-Login-Prüfung; neue Zugangsdaten über imapPopConfig/config mitschicken.
• port ist erforderlich, wenn der resultierende checkMode tcp ist (egal ob gerade in diesem Request gesetzt oder bereits am Monitor gespeichert). Ist kein Port vorhanden, schlägt der Request mit 400 / data.code: "portRequiredForTcp" fehl.
• imapPopConfig (optional)
• Alias für das gespeicherte config JSON.
• config (optional)
• Alternative, um dasselbe gespeicherte config JSON zu aktualisieren.

Hinweis: Read-only Nutzer dürfen nur status ändern (bei anderen Feldern kommt 403).

{ "status": "active" }

Beispiel für Config-Update:

{
 "imapPopConfig": {
  "protocol": "pop3",
  "tls": true,
  "user": "monitor@deinkunde.com",
  "password": "password"
 }
}

Response

{
 "id": 500,
 "organizationId": 1,
 "customerId": 10,
 "name": "Mailbox Access",
 "hostname": "mail.deinkunde.com",
 "port": 993,
 "checkInterval": 30,
 "timeoutSeconds": 30,
 "status": "active",
 "notificationPhoneNumber": null,
 "notificationEmail": null,
 "lastCheckedAt": null,
 "createdAt": "2026-02-26T12:00:00.000Z",
 "updatedAt": "2026-02-26T12:05:00.000Z",
 "config": { "protocol": "pop3", "tls": true, "user": "monitor@deinkunde.com", "password": "password" },
 "imapPopConfig": { "protocol": "pop3", "tls": true, "user": "monitor@deinkunde.com", "password": "password" }
}

Errors

• 400 Ungültiger Request Body, ungültiger Status oder ungültiger Hostname
• 401 Unauthorized
• 403 Forbidden (z.B. readonly oder global supporter)
• 404 IMAP/POP monitor not found