domain-verifications

Initiate domain verification for an organization's SSO config

Creates a new domain verification record with a unique verification token. Returns the verification instructions with DNS record details.

post/admin/v1/organizations/{org_slug}/sso-config/domains

Request

Base URL: / (relative, and the document was published on a file host, not at the API’s origin)
URL: /admin/v1/organizations/{org_slug}/sso-config/domains
Auth: HTTP bearer

org_slugstring required

Organization slug

domainstring required

The domain to verify (e.g., "acme.com")

Domain verification initiated

created_atstring date-time required

When this record was created

dns_txt_recordstring nullable

The actual DNS TXT record found during verification (for audit)

domainstring required

The domain being verified (e.g., "acme.com")

expires_atstring date-time nullable

Optional: require re-verification after this date

idstring uuid required

Unique identifier for this verification record

last_attempt_atstring date-time nullable

Last verification attempt timestamp

org_sso_config_idstring uuid required

SSO config this verification belongs to

status'pending' | 'verified' | 'failed' required

Domain verification status.

updated_atstring date-time required

When this record was last updated

verification_attemptsinteger required

Number of verification attempts

verification_tokenstring required

Random token for DNS TXT record verification

verified_atstring date-time nullable

When the domain was successfully verified

No recorded changes to this operation across all 1 revision of this API.