organizations

Create Active Organization Domain

Claim an email domain for the caller's organization. Owners and admins only.

The claim lands unverified and does nothing until POST /me/domains/{id}/verify finds the record in verification_record published at the domain's apex. A public email provider is refused outright, and a domain another organization already claims answers 409 without saying who holds it.

post/v1/organizations/me/domains

Request body

default_role'member' | 'viewer'
domainstring required
enabledboolean

Response

Successful Response

created_atstring date-time required
default_rolestring
domainstring required
enabledboolean
idstring uuid required
organization_idstring uuid required
proof_expires_atstring date-time nullable
updated_atstring date-time nullable
verification_recordstring required
verified_atstring date-time nullable

Changes