API

Опубликовать версию

Замораживает текущий черновик и делает его тем, что разрешает отправка.

POSTapi.openemail.uk/templates/{id}/versions

Выполняет настоящий запрос в вашем рабочем пространстве, с вашим собственным ключом.

POST /templates/{id}/versions

Замораживает текущий черновик и делает его тем, что разрешает отправка.

Пример

Требует templates:write. POST к коллекции версий, потому что именно версию он и создаёт. Возвращает 201.

curl

curl -X POST "$OE/templates/order-shipped/versions" -H "$AUTH"

Ответ

{  "object": "template_version",  "id": "tplv_5d31c2a8…",  "templateId": "tpl_9c1f0a4b7e05d3862c1f0a44",  "version": 5,  "state": "published",  "engine": "html",  "subject": "Order {{orderId}} is on its way",  "slots": [],  "props": [{ "key": "orderId", "kind": "text", "required": true, "default": null }],  "publishedAt": "2026-08-30T11:02:19.000Z",  "createdAt": "2026-08-30T10:58:04.000Z",  "template": { "object": "template", "publishedVersion": 5, "latestVersion": 5 }}

Тело компилируется здесь, а не в момент отправки. Шаблон, который не отрисовывается, падает у того, кто его публикует, а это последний момент, когда он может упасть на глазах у того, кто способен это исправить.

Идемпотентно. Публикация уже опубликованной вершины возвращает её без изменений, а не порождает идентичную версию, так что скрипт развёртывания может вызывать это при каждом запуске.

Тело, ссылающееся на ключ, который нигде не объявлен, — это invalid_template, 422, и ничего не публикуется.