Aller à la documentation
API

Publier une version

Fige le brouillon courant et en fait ce que résout un envoi.

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

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

POST /templates/{id}/versions

Fige le brouillon courant et en fait ce que résout un envoi.

Exemple

Nécessite templates:write. Un POST vers la collection des versions, puisque c'est ce qu'il crée. Renvoie 201.

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

Le corps est compilé ici plutôt qu'au moment de l'envoi. Un modèle qui ne se rend pas échoue devant la personne qui le publie, dernier moment où il peut échouer devant quelqu'un capable de le corriger.

Idempotent. Publier une tête déjà publiée la renvoie inchangée au lieu de créer une version identique : un script de déploiement peut donc l'appeler à chaque exécution.

Un corps qui référence une clé que rien ne déclare donne invalid_template, un 422, et rien n'est publié.