Domains

Re-apply DNS records with the stored Cloudflare grant

Recovery without a browser: writes the routing and certificate-check records for the site's pending hosts again, using the Cloudflare grant the user already gave, then re-checks the hostnames. Use it when a connect stalled on stale or duplicate records. Needs a previous Cloudflare OAuth connect (no_cloudflare_oauth_grant otherwise). 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/connect/reapply-oauth

Request

  • Base URL: https://api.dotsy.ai
  • URL: https://api.dotsy.ai/api/v1/sites/{slug}/custom-domains/connect/reapply-oauth
  • 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.

Response

Records re-applied.

Example response

{
  "connect": {
    "sessionId": "cs_3f9a1c2e",
    "kind": "manual",
    "summary": "Add 2 DNS records at Namecheap, then check again.",
    "instructions": [
      "Add a CNAME record: Name \"www\" → Value \"customers.dotsy.site\"."
    ],
    "records": [
      {
        "type": "CNAME",
        "name": "www",
        "value": "customers.dotsy.site",
        "purpose": "routing",
        "host": "www.example.com",
        "recordStatus": "missing"
      }
    ],
    "provider": {
      "id": "namecheap",
      "label": "Namecheap"
    },
    "entriAvailable": false,
    "lane": "manual",
    "sessionStatus": "in_progress",
    "hosts": [
      {
        "host": "www.example.com",
        "status": "pending_dns",
        "isPrimary": false
      }
    ]
  }
}

Changes

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