---
title: "Set DMARC override"
method: PUT
path: "/v1/domains/{domain_id}/dmarc"
tags: ["Domains"]
---

# Set DMARC override

`PUT /v1/domains/{domain_id}/dmarc`

## Request

- Base URL: `https://api.winnr.app`
- URL: `https://api.winnr.app/v1/domains/{domain_id}/dmarc`
- Auth: HTTP bearer

Override the default DMARC TXT record at `_dmarc.{domain}`. The
override is stored on the domain doc and is reapplied automatically
on any future domain re-setup.

## Path parameters

- `domain_id` string, required

## Request body

- object
  - `value` string, required: DMARC record value (must start with "v=DMARC1")

## Response `200`

DMARC override applied

- object
  - `meta` Meta
    - `request_id` string
    - `timestamp` string, date-time
  - `data` object
    - `dmarc_override` object
      - `value` string
      - `updated_at` string, date-time

## Other responses

- `400`: Invalid DMARC value (does not start with v=DMARC1)
- `401`: Authentication required or token invalid
- `404`: Resource not found
- `503`: DNS provider does not support API record management

---

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