---
title: "Replace all DNS Records for the specified Domain"
method: PUT
path: "/v1/domains/{domain}/records"
tags: ["v1"]
---

# Replace all DNS Records for the specified Domain

`PUT /v1/domains/{domain}/records`

## Request

- Base URL: `https://api.ote-godaddy.com`
- URL: `https://api.ote-godaddy.com/v1/domains/{domain}/records`
- Auth: none declared

## Path parameters

- `domain` string, required

## Headers

- `X-Shopper-Id` string

## Request body

- DNSRecord[]
  - `data` string, required
  - `name` string, domain, required
  - `port` integer: Service port (SRV only)
  - `priority` integer: Record priority (MX and SRV only)
  - `protocol` string: Service protocol (SRV only)
  - `service` string: Service type (SRV only)
  - `ttl` integer
  - `type` 'A' | 'AAAA' | 'CNAME' | 'MX' | 'NS' | 'SOA' | 'SRV' | 'TXT', required
  - `weight` integer: Record weight (SRV only)

## Response `200`

Request was successful

## Other responses

- `400`: Request was malformed
- `401`: Authentication info not sent or invalid
- `403`: Authenticated user is not allowed access
- `404`: Resource not found
- `422`: `domain` is not a valid Domain name<br>`record` does not fulfill the schema
- `429`: Too many requests received within interval
- `500`: Internal server error
- `504`: Gateway timeout

---

[API](https://skmtc.dev/godaddy/apis/domains-api.md) - [All operations](https://skmtc.dev/godaddy/apis/domains-api/llms.txt) - [OpenAPI document](https://skmtc.dev/godaddy/apis/domains-api/revisions/475bd0561c3c?raw)