Update Nameservers

PUT

/dns/nameservers

Replaces the nameservers for a domain.

Provide the complete list of nameservers — the existing set is replaced entirely. DNS propagation may take up to 48 hours after updating nameservers.

Restrictions:

Only allowed for domains with status: TRANSFERRED. Any other domain status returns 400 with "Nameserver changes are only allowed for domains with TRANSFERRED status." Not supported on Prewarmup Domains

Request

Authorization

API Key

Add parameter in header

cmr-x-api-key

Example:

cmr-x-api-key: ********************

Query Params

Body Params application/jsonRequired

Examples

Responses

🟢200Success

application/json

Nameservers updated successfully

Bodyapplication/json

🟠401Unauthorized

🟠422Unprocessable Entity

🟠400Bad Request

🟠404Not Found

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PUT 'https://customers.coldmailreseller.com/api/v1/integration/dns/nameservers?userId=H8M9JV2S9HMPYFQW393AZHQVD4XM' \
--header 'cmr-x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "domain": "acmecorp.com",
    "nameservers": [
        "ns1.provider.com",
        "ns2.provider.com"
    ]
}'

Response Example

200 - Example 1

{
    "status": 200,
    "message": "Nameservers updated successfully"
}

Modified at 2026-09-05 07:55:38

Update DNS Record

Delete DNS Record