Domains

Make a connected domain the site's primary address

Marks the host as the canonical address: the site's other connected hosts then redirect (301) to it. Only a connected host can be primary. The body is ignored. Needs the site owner. Editors, viewers, guest tokens (guest_requires_account) and keys scoped to other sites are refused.

post/api/v1/sites/{slug}/custom-domains/{host}/primary

Request

  • Base URL: https://api.dotsy.ai
  • URL: https://api.dotsy.ai/api/v1/sites/{slug}/custom-domains/{host}/primary
  • Auth: HTTP bearer

Path parameters

slugstring required
Example:acme-studio

Site slug or site id (UUID). An old slug answers 301/308 and a site id 307 to the canonical slug path.

hoststring required
Example:www.example.com

The hostname, e.g. www.example.com. Case-insensitive.

Response

The domain is now primary.

Example response

{
  "domain": {
    "host": "www.example.com",
    "slug": "acme-studio",
    "kind": "external",
    "status": "pending_dns",
    "isPrimary": false,
    "lastError": null,
    "createdAt": 1760000000000,
    "verifiedAt": 1760000000000,
    "connectSessionId": "cs_3f9a1c2e",
    "lastCheckedAt": 1760000000000,
    "dnsRecords": [
      {
        "type": "CNAME",
        "name": "www",
        "value": "customers.dotsy.site",
        "purpose": "routing",
        "recordStatus": "missing"
      },
      {
        "type": "TXT",
        "name": "_acme-challenge.www",
        "value": "k3Zr1q9Wn0xLpV7sT2uYb8cD4eFgH6jA",
        "purpose": "dcv",
        "recordStatus": "waiting"
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.