---
title: "Update details for the specified Domain"
method: PATCH
path: "/v1/domains/{domain}"
tags: ["v1"]
---

# Update details for the specified Domain

`PATCH /v1/domains/{domain}`

## Path parameters

- `domain` string, required

## Headers

- `X-Shopper-Id` string

## Request body

- DomainUpdate
  - `locked` boolean — Whether or not the domain should be locked to prevent transfers
  - `nameServers` unknown[] — Fully-qualified domain names for Name Servers to associate with the domain
    - unknown
  - `renewAuto` boolean — Whether or not the domain should be configured to automatically renew
  - `subaccountId` string — Reseller subaccount shopperid who can manage the domain
  - `exposeRegistrantOrganization` boolean — Whether or not the domain registrant contact organization field should be shown in the WHOIS
  - `exposeWhois` boolean — Whether or not the domain contact details should be shown in the WHOIS
  - `consent` ConsentDomainUpdate
    - `agreedAt` string, iso-datetime, required — Timestamp indicating when the end-user consented to these agreements
    - `agreedBy` string, required — Originating client IP address of the end-user's computer when they consented to the agreements
    - `agreementKeys` string[], required — Unique identifiers of the agreements to which the end-user has agreed, as required by the elements being updated<br/><ul><li><strong style='margin-left: 12px;'>EXPOSE_REGISTRANT_ORGANIZATION</strong> - Required when the exposeRegistrantOrganization field is updated to true</li><li><strong style='margin-left: 12px;'>EXPOSE_WHOIS</strong> - Required when the exposeWhois field is updated to true</li></ul>

## Response `200`

Request was successful

## Other responses

- `400` — Request was malformed
- `401` — Authentication info not sent or invalid
- `403` — Specified Subaccount not owned by authenticated Shopper
- `404` — Resource not found
- `409` — The given domain is not eligible to have its nameservers changed
- `422` — At least two apex (aka @) `nameServers` must be specified<br>Failed to update nameservers
- `429` — Too many requests received within interval
- `500` — Internal server error

---

[API](https://skmtc.net/godaddy/apis/domains-api.md) · [All operations](https://skmtc.net/godaddy/apis/domains-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/godaddy/domains-api/versions/475bd0561c3c/schema)