Update domain

PUT

/domains/{domain}

Update domain settings of an existing domain in your account. Optional fields left empty will not be updated. Set nameservers with either nameserver (a saved profile alias) or nameservers (an explicit hostname list); the two are mutually exclusive. Optional dnssec.enabled false removes all DNSSEC keys. Optional forwarder updates the URL forwarder (enabled, type, url). Optional tags replaces the domain's tag set when provided.

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

{
    "nameserver": "default-mijnhost",
    "is_locked": true,
    "dnssec": {
        "flags": 257,
        "alg": 13,
        "protocol": 3,
        "pubKey": "zIbIaqhKuwHLJ3kB7V7AsxhxiSpdMxtP0Dmo7b1g/4bDF9ZVV2XsyXcVHBZ5Dngcu1COS83WgLbNDC195atBcA=="
    },
    "profile": {
        "owner": 100272,
        "admin": 100272,
        "tech": 100272,
        "billing": 100272,
        "reseller": 100272
    }
}

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' \
--header 'Accept: application/json' \
--header 'User-Agent: my-application/1.0.0' \
--header 'API-key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "nameserver": "default-mijnhost",
    "is_locked": true,
    "dnssec": {
        "flags": 257,
        "alg": 13,
        "protocol": 3,
        "pubKey": "zIbIaqhKuwHLJ3kB7V7AsxhxiSpdMxtP0Dmo7b1g/4bDF9ZVV2XsyXcVHBZ5Dngcu1COS83WgLbNDC195atBcA=="
    },
    "profile": {
        "owner": 100272,
        "admin": 100272,
        "tech": 100272,
        "billing": 100272,
        "reseller": 100272
    }
}'

Responses

🟢200OK

application/json

Bodyapplication/json

Example

{
    "status": 0,
    "status_description": "string",
    "data": {
        "tags": [
            "string"
        ]
    }
}

🟠400Wrong request method

🟠400SSL connection is required

🟠401API key has expired

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

🟠400Domain is suspended, nameservers cannot be edited.

🟠400Error

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

Get domain

Cancel domain