Aller à la documentation
API

Lire une version

Une révision avec son corps, pour voir ce que contient une ancienne version sans la restaurer.

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

Exécute le véritable appel sur votre espace de travail, avec votre propre clé.

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

Une révision avec son corps, pour voir ce que contient une ancienne version sans la restaurer.

Exemple

Nécessite templates:read. La liste des versions omet les corps. Ils sont ici.

curl
curl "$OE/templates/order-shipped/versions/3" -H "$AUTH"
Réponse
{  "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"}

Lire une version ne change rien. En restaurer une déplace le brouillon : c'est donc l'appel pour comparer, auditer, ou récupérer un bloc d'un design remplacé depuis. POST /templates/{id}/versions/{version}/restore reste ce qui la ramène.

Un seul de document et html contient quelque chose, et engine dit lequel. html est le balisage exactement tel qu'il a été soumis, avant l'assainissement effectué à la publication : c'est donc ce qu'il faut renvoyer dans un PATCH, et non ce que le destinataire a reçu.

Un numéro que personne n'a publié, ou un numéro supprimé, donne un 404 template_version_not_found. Les numéros ne sont jamais réutilisés, un numéro supprimé reste donc perdu.