v1

latestOpenAPI 3.1.02026-07-2670105729.6 KB

Emails

Clone an email design

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.

post/v1/emails/{emailId}/clone

Path parameters

emailIdstring required

Design id returned by POST /v1/emails and listed by GET /v1/emails.

Example:eml_2SmZOWV3ZQ7W5x6g3m4p

Design id returned by POST /v1/emails and listed by GET /v1/emails.

Headers

Idempotency-Keystring

Optional idempotency key for safe retries. Reusing the same key with the same request body returns the original response for 24 hours.

Request body

emailVersionIdstring

Exact source version to clone (from list_email_designs with include: ["versions"]). Omit to clone the current latest version.

Response

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

emailIdstring required

emailVersionIdstring required

htmlstring required

previewImagestring uri