API

Opublikuj wersję

Zamraża bieżącą wersję roboczą i czyni ją tym, co rozstrzyga wysyłka.

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

Uruchamia prawdziwe wywołanie na twojej przestrzeni roboczej, twoim własnym kluczem.

POST /templates/{id}/versions

Zamraża bieżącą wersję roboczą i czyni ją tym, co rozstrzyga wysyłka.

Przykład

Wymaga templates:write. POST na kolekcję wersji, bo właśnie to tworzy. Zwraca 201.

curl

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

Odpowiedź

{  "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 }}

Treść jest kompilowana tutaj, a nie przy wysyłce. Szablon, który się nie renderuje, wywala się osobie, która go publikuje, czyli w ostatniej chwili, w której może się wywalić na oczach kogoś, kto może to naprawić.

Idempotentne. Opublikowanie już opublikowanej głowicy zwraca ją bez zmian, zamiast tworzyć identyczną wersję, więc skrypt wdrożeniowy może wywoływać to przy każdym przebiegu.

Treść odwołująca się do klucza, którego nic nie deklaruje, to invalid_template, 422, i nic nie zostaje opublikowane.