MtaSts

Retry a failed MTA-STS setup

Requests a fresh certificate for mta-sts.{domain} after a failed setup. The domain must already have MTA-STS hosting enabled, must currently be in the error state, and must be publishing the mta-sts CNAME, otherwise the retry is refused with an explanation. A setup still in progress is refused rather than restarted. Returns the domain unchanged when its certificate is already active.

post/domains/{domainId}/mta-sts/retry

Request

  • Base URL: https://api.palisade.email
  • URL: https://api.palisade.email/domains/{domainId}/mta-sts/retry
  • Auth: one of:
    • HTTP bearer
    • HTTP basic

Path parameters

domainIdstring uuid required

Headers

Palisade-Version'2025-04-30' | 'unstable' required

Response

Success

is_managedboolean required
status'unknown' | 'syncing' | 'ready' | 'error' nullable required
mode'testing' | 'enforce' | 'none' nullable required
max_agenumber nullable required
mxstring[] nullable required
policy_idstring nullable required
custom_hostname_idstring nullable required
cname_targetstring required
txt_cname_targetstring required
tls_reporting_emailstring nullable required
tls_rpt_recordstring nullable required

Changes

No recorded changes to this operation across all 1 revision of this API.