# Rotate SMTP password

Generate a new SMTP password. The old password will be immediately invalidated.

Endpoint: POST /api/smtp-credentials/rotate
Version: 1.0.0
Security: ApiKeyAuth

## Response 200 fields (application/json):

  - `success` (boolean)

  - `message` (string)

  - `smtp_credentials` (object)

  - `smtp_credentials.host` (string)
    SMTP server hostname
    Example: "smtp.mailerlogic.io"

  - `smtp_credentials.ports` (array)
    Available SMTP ports

  - `smtp_credentials.recommended_port` (integer)
    Recommended port (usually 587 for STARTTLS)

  - `smtp_credentials.username` (string)
    SMTP username (customer email)

  - `smtp_credentials.password` (string)
    SMTP password

  - `warning` (string)
    Example: "Update your SMTP clients with the new password. The old password will no longer work."

## Response 401 fields (application/json):

  - `error` (string)
    Error code or message

## Response 500 fields (application/json):

  - `error` (string)
    Error code or message