Send a rendered email from a standalone runtime

Hosted fulfillment of the runtime EmailSender seam. Accepts a fully RENDERED message (no template strings) and dispatches it through the platform email path with the managed-send-from-domain gate evaluated against the authenticated account. Requires a Runtype API key with the RUNTIME:EXECUTE scope (FLOWS:EXECUTE also accepted). Requires an Enterprise plan: ineligible accounts receive 403 (code BYOC_PLAN_REQUIRED).

Authentication

AuthorizationBearer

API key or Clerk session token

Request

This endpoint expects an object.

subjectstringRequired

tolist of stringsRequired

attachmentslist of objectsOptional

bcclist of stringsOptional

cclist of stringsOptional

fromstringOptional

htmlstringOptional

managedLocalPartstringOptionalformat: "^[A-Za-z0-9._-]{1,64}$"

Managed sender local part. Must be an identity the account owns: its user id, virtual, or an owned flow_/agent_ id; anything else is refused. Defaults to the caller’s user id.

rawFromstringOptional

replyTostringOptional

textstringOptional

Response

Email dispatched

fromstring

idstring

tolist of strings

Errors

400

Bad Request Error

401

Unauthorized Error

402

Payment Required Error

403

Forbidden Error

429

Too Many Requests Error

500

Internal Server Error

502

Bad Gateway Error

503

Service Unavailable Error