Sign in
Email AI Style

Save AI email style

Requires emails:write and access to the source email. Snapshots the stored email appearance, using email then company theme and font defaults, or the optional unsaved canvas, plus detected layout habits such as dotted dividers around every button. Existing emails and company theme remain unchanged. Marketers cannot capture transactional sources. Replaces only the expected revision; explicit generation style requests and plain-text choices still take precedence.

put/email-ai-style

Request body

emailIdstring required

Source email ID in this company, including campaign, sequence and transactional email rows. Use the underlying email ID, not a campaign ID or transactional slug.

expectedStyleIdstring nullable required

revisionId returned by GET. Use null only when no style is stored.

layoutRuleIdsstring[]

IDs of detected layout habits to keep. Omit to keep every habit detected in the source; pass an empty array to keep none. Unknown IDs are ignored. Review style.layout.rules in the response.

notesstring

Optional design notes for future generations, for example "always open with a short video". Treated as design guidance, never as email content.

Response

Current saved-style state

successboolean required
revisionIdstring nullable required

Pass this as expectedStyleId on the next write. An unsupported style version still returns its revision for replacement or clearing.

canManageboolean required

Whether your key scopes and workspace role permit saving or clearing.

Example response

{
  "style": {
    "layout": {
      "rules": [
        {
          "description": "Dotted divider above and below every button"
        }
      ]
    }
  }
}

Changes

Changed in 1 of the 135 revisions of this API.1