Skip to main content
PATCH
/
domains
/
{domain}
Update domain
curl --request PATCH \
  --url https://app.laravel.cloud/api/domains/{domain} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "verification_method": "real_time"
}'
{
  "data": {
    "id": "<string>",
    "type": "domains",
    "attributes": {
      "name": "<string>",
      "type": "root",
      "hostname_status": "pending",
      "ssl_status": "pending",
      "origin_status": "pending",
      "redirect": "root_to_www",
      "dns_records": {
        "ssl": [
          {
            "type": "CNAME",
            "name": "<string>",
            "value": "<string>"
          }
        ],
        "pre_verification": {
          "type": "TXT",
          "name": "<string>",
          "value": "<string>"
        },
        "origin": {
          "type": "A",
          "name": "<string>",
          "value": "<string>"
        }
      },
      "wildcard": {
        "hostname_status": "pending",
        "ssl_status": "pending",
        "origin_status": "pending",
        "dns_records": {
          "ssl": [
            {
              "type": "CNAME",
              "name": "<string>",
              "value": "<string>"
            }
          ],
          "pre_verification": {
            "type": "TXT",
            "name": "<string>",
            "value": "<string>"
          },
          "origin": {
            "type": "A",
            "name": "<string>",
            "value": "<string>"
          }
        }
      },
      "www": {
        "hostname_status": "pending",
        "ssl_status": "pending",
        "origin_status": "pending",
        "dns_records": {
          "ssl": [
            {
              "type": "CNAME",
              "name": "<string>",
              "value": "<string>"
            }
          ],
          "pre_verification": {
            "type": "TXT",
            "name": "<string>",
            "value": "<string>"
          },
          "origin": {
            "type": "A",
            "name": "<string>",
            "value": "<string>"
          }
        }
      },
      "last_verified_at": "2023-11-07T05:31:56Z",
      "created_at": "2023-11-07T05:31:56Z"
    },
    "relationships": {
      "environment": {
        "data": {
          "type": "environments",
          "id": "<string>"
        }
      }
    },
    "links": {
      "self": {
        "href": "<string>",
        "rel": "<string>",
        "describedby": "<string>",
        "title": "<string>",
        "type": "<string>",
        "hreflang": "<string>",
        "meta": {}
      }
    }
  }
}

Authorizations

Authorization
string
header
required

The Bearer Token generated on the Cloud UI.

Path Parameters

domain
string | null
required

The domain identifier

Body

application/json
verification_method
enum<string>
required

The domain verification method to use. Pre-verification allows domain verification via TXT record before the domain is pointed to the environment. Real-time verification requires the domain to already be pointing to the environment.

Available options:
pre_verification,
real_time

Response

DomainResource

data
object
required