Custom Domain
API referenceDomains

Detect where a domain's DNS lives and how it will be set up

POST
/domains:check

Read-only feature detection. Returns the provider, the chosen setup_type, whether automatic setup is possible, whether the OAuth-into-provider and Domain Connect rails are available, capability flags (ns_support, wildcard_support, cname_flattening, spf_override_support, caa_support), social-login support, and any record_conflicts observed in public DNS. Unknown providers degrade to setup_type: manual.

Authorization

widgetJWT
AuthorizationBearer <token>

Short-lived widget JWT minted server-side via POST /v1/tokens. Scoped to one application (and optionally one domain).

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

curl -X POST "https://example.com/domains:check" \  -H "Content-Type: application/json" \  -d '{    "domain": "string"  }'
{  "domain": "string",  "provider": "string",  "setup_type": "automatic",  "supports_automatic": true,  "oauth_available": true,  "domain_connect": true,  "registered": true,  "authoritative_dns_provider": "string",  "ns_support": {    "root": true,    "subdomains": true  },  "wildcard_support": true,  "cname_flattening": true,  "spf_override_support": true,  "caa_support": true,  "supports_social_login": "string",  "record_conflicts": [    {      "kind": "string",      "host": "string",      "type": "string",      "existing": "string",      "desired": "string"    }  ]}
{  "code": "string",  "title": "string",  "details": "string"}
{  "code": "string",  "title": "string",  "details": "string"}