Saltar para a documentação
API

Ler uma versão

Uma revisão com o seu corpo, para ver o que uma versão antiga contém sem a restaurar.

GETapi.openemail.uk/templates/{id}/versions/{version}

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

GET /templates/{id}/versions/{version}

Uma revisão com o seu corpo, para ver o que uma versão antiga contém sem a restaurar.

Exemplo

Requer templates:read. A lista de versões deixa os corpos de fora. Estão aqui.

curl
curl "$OE/templates/order-shipped/versions/3" -H "$AUTH"
Resposta
{  "object": "template_version",  "id": "tplv_5d31c2a8…",  "templateId": "tpl_9c1f0a4b7e05d3862c1f0a44",  "version": 3,  "state": "published",  "engine": "blocks",  "subject": "Order {{orderId}} is on its way",  "slots": [],  "props": [{ "key": "orderId", "kind": "text", "required": true, "default": null }],  "document": {    "preview": "Your order is on its way",    "tailwind": false,    "fonts": [],    "body": [{ "kind": "Heading", "text": "Order {{orderId}} is on its way" }],    "slots": [],    "props": [{ "key": "orderId", "kind": "text", "required": true, "default": null }]  },  "html": null,  "publishedAt": "2026-07-14T09:12:44.000Z",  "createdAt": "2026-07-14T09:10:02.000Z"}

Ler uma versão não muda nada. Restaurar uma mexe no rascunho, por isso esta é a chamada para comparar, auditar ou recuperar um bloco de um design que já substituiu. POST /templates/{id}/versions/{version}/restore continua a ser o que a traz de volta.

Apenas um de document e html traz conteúdo, e engine diz qual. O html é a marcação exatamente como foi submetida, antes da limpeza feita na publicação, por isso é o que se devolve num PATCH e não o que o destinatário recebeu.

Um número que ninguém publicou, ou um número apagado, dá um 404 template_version_not_found. Os números nunca são reutilizados, por isso um número apagado continua perdido.