Saltar para a documentação
API

Publicar uma versão

Congela o rascunho atual e torna-o naquilo que um envio resolve.

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

Executa a chamada real contra o seu espaço de trabalho, com a sua própria chave.

POST /templates/{id}/versions

Congela o rascunho atual e torna-o naquilo que um envio resolve.

Exemplo

Requer templates:write. Um POST à coleção de versões, porque é isso que cria. Devolve 201.

curl
curl -X POST "$OE/templates/order-shipped/versions" -H "$AUTH"
Resposta
{  "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 }}

O corpo é compilado aqui e não no momento do envio. Um modelo que não renderiza falha para quem o publica, que é o último momento em que pode falhar diante de alguém capaz de o corrigir.

Idempotente. Publicar uma versão de topo já publicada devolve-a inalterada em vez de criar uma versão idêntica, pelo que um script de implementação pode chamar isto sempre que corre.

Um corpo que referencia uma chave que nada declara dá invalid_template, um 422, e nada é publicado.