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.
• 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@example.com",
  "password": "password"
 }
}

Response

{
 "id": 500,
 "organizationId": 1,
 "customerId": 10,
 "name": "Mailbox Access",
 "hostname": "mail.example.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@example.com", "password": "password" },
 "imapPopConfig": { "protocol": "pop3", "tls": true, "user": "monitor@example.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