Skip to main content
PUT
Update a sequence email

Authorizations

X-Kit-Api-Key
string
header
required

Authenticate API requests via an API Key

Path Parameters

id
integer
required
sequence_id
integer
required

Body

application/json
subject
string

New subject line for the email

preview_text
string | null

New preview text shown in email clients before the email is opened

content
string | null

New HTML body content of the email. On a Starting point template, the email keeps the template's design and this HTML is placed inside it. On a published email, the change is saved as a draft: reads keep returning the published content, with has_unpublished_changes set to true, until you send published: true. On an email that uses Kit's legacy editor, the new content goes live at once.

delay_value
integer

New delay value

delay_unit
enum<string>

New delay unit. Use days for schedule-aware delivery, hours for a fixed hourly delay

Available options:
days,
hours
email_template_id
integer | null

New email template ID for layout and styling. Pass null to clear. Changing to or from a Starting point template without sending content applies the new template's design to the email. When that would discard content the email already has, the request returns a 409 unless you also send allow_content_loss: true. Send content in the same request to keep your own content instead. Switching between other templates keeps the content as it is. An email whose content was made in Kit's older editor can't be switched to a Starting point template this way: open it in Kit once, then retry.

allow_content_loss
boolean | null

Confirms a template change that would discard the email's content. Only applies when you change email_template_id without sending content. Defaults to false.

published
boolean

Pass true to publish a draft email or false to unpublish it

send_days
string[] | null

Days of the week this email may be sent. Pass a subset to restrict delivery, or null to reset to all days (inherits the sequence schedule)

position
integer | null

New zero-based position of the email in the sequence

Response

Updates the sequence email and returns its details

email
object
required