Update email metadata
Update name, subject, and sender fields. Omitted fields stay unchanged; null clears nullable fields. Updating preview_text rewrites the preheader in the current HTML in place without creating a new version.
Authorizations
Workspace API key, e.g. Authorization: Bearer tented_.... Create keys in Workspace Settings → API Keys.
Path Parameters
Email ID.
Body
Internal name.
1 - 200Subject line.
1 - 998Preheader text.
200Sender display name.
120Sender address.
Reply-to address.
Response
Updated email.
Full email object.
Email ID.
Internal name (never shown to recipients).
Lifecycle state.
draft, approved Latest content version number.
Subject line.
Preheader text.
Sender display name.
Sender address. Sending requires a verified domain.
Reply-to address.
Version that is approved, or null.
Number of content versions (equals current_version).
Whether plain text has been manually overridden.
When the plain-text override was set.
True when HTML changed after a plain-text override, so the override may be stale.
Creation time.
Last update.
Who created the email (API key name or user).
Status of the most recent AI generation, when one exists.
generating, completed, failed API path to fetch the latest HTML, e.g. /v1/emails/{emailId}/content.
API path to fetch the plain-text rendition.