Raw schema
{
"type": "object",
"properties": {
"html": {
"type": "string",
"description": "The full email HTML to preview. Provide exactly one of html or eml."
},
"eml": {
"type": "string",
"description": "A complete raw RFC 822 message (.eml), base64-encoded — inserted verbatim (real headers, multipart, attachments). Max 10MB decoded. Provide exactly one of html or eml."
},
"subject": {
"type": "string",
"description": "Email subject line"
},
"include_previews": {
"type": "boolean",
"description": "Also capture the inbox-list row (how the message looks unread in the list) and the subject heading, returned as inbox_preview / subject_preview on each render. Default false: they cost more than the body render itself, so ask only when you need them."
},
"renders": {
"type": "array",
"items": {
"type": "object",
"properties": {
"client": {
"type": "string",
"enum": [
"gmail",
"outlook",
"yahoo"
],
"description": "Client ID"
},
"viewport_width": {
"type": "number",
"description": "Viewport width in pixels (200-2560). Defaults to the client default (1280)."
},
"color_scheme": {
"type": "string",
"enum": [
"light",
"dark"
],
"description": "Render in the client's light or dark mode (default light). Dark must be supported by the client — check color_schemes in list_clients."
},
"images_disabled": {
"type": "boolean",
"description": "Render with remote images blocked (default false)"
}
},
"required": [
"client"
],
"additionalProperties": false
},
"description": "Exactly the renders you want, one entry each (e.g. outlook light + outlook dark are two entries). Omit for the server default: every live client at its default width, light."
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}