---
title: "Update email design system"
method: PATCH
path: "/email-design-system"
tags: ["Email Design System"]
---

# Update email design system

`PATCH /email-design-system`

Adjusts the company's email design system. This is a partial update - only the passed fields change - and it affects every future AI email generation and sequence enrichment. The adjustment is written into the company's emailDesignPrompt direction text (the single source of truth) - the new identity's sentences are prepended and custom prose the text carried is preserved below them. Pass reset true to clear the direction text and return to the brand-derived defaults.

## Request body

- object
  - `designCode` object — Partial visual-grammar adjustment; omitted tokens keep their current value.
    - `kickerStyle` 'chip' | 'letterspaced' | 'none' — How eyebrows above titles render.
    - `titleAlignment` 'left' | 'center'
    - `buttonShape` 'rounded' | 'pill'
    - `dividerStyle` 'line' | 'space'
    - `density` 'airy' | 'compact'
    - `openerTreatments` string[] — The opener treatments this company's emails may use, primary first.
  - `compositionSpine` 'hero-led' | 'editorial' | 'product-spec' — Which worked-example skeleton anchors generation.
  - `reset` boolean — true clears the direction text and returns to brand-derived defaults. Cannot be combined with designCode or compositionSpine.

## Response `200`

Email design system updated

- object
  - `success` boolean
  - `message` string
  - `designSystem` EmailDesignSystem — The visual identity every AI-generated email renders inside, parsed from the company's design direction text.
    - `version` integer, required
    - `designCode` object, required — The locked visual grammar applied to every generated email.
      - `version` integer, required
      - `kickerStyle` 'chip' | 'letterspaced' | 'none', required
      - `titleAlignment` 'left' | 'center', required
      - `buttonShape` 'rounded' | 'pill', required
      - `dividerStyle` 'line' | 'space', required
      - `density` 'airy' | 'compact', required
      - `openerTreatments` string[], required
    - `compositionSpine` 'hero-led' | 'editorial' | 'product-spec', required — Which worked-example skeleton anchors email composition.
    - `source` 'derived' | 'custom', required — derived when every token comes from brand derivation; custom when the direction text carries the identity.
  - `directionText` string, nullable — The rewritten direction text now stored on the company; null after a reset.
  - `isDefault` boolean

## Other responses

- `400` — Invalid design system value
- `401` — Unauthorized
- `404` — Company not found
- `409` — The design system was modified concurrently by another request; retry the update.
- `503` — The database was temporarily unavailable. The request may be retried after the delay in Retry-After.

## Changes

- **2026-08-31** `e1667306c303` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/sequenzy/apis/sequenzy-api/changes/email-design-system/patch.md)

---

[API](https://skmtc.dev/sequenzy/apis/sequenzy-api.md) · [All operations](https://skmtc.dev/sequenzy/apis/sequenzy-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sequenzy/sequenzy-api/revisions/e1667306c303/schema)