byo-domains

Register a bring-your-own domain and run the pre-flight intake scan.

Runs the live-infra scan, the abuse gate, and the reputation ladder, returning the starting byoStatus. A live-infra hit hard-refuses NS delegation and falls back to records_to_apply; a primary domain is always records_to_apply, never we_manage_zone. Real DNS delegation activates per-account the same way real sending does — this endpoint is reachable today, but registering a domain does not itself set up anything real until the account is activated.

post/byo-domains

Request

  • Base URL: https://api.coldrig.dev
  • URL: https://api.coldrig.dev/byo-domains
  • Auth: HTTP bearer

Request body

domainstring required

One line of plain text: a line break, tab, control character or invisible text-direction mark is refused (400) naming this field.

domainRelationship'fresh_standalone' | 'subdomain_of_primary' | 'is_primary' required

fresh_standalone = brand-new domain, no history; subdomain_of_primary = a subdomain of the account's existing primary domain; is_primary = the account's own flagship business domain.

Response

Domain registered — intake started.

domainIdstring required
domainstring required
isPrimaryboolean required
dnsMode'we_manage_zone' | 'records_to_apply' required
byoStatus'pending_kyc' | 'pending_consent' | 'pending_dns' | 'active' | 'rejected' | 'abandoned' required
breakerTier'standard' | 'elevated' | 'primary' required
reputationBranchstring nullable required
scanobject required

Pre-flight live-infra scan result.

abuseVerdictstring required

Abuse-gate verdict.

consentAcknowledgedboolean required

Changes

No recorded changes to this operation across all 2 revisions of this API.