Register a custom resolver hostname
Register a customer-owned hostname in PENDING state and return the DNS records to publish. Re-requesting a not-yet-verified hostname the org already owns refreshes its challenge token. Returns 422 when the hostname is Closient-owned or already claimed by another organization. Requires CHANGE permission.
Authorizations
Path Parameters
Organization UUID.
22^[23456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$Body
The customer-owned FQDN to register, e.g. id.theirco.com (no scheme, no port).
Response
Created
The customer-owned hostname, normalized lowercase.
Ownership-verification state.
PENDING, VERIFIED, DISABLED Edge-certificate state (read-only; driven by the cert pipeline).
NOT_REQUESTED, PENDING, ACTIVE, FAILED True when this hostname is VERIFIED and its edge cert is ACTIVE — QRs may print against it.
DNS records to publish for this hostname.
ISO-8601 timestamp of the last successful verification, or null.
ISO-8601 timestamp of the last verification attempt, or null.
Reason the last verification attempt failed (empty on success).