Save AI Style - Sequenzy

PUT

api

email-ai-style

Save AI Style

curl --request PUT \
  --url https://api.sequenzy.com/api/v1/email-ai-style \
  --header 'Authorization: Bearer <token>'

const options = {method: 'PUT', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.sequenzy.com/api/v1/email-ai-style', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.sequenzy.com/api/v1/email-ai-style",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.sequenzy.com/api/v1/email-ai-style"

	req, _ := http.NewRequest("PUT", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.sequenzy.com/api/v1/email-ai-style")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

Save an independent appearance snapshot from an email you can access. Requires emails:write. Marketers can save marketing email styles; transactional sources remain protected. Existing emails, source content and your company theme stay unchanged. Get the current style first. Pass its revisionId as expectedStyleId; use null only when no style is stored.

curl -X PUT https://api.sequenzy.com/api/v1/email-ai-style \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"emailId":"email_123","expectedStyleId":null}'

emailId is the underlying email ID, including a campaign, sequence or transactional email’s content row. It is not a campaign ID or transactional slug. The API captures the stored blocks and resolves the email’s theme/font overrides before company defaults. Subsequent source edits or deletion do not change your saved style. To capture an unsaved design, provide canvas with all four fields: blocks, theme, fontFamily and emailPreset (branded or minimal). theme is a complete editor theme with presetId, colors, typography and layout; use the schema above for required fields. Canvas validation is shared with the editor. Blocks are limited to 500 and 500,000 serialized characters. Empty content or footer/logo scaffolding cannot define a style. Imported HTML supports inline typography and colors, not an exact stylesheet/layout clone.

Layout habits and notes

Saving also detects layout habits in the source: the block it opens with (for example a video) and content-free companions that consistently frame a block type (for example a dotted divider above and below every button). Every detected habit is kept unless you narrow them. The response lists them under style.layout.rules, each with a stable id such as around|button|divider:dots, and style.layout.outline records the source section order.

layoutRuleIds: IDs of the habits to keep. Omit to keep all; pass [] to keep none. Unknown IDs are ignored.
notes: up to 500 characters of design guidance for future generations, such as “always open with a short video”. Notes are never treated as email content.

Generation follows the confirmed habits in its prompt and inserts the captured dividers or spacers deterministically around matching blocks. Opening habits that need content, such as a video, are prompt guidance only. To review before committing, save once, inspect style.layout.rules, then save again with the subset you want and the new revisionId.

curl -X PUT https://api.sequenzy.com/api/v1/email-ai-style \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"emailId":"email_123","expectedStyleId":"STYLE_REVISION","layoutRuleIds":["around|button|divider:dots"],"notes":"Keep the dotted dividers around buttons"}'

sequenzy email-ai-style save email_123 --if-unset
sequenzy email-ai-style save email_123 --expected-style-id STYLE_REVISION --canvas-file ./canvas.json --json
sequenzy email-ai-style save email_123 --expected-style-id STYLE_REVISION --layout-rules "around|button|divider:dots" --notes "Keep the dotted dividers around buttons"
sequenzy email-ai-style save email_123 --expected-style-id STYLE_REVISION --without-layout-rules

MCP save_email_ai_style accepts emailId, expectedStyleId, optional canvas, optional layoutRuleIds, optional notes and optional companyId. CLI --company selects the company for a personal key. The response returns success, the new style, its new revisionId and canManage. New AI generation across dashboard/API/CLI/MCP uses this appearance and its confirmed habits. Explicit style instructions and plain-text choices take precedence. See Email Themes. Errors: 400 for invalid/oversized canvas, empty content or notes over 500 characters; 401 for missing/invalid auth; 403 for missing scope, denied company access or a non-writing role; 404 for an inaccessible/missing source; 422 for missing or malformed required fields. 409 AI_STYLE_CONFLICT means another write won: get the current style, review it and explicitly retry using its revision. Never retry with a newly fetched revision automatically.

Save AI Style

curl --request PUT \
  --url https://api.sequenzy.com/api/v1/email-ai-style \
  --header 'Authorization: Bearer <token>'

const options = {method: 'PUT', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.sequenzy.com/api/v1/email-ai-style', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.sequenzy.com/api/v1/email-ai-style",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.sequenzy.com/api/v1/email-ai-style"

	req, _ := http.NewRequest("PUT", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.sequenzy.com/api/v1/email-ai-style")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

​Layout habits and notes

Layout habits and notes