Domains

Create or overwrite a custom DNS record (upsert)

Create a TXT, CNAME, A, or AAAA record on the domain's DNS zone. The request is validated against Winnr-managed records — attempts to create records that collide with MX, inbound A, DKIM, or SPF return 409 managed_record_collision. Upsert semantics: if a tracked custom record already exists at the same (name, type), it is overwritten in place (same record id, new value/ttl) and the response sets overwrote_existing: true. If the zone holds an untracked record at the same (name, type) (e.g. a tracking CNAME created at provision time), it is adopted: overwritten in place and added to the domain's custom records. To change DMARC, use PUT /v1/domains/{id}/dmarc.

post/v1/domains/{domain_id}/custom-dns-records

Request

  • Base URL: https://api.winnr.app
  • URL: https://api.winnr.app/v1/domains/{domain_id}/custom-dns-records
  • Auth: HTTP bearer

Path parameters

domain_idstring required

Domain ID

Request body

namestring required

"@" for apex, otherwise short label (e.g. "www") or FQDN

type'TXT' | 'CNAME' | 'A' | 'AAAA' required
valuestring required
ttlinteger

Response

Record created (or overwritten in place)

Changes

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