Mailboxes
Check Sending Domain
Look up a sending domain's SPF, DKIM (common selectors), DMARC and MX records over DNS-over-HTTPS (free, no key). Admin+. Only a domain one of the workspace's mailboxes sends from; a result younger than `DELIVERABILITY_DNS_RECHECK_SECONDS` is returned as it is (`cached`).
API key access
Needs the
admin scope with an API key (ro_pat_...). A signed-in session uses the caller's role.POST
/api/v1/deliverability/domains/{domain}/checkAuthorizationBearer <token>
Access token from /api/v1/auth/login, or an API key (ro_pat_..., RO-176) from /api/v1/workspaces/current/api-keys: the key implies its workspace and needs the route's scope. MCP connectors (/api/v1/mcp only) may use an OAuth access token (ro_oat_..., RO-284).
In: header
Path Parameters
domainstring
Header Parameters
X-Workspace-Id?string | null
Id of the workspace to act on (must be a member).
Response Body
curl -X POST "http://localhost:8000/api/v1/deliverability/domains/string/check" \ -H "X-Workspace-Id: string"{
"domain": "string",
"dns": {
"spf": {
"status": "found",
"records": [
"string"
],
"detail": "string"
},
"dkim": {
"status": "found",
"records": [
"string"
],
"detail": "string"
},
"dmarc": {
"status": "found",
"records": [
"string"
],
"detail": "string"
},
"mx": {
"status": "found",
"records": [
"string"
],
"detail": "string"
}
},
"checked_at": "2019-08-24T14:15:22Z",
"cached": true
}Empty
Empty
Empty
Empty
Empty