Email

Send an email

Send an email from a mailbox identified by its full email address. The server runs a mandatory versioned policy first: objective safety failures are denied while reputation and content-quality findings are returned as warnings. For a collaborative threaded reply, pass the compose lease, observed reply_version, and a stable idempotency key; the server atomically rejects stale or double replies immediately before sending. Maximum 20 unique recipients per message. Rate limit: 100 recipients per hour per mailbox.

post/api/emails/{address}/send

Request

  • Base URL: https://domani.run
  • URL: https://domani.run/api/emails/{address}/send
  • Auth: HTTP bearer

Path parameters

addressstring required

Sender email address (URL-encoded)

Headers

Idempotency-Keystring

Unique key to prevent duplicate sends

Request body

subjectstring
textstring

Plain text body

htmlstring

HTML body

reply_tostring

Reply-To address

in_reply_tostring

Message-ID of the email being replied to (for threading)

referencesstring

Space-separated Message-ID chain (for threading)

idempotency_keystring

Stable key that prevents duplicate sends

send_atstring date-time

Schedule the send (ISO 8601, 30 seconds to 30 days out). The message is stored with status 'scheduled' and dispatched server-side; move it to trash before then to cancel. Attachments are not supported with send_at yet.

allow_risky_contentboolean

Deprecated compatibility field. Public HTTPS third-party auth links are allowed with a warning; objective safety blocks cannot be overridden.

Response

Email sent

idstring
message_idstring

RFC 5322 Message-ID

fromstring
tostring
bccstring nullable

Bcc recipient(s) you sent to, echoed back on your own outbound message only; never delivered as a header and never present on a message you received.

statusstring
attachments_countinteger
suppressedstring[]
deliverabilityobject

Versioned policy report applied to this send; inspect decision and categorized checks

Changes

No recorded changes to this operation across all 2 revisions of this API.