Rollout Plan

What It Does

Reads the current state of the domain's SPF/DMARC/MTA-STS configuration and generates a recommended phased rollout to the target state. For each phase: the record value to publish, how long to hold, what signals to monitor (TLS-RPT, aggregate reports, deliverability), and rollback criteria. Handles common targets: dmarc_reject, spf_strict, mta_sts_enforce.

Why It's Useful

Moving DMARC from p=none to p=reject overnight is how teams break their own email. A rollout plan sequences the change with observation windows so each phase is reversible if deliverability regresses.

Use Cases

Parameters

Response Fields

Code Examples

curl "https://api.edgedns.dev/v1/reports/rollout-plan" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "domain=example.com" \
  -d "target=dmarc_reject"

const response = await fetch(
  'https://api.edgedns.dev/v1/reports/rollout-plan?domain=example.com&target=dmarc_reject',
  {
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY'
    }
  }
);

const data = await response.json();
console.log(data);

import requests

response = requests.get(
    'https://api.edgedns.dev/v1/reports/rollout-plan',
    headers={'Authorization': 'Bearer YOUR_API_KEY'},
    params={
    'domain': 'example.com',
    'target': 'dmarc_reject'
    }
)

data = response.json()
print(data)

Related Endpoints

External References

Learn more about the standards and protocols behind this endpoint.