---
title: "Update the MTA-STS policy"
method: PUT
path: "/domains/{domainId}/mta-sts"
tags: ["MtaSts"]
---

# Update the MTA-STS policy

`PUT /domains/{domainId}/mta-sts`

## Request

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

## Path parameters

- `domainId` string, uuid, required

## Headers

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

## Request body

- object
  - `mode` 'testing' | 'enforce' | 'none'
  - `max_age` number

## Response `200`

Success

- MtaSts
  - `is_managed` boolean, required
  - `status` 'unknown' | 'syncing' | 'ready' | 'error', nullable, required
  - `mode` 'testing' | 'enforce' | 'none', nullable, required
  - `max_age` number, nullable, required
  - `mx` string[], nullable, required
  - `policy_id` string, nullable, required
  - `custom_hostname_id` string, nullable, required
  - `cname_target` string, required
  - `txt_cname_target` string, required
  - `tls_reporting_email` string, nullable, required
  - `tls_rpt_record` string, nullable, required

---

[API](https://skmtc.dev/palisade/apis/palisade-api.md) · [All operations](https://skmtc.dev/palisade/apis/palisade-api/llms.txt) · [OpenAPI document](https://skmtc.dev/palisade/apis/palisade-api/revisions/37b4ae5a7766?raw)