Connections

One-click sync return (public; authenticated by the signed state)

Where the DNS provider sends the browser after the user approves or cancels a one-click sync apply. It is the redirect_uri the signed apply_url carries, not a bearer-authenticated endpoint. The signed single-use state rides in the path because some providers (Cloudflare) drop the separate state parameter. It records a provider-reported error on the connection, runs the propagation check at once, and returns the same HTML finish page as the OAuth callback, which postMessages { type: "customdomain:oauth", payload } to the origin vetted at start. A clean return never marks the connection live by itself: only the records appearing in public DNS do.

get/connect/dc/return/{state}

Request

  • Base URL: https://api.customdomain.ai/v1
  • URL: https://api.customdomain.ai/v1/connect/dc/return/{state}
  • Auth: none required

Path parameters

statestring required

Query parameters

errorstring

OAuth 2.0 error code the provider reports (access_denied when the user cancels).

error_descriptionstring

Response

HTML finish page (postMessages the outcome to the vetted return origin)

Changes

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