Update Brand Layout
PUT/api/store-email-layouts/:id
Saves the layout's HTML and quick settings.
settings:writeGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Authentication: Requires Bearer token and the email_templates.update permission.
Body: html (required, max 200000; must contain {{content}} exactly once and no scripts/forms/iframes/handlers — otherwise 422 on html), settings (object|null: logo_url, primary_color, accent_color, footer_text, support_email (email), show_social (bool); unknown keys are dropped; omit/null to keep the saved settings), updated_at (ISO-8601 last seen — 409 when someone saved since), version_source (manual|ai|restore, default manual), version_summary (max 500). A version is recorded when the HTML or settings change (newest 50 kept).
The 409 body is flat JSON: {message, current_updated_at, updated_by}.
Request
Responses
- 200
- 401
- 403
- 404
- 409
- 422
- 429
OK
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden
Response Headers
Not found — no record with the given identifier (or the route does not exist). Verify the ID before retrying.
Conflict
Response Headers
Unprocessable Entity
Response Headers
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.