hosting
Create or update hosting configuration
Set or update the hosting configuration for a domain or subdomain. This controls how the domain serves content — whether via redirect or reverse proxy.
Use the subName field in the request body to target a specific subdomain. If omitted, the configuration applies to the root domain.
All hosting configurations require an SSL certificate. After creating or updating a configuration, the certificateStatus will initially be PENDING while the certificate is provisioned. This typically completes within a few minutes.
Use $preview=true to validate the request and see the expected result without applying changes.
put/domains/{name}/dns/hosting
Path parameters
namestring required
Domain name
Query parameters
$previewboolean required
Preview mode — validate the request without executing changes.
Request body
Response
Hosting 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
}
}
]
}
}