Update single DNS record

PATCH

/domains/{domain}/dns

Change one value of a record set (records with the same name and type). With old_value exactly that value is replaced; without it the first value of the set is replaced and any other values are kept. A set that does not exist yet is created. Other record sets are never touched. To add a value next to the existing ones, use POST.

Request

Authorization

API Key

Add parameter in header

API-key

Example:

API-key: ********************

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Header Params

Body Params application/json

Example

{
    "record": {
        "type": "A",
        "name": "domain.com.",
        "value": "135.226.123.12",
        "ttl": 900
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PATCH '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 '{
    "record": {
        "type": "A",
        "name": "domain.com.",
        "value": "135.226.123.12",
        "ttl": 900
    }
}'

Responses

🟢200OK

application/json

Bodyapplication/json

Example

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

🟠400Wrong request method

🟠400SSL connection is required

🟠400No record provided. Use the 'record' object to pass a DNS record.

🟠400TTL is too high, maximum is 2147483647

🟠400No domain set

🟠400You have no access to this resource

🟠401No valid API key set

🟠401API key has expired

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

🔴500Error

Modified at 2026-11-13 09:40:27

Update DNS records

Delete single DNS record