latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-21163196628.8 KB

2d6e4912e230

settings

Get Mail Settings

Report the effective outgoing-mail configuration.

get/v1/settings/mail

Response

Successful Response

enabledboolean required

Whether a transport is configured at all.

from_emailstring nullable required

The 'From' address on outgoing mail, if one is configured.

from_namestring required

The 'From' display name on outgoing mail.

missingstring[] required

Settings that must be set before mail works, in config order. Empty exactly when 'ready' is true, so the dashboard can name what to configure rather than only reporting that mail is off.

public_base_urlstring nullable required

This deployment's own externally-reachable URL, used to build links in outgoing mail.

readyboolean required

Whether a message carrying a link back to this deployment can be sent, which is what every message the control plane sends needs. Matches 'mail_ready' on /v1/bootstrap.

transportstring required

The transport a send would use: 'smtp', 'console' (logged, not delivered), or 'none'.