Skip to main content
POST
Approve an email template

Authorizations

Authorization
string
header
required

Workspace API key, e.g. Authorization: Bearer tented_.... Create keys in Workspace Settings → API Keys.

Path Parameters

templateId
string<uuid>
required

Email template ID.

Body

application/json
version
integer

Expected current version.

Required range: x >= 1

Response

Approved.

Full email template object.

template_id
string<uuid>
required

Email template ID.

name
string
required

Internal name (never shown to recipients).

status
enum<string>
required

Lifecycle state.

Available options:
draft,
approved
current_version
integer
required

Latest content version number.

source_type
enum<string>

How the template was created: upload for API- or hand-created templates, email for templates saved from an existing email.

Available options:
upload,
email
source_email_id
string<uuid> | null

Email the template was saved from, when source_type is email.

default_subject
string | null

Default subject line copied onto emails seeded from this template.

default_preview_text
string | null

Default preheader text for seeded emails.

default_from_name
string | null

Default sender display name for seeded emails.

default_from_address
string | null

Default sender address for seeded emails. Sending requires a verified domain.

default_reply_to_email
string | null

Default reply-to address for seeded emails.

approved_version
integer | null

Version that is approved, or null.

number_of_iterations
integer

Number of content versions (equals current_version).

plain_text_overridden
boolean

Whether plain text has been manually overridden.

plain_text_overridden_at
string<date-time> | null

When the plain-text override was set.

plain_text_stale_after_html_iteration
boolean

True when HTML changed after a plain-text override, so the override may be stale.

created_at
string<date-time>

Creation time.

updated_at
string<date-time>

Last update.

created_by_name
string

Who created the template (API key name or user).

latest_generation_status
enum<string>

Status of the most recent AI generation, when one exists.

Available options:
generating,
completed,
failed
content_path
string

API path to fetch the latest HTML, e.g. /v1/email-templates/{templateId}/content.

plain_text_path
string

API path to fetch the plain-text rendition.