---
title: "Clone an email design"
method: POST
path: "/v1/emails/{emailId}/clone"
tags: ["Emails"]
---

# Clone an email design

`POST /v1/emails/{emailId}/clone`

Creates a NEW design by copying the persisted source snapshot exactly. This is a deterministic database fork: it does not invoke an AI agent, reinterpret markup, re-host assets, or regenerate the preview.

Omit `emailVersionId` to clone the current latest row, or pass a version id from `GET /v1/emails?emailId=<id>&include=versions` to clone that exact historical snapshot. The clone receives fresh design/version ids and a `Copy of …` title while JSX, rendered HTML, and the preview image remain identical.

## Path parameters

- `emailId` string, required — Design id returned by `POST /v1/emails` and listed by `GET /v1/emails`.

## Headers

- `Idempotency-Key` string

## Request body

- EmailCloneRequest
  - `emailVersionId` string — Exact source version to clone (from `list_email_designs` with `include: ["versions"]`). Omit to clone the current latest version.

## Response `201`

Exact clone created. The response carries the clone’s new ids plus the unchanged rendered HTML and preview.

- EmailGenerateGeneratedResponse
  - `emailId` string, required
  - `emailVersionId` string, required
  - `html` string, required
  - `previewImage` string, uri

## Other responses

- `400` — The request body or query string was invalid (unknown key, wrong type, or missing required field). Strict schemas reject unknown keys — including `brandId`, which is always resolved from the API key.
- `401` — The API key was missing, invalid, or revoked.
- `403` — The caller does not have the required `emails` permission.
- `404` — The source design or requested source version does not exist in the API-key brand.
- `409` — The source is still generating, or the idempotency key was reused with a different payload.
- `422` — The source design failed to generate.
- `429` — The request hit the rolling rate limit window.
- `500` — Unexpected internal error.

---

[API](https://skmtc.net/brew/apis/brew-public-api-v1.md) · [All operations](https://skmtc.net/brew/apis/brew-public-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/brew/brew-public-api-v1/versions/db96cfedc6c5/schema)