Verify a custom resolver hostname
Check the published CNAME challenge record and mark the hostname VERIFIED on a match. Safe to call repeatedly while DNS propagates — a miss records last_error and leaves the hostname PENDING. Returns 422 if the hostname isn’t registered to this organization. Requires CHANGE permission.
Authorizations
Path Parameters
Organization UUID.
22^[23456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$Body
The registered hostname to verify ownership for.
Response
OK
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).