---
title: "Preflight an outbound email"
method: POST
path: "/api/emails/{address}/deliverability-check"
tags: ["Email"]
---

# Preflight an outbound email

`POST /api/emails/{address}/deliverability-check`

## Request

- Base URL: `https://domani.run`
- URL: `https://domani.run/api/emails/{address}/deliverability-check`
- Auth: HTTP bearer

Run the exact versioned server-side policy used by the send endpoint without sending or consuming email quota. Public HTTPS authentication links on third-party domains are allowed with a reputation warning. Local/private URLs, non-HTTPS authentication links and executable attachments are blocked; bodies above 102 KB produce a clipping warning.

## Path parameters

- `address` string, required

## Request body

- union
  - object
    - `subject` string
    - `text` string, required
    - `html` string
    - `idempotency_key` string
    - `allow_risky_content` boolean: Deprecated compatibility field; objective safety blocks cannot be overridden.
    - `attachments` object[]
      - `filename` string, required
      - `content_type` string
  - object
    - `subject` string
    - `text` string
    - `html` string, required
    - `idempotency_key` string
    - `allow_risky_content` boolean: Deprecated compatibility field; objective safety blocks cannot be overridden.
    - `attachments` object[]
      - `filename` string, required
      - `content_type` string

## Response `200`

Versioned policy report

- object
  - `policy_version` string, required
  - `decision` 'allow' | 'allow_with_warnings' | 'deny', required
  - `safe_to_send` boolean, required: Backwards-compatible boolean equivalent to decision != deny
  - `risk` 'low' | 'medium' | 'high' | 'blocked', required
  - `score` integer, required
  - `authentication_message` boolean
  - `checks` object[], required
    - `id` string, required
    - `category` 'transport_safety' | 'credential_safety' | 'reputation' | 'content_quality' | 'reliability', required
    - `status` 'pass' | 'warning' | 'blocked', required
    - `message` string, required
    - `fix` string
    - `evidence` string[]
  - `blocked_reasons` string[], required
  - `warnings` string[], required
  - `override_used` boolean

## Other responses

- `404`: Mailbox not found

---

[API](https://skmtc.dev/domani/apis/domani-run-api.md) · [All operations](https://skmtc.dev/domani/apis/domani-run-api/llms.txt) · [OpenAPI document](https://skmtc.dev/domani/apis/domani-run-api/revisions/7679f8159533?raw)