v1

latestOpenAPI 3.0.02026-07-14198572488.4 KB
Domains

Update maindomain validation method or SSL CA

Allows for changing between DNS and HTTP validation for domain ownership, or updating the CA used for SSL for the maindomain

patch/v1/sites/{id}/maindomain

Path parameters

idinteger required

ID of the Site you are interacting with

Example:8880000888

Request body

domainstring

Domain name to update should you wish to change the maindomain that is not the primary maindomain

validation_method'http' | 'txt'

Validation method to use (http = http, txt = DNS)

hide_go_live0 | 1

Hide the Go Live information in the UI now that Go Live is complete

certificate_authority'google' | 'lets_encrypt'

Certificate Authority to be used to issue SSL certificates for the site

Example request

{
  "domain": "www.maindomain.com",
  "certificate_authority": "google"
}

Response

OK

successboolean

whether the request succeeded

errorsstring[]
messagesstring[] nullable

Example response

{
  "success": true,
  "errors": [],
  "messages": [],
  "result": {
    "validation_records": [
      {
        "name": "_acme-challenge.thebestreallylongdomainname.com",
        "value": "m_K7UGMVceMWPcgPn3zpqEtUV7RpFDBUqvl-yZyAUNU"
      }
    ],
    "certificate_authority": "google"
  }
}