Skip to main content
PATCH
Change custom domain pod scope

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id
string
required

Body

application/json
podId
string | null
required

Pod to scope the domain to (id or clientId). null makes the domain available to all pods.

Response

Scope changed; the returned domain reflects the new podId

Scope changed; the returned domain reflects the new podId

id
string

OpenMail domain ID

domain
string

The domain or subdomain, e.g. example.com or agent-mail.example.com.

podId
string | null

Pod this domain is scoped to, so only inboxes in that pod can use it, or null for an account-wide domain.

status
enum<string>

pending — added, records not yet published. verifying — being checked. verified — sending and receiving enabled. failed — records missing or wrong; publishing them and calling verify again is the fix. under_review — flagged as suspicious; DNS setup is blocked until approved.

Available options:
pending,
verifying,
verified,
failed,
under_review
records
object[]

The DNS records to publish for this domain. Returned even where the values are the same for every customer, so sending infrastructure can change without breaking clients.

warnings
object[]

Problems detected in the domain's DNS that do not block verification but do lose mail. Empty when none. Check this even when status is verified — every record can be correct and the zone still broken by something else in it.

verifiedAt
string<date-time> | null
createdAt
string<date-time>
updatedAt
string<date-time>