API

Publikování verze

Zmrazí aktuální koncept a udělá z něj to, co vyhodnotí odeslání.

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

Spustí skutečné volání proti vašemu pracovnímu prostoru, s vaším vlastním klíčem.

POST /templates/{id}/versions

Zmrazí aktuální koncept a udělá z něj to, co vyhodnotí odeslání.

Příklad

Vyžaduje templates:write. POST na kolekci verzí, protože právě tu vytváří. Vrací 201.

curl

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

Odpověď

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

Tělo se kompiluje tady, ne až při odesílání. Šablona, která se nevykreslí, selže tomu, kdo ji publikuje, což je poslední okamžik, kdy může selhat před někým, kdo to umí opravit.

Idempotentní. Publikování už publikované hlavy ji vrátí beze změny, místo aby vytvořilo identickou verzi, takže to nasazovací skript může volat při každém běhu.

Tělo, které odkazuje na klíč, jejž nikde nic nedeklaruje, je invalid_template, 422, a nic se nepublikuje.