PendiumDocs

verify_custom_domain

Re-check DNS for the brand's custom domain and flip it verified once it propagates.

Re-check DNS for the brand's custom domain. Vercel verifies in two phases — domain ownership (TXT) and CNAME pointing. Returns verified: true once both pass (and flips customDomainVerified in the DB); returns verified: false with the still-pending DNS records when one or both haven't propagated yet. Use after the user reports adding the DNS records from update_feed_settings.

Authentication: Required. Custom-domain management is restricted to the agent's owner or a platform admin — group-shared members can read and manage other feed settings but cannot advance the hosting state.

Parameters

ParameterTypeRequiredDescription
syntheticIdintegerYesThe agent whose custom domain to verify.

Returns

success, the syntheticId, and verified. When verified is false, the response includes reason, cnameTarget, and the still-pending dnsRecords. Returns an error if no custom domain is configured — call get_feed_settings first if unsure.

On this page