Clerk API (unofficial showcase)
POST/organizations/{organization_id}/domains/{domain_id}/verify_ownership

Mark an organization domain's ownership as verified

Flips the organization domain's ownership state to verified via the manual override path, bypassing the self-serve TXT DNS challenge. The domain row records strategy=manual_override and an organization_domain.ownership_verified audit event is emitted with the same strategy.

Idempotent: re-calling on an already-verified domain returns the current ownership state without re-emitting the audit event.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

2 parameters
organization_idstringrequired
The ID of the organization to which the domain belongs
domain_idstringrequired
The ID of the domain

4 status codes
200An organization domain
objectstringrequired
String representing the object's type. Objects of the same type share the same value. Always `organization_domain`
Allowed:organization_domain
idstringrequired
Unique identifier for the organization domain
organization_idstringrequired
Unique identifier for the organization
namestringrequired
Name of the organization domain
enrollment_modestringrequired
Mode of enrollment for the domain
Allowed:manual_invitationautomatic_invitationautomatic_suggestionenterprise_sso
affiliation_email_addressstringrequired
Affiliation email address for the domain, if available.
affiliation_verificationobjectrequired
Verification details for the user-facing affiliation between the domain and the organization (e.g. affiliation_email_code).
ownership_verificationobjectrequired
Verification details for the underlying DNS domain ownership proof (TXT challenge or dashboard override). Null until ownership has been attempted.
verificationobjectdeprecatedrequired
Deprecated alias for `affiliation_verification`. Kept for backward compatibility on the current API version; will be removed in the next API version. Prefer `affiliation_verification`.
total_pending_invitationsintegerrequired
Total number of pending invitations associated with this domain
total_pending_suggestionsintegerrequired
Total number of pending suggestions associated with this domain
public_organization_dataobjectoptional
Public organization data associated with this domain
created_atintegerrequired
Unix timestamp when the domain was created
updated_atintegerrequired
Unix timestamp of the last update to the domain
401Authentication invalid
errorsarray<object>required
metaobjectoptional
clerk_trace_idstringoptional
403Request was not successful
errorsarray<object>required
metaobjectoptional
clerk_trace_idstringoptional
404Resource not found
errorsarray<object>required
metaobjectoptional
clerk_trace_idstringoptional

Error handling

A 401 is returned: Authentication invalid. A 403 is returned: Request was not successful. A 404 is returned: Resource not found.