Update DNS records

PUT

/domains/{domain}/dns

Update DNS records of specific domain. This will replace all existing DNS records of the domain.

Request

Authorization

Add parameter in header

API-Key

Example:

API-Key: ********************

Path Params

Header Params

Body Params application/json

Example

{
    "records": [
        {
            "type": "A",
            "name": "domain.com.",
            "value": "135.226.123.12",
            "ttl": 900
        },
        {
            "type": "AAAA",
            "name": "domain.com.",
            "value": "2009:21d0:322:6100::5:c92b",
            "ttl": 900
        },
        {
            "type": "MX",
            "name": "domain.com.",
            "value": "10 mail.domain.com.",
            "ttl": 900
        },
        {
            "type": "TXT",
            "name": "domain.com.",
            "value": "v=spf1 include:spf.mijn.host ~all",
            "ttl": 900
        }
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PUT 'https://mijn.host/api/v2/domains/domain.com/dns' \
--header 'Accept: application/json' \
--header 'User-Agent: my-application/1.0.0' \
--header 'API-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "records": [
        {
            "type": "A",
            "name": "domain.com.",
            "value": "135.226.123.12",
            "ttl": 900
        },
        {
            "type": "AAAA",
            "name": "domain.com.",
            "value": "2009:21d0:322:6100::5:c92b",
            "ttl": 900
        },
        {
            "type": "MX",
            "name": "domain.com.",
            "value": "10 mail.domain.com.",
            "ttl": 900
        },
        {
            "type": "TXT",
            "name": "domain.com.",
            "value": "v=spf1 include:spf.mijn.host ~all",
            "ttl": 900
        }
    ]
}'

Responses

🟢200OK

application/json

Body

Example

{
    "status": 0,
    "status_description": "string"
}

🟠400Wrong request method

🟠400SSL connection is required

🟠400No records provided. Use the "records" array to pass DNS records.

🟠400No domain set

🟠401No valid API key set

🟠401API key has expired

🟠401Remote IP address is not found in the API key whitelist

🔴500Error

Modified at 2026-04-11 12:02:31

Get DNS records

Update single DNS record