domain-management
Update a domain
Comprehensive domain update — modify nameservers, DNSSEC, contacts, flags, and DNS records in a single operation. All fields are optional; only include the sections you want to change. Returns an operation that tracks all the resulting changes.
patch/domains/{name}
Path parameters
namestring required
Domain name
Query parameters
$previewboolean required
Preview mode — validate the request without executing changes.
Request body
Example request
{
"nameservers": {
"items": [
"ns1.example.com",
"ns2.example.com"
]
},
"contacts": {
"owner": {
"id": "ct-a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"phone": {
"dialingPrefix": "+1"
}
},
"admin": {
"id": "ct-a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"phone": {
"dialingPrefix": "+1"
}
},
"tech": {
"id": "ct-a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"phone": {
"dialingPrefix": "+1"
}
},
"billing": {
"id": "ct-a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"phone": {
"dialingPrefix": "+1"
}
}
},
"records": {
"update": [
{
"id": "rr-a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}
]
}
}Response
Update operation created
Example response
{
"operation": {
"id": "op-a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"dependencies": [
{
"id": "plop_abc12345-1234-1234-1234-abc123456789",
"parameters": {
"owner": {
"id": "con_abc12345-1234-1234-1234-abc123456789"
},
"contacts": {
"admin": {
"id": "con_abc12345-1234-1234-1234-abc123456789"
},
"billing": {
"id": "con_abc12345-1234-1234-1234-abc123456789"
},
"tech": {
"id": "con_abc12345-1234-1234-1234-abc123456789"
}
},
"period": 1
}
}
]
}
}