Sign in

v101

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-08235133843.7 KB
Templates

Update template

Updates template metadata, labels, or content. Transactional email IDs and slugs are also resolved for compatibility.

put/templates/{templateId}

Path parameters

templateIdstring required

Template ID, transactional email ID, or transactional slug.

Request body

namestring
subjectstring
previewTextstring nullable

Inbox preview text. Send null to clear it.

htmlstring

Replacement HTML body. Mutually exclusive with blocks.

blocksobject[]

Replacement Sequenzy email blocks. Mutually exclusive with html. Put visual styling under styles; top-level style keys such as backgroundColor, backgroundOpacity, borderColor, borderWidth, and borderRadius are normalized into styles.

labelsstring[]

Replacement label names. Send an empty array to clear labels. Missing labels are created automatically.

labelstring[]

Compatibility alias for labels.

{"stackTrail":"paths:/templates/{templateId}:put:requestBody:content:application/json:schema:properties:updates","oasType":"schema","type":"unknown","description":"Unsupported nested update object. Requests using it return a validation error."}

Response

Template updated

successboolean
transactionalobject nullable
warningsstring[]

Non-blocking advisories about a successful write. Present when an input was discarded or did not take effect as requested. This includes block fields that do not render as their names suggest, sequence email-step formatting restored on top of submitted blocks, and sender-identity conflicts such as a replyToName that differs from the saved profile. Each message identifies the affected input and gives recovery guidance. Absent when there is nothing to report.

Example response

{
  "success": true,
  "template": {
    "labels": [
      "edm",
      "template"
    ]
  },
  "warnings": [
    "blocks[0].styles.color is not a supported field and was ignored. Button label color comes from the block-level `buttonTextColor` field. Supported styles fields: backgroundColor, backgroundOpacity, bleed, borderColor, borderRadius, borderWidth, paddingBottom, paddingLeft, paddingRight, paddingTop, textAlign, textColor."
  ]
}