SMTP Monitor löschen

DELETE /api/smtp-monitors/:smtpMonitorPublicId

AuthentifizierungAnkerlink kopieren

Erfordert eine gültige Session und Schreibrechte.

• Header: Authorization: Bearer <token>

ParameterAnkerlink kopieren

• smtpMonitorPublicId (Pfad, erforderlich): Öffentliche UUID des SMTP Monitors.

cURLAnkerlink kopieren

curl -X DELETE "https://YOUR_DOMAIN/api/smtp-monitors/33333333-3333-4333-8333-333333333333" \
 -H "Authorization: Bearer $TOKEN"

ResponseAnkerlink kopieren

{ "success": true }

ErrorsAnkerlink kopieren

• 400 SMTP Monitor Public ID (UUID) erforderlich
• 401 Unauthorized
• 403 Forbidden (readonlyMayNotDelete bei einem Nur-Lese-Zugang, managed_by_organization bei einer verwalteten Ressource ohne canEditManaged)
• 404 Not found

BerechtigungenAnkerlink kopieren

Für die Rolle readonly gesperrt. Ein Nur-Lese-Zugang löscht keinen Monitor, gleich welcher Besitzklasse, und ein von ihm ausgestellter API-Token ebenso wenig: Ein Token erbt die Rolle seines Erstellers. Das Bearbeiten eines Monitors mit self_service bleibt dieser Rolle erlaubt.

Kunden-gescopte Aufrufer bindet zusätzlich die Besitzklasse: Ein managed-Monitor wird mit managed_by_organization abgelehnt, solange der Kunde kein canEditManaged trägt.