Delete SMTP Monitor

DELETE /api/smtp-monitors/:smtpMonitorPublicId

AuthenticationCopy Anchor Link

Requires a valid session and write access.

• Header: Authorization: Bearer <token>

ParametersCopy Anchor Link

• smtpMonitorPublicId (Path, required): SMTP monitor public UUID.

cURLCopy Anchor Link

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

ResponseCopy Anchor Link

{ "success": true }

ErrorsCopy Anchor Link

• 400 SMTP monitor public ID (UUID) required
• 401 Unauthorized
• 403 Forbidden (readonlyMayNotDelete for a read-only caller, managed_by_organization for a managed resource without canEditManaged)
• 404 Not found

PermissionsCopy Anchor Link

Closed to the readonly role. A read-only login deletes no monitor, whatever its ownership class, and neither does an API token it issued: a token inherits the role of the user who created it. Editing a self_service monitor stays open to that role.

A customer-scoped caller is bound by ownership class on top of that: a managed monitor is refused with managed_by_organization unless its customer carries canEditManaged.