Publicar una versió
Congela l'esborrany actual i el converteix en el que resol un enviament.
Executa la crida real contra el teu espai de treball, amb la teva pròpia clau.
POST /templates/{id}/versions
Congela l'esborrany actual i el converteix en el que resol un enviament.
Exemple
Necessita templates:write. Un POST a la col·lecció de versions, perquè és el que crea. Retorna 201.
curl -X POST "$OE/templates/order-shipped/versions" -H "$AUTH"{ "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 }}El cos es compila aquí i no en el moment d'enviar. Una plantilla que no es renderitza falla per a la persona que la publica, que és l'últim moment en què pot fallar davant d'algú que ho pot arreglar.
Idempotent. Publicar un cap ja publicat el retorna sense canvis en comptes d'encunyar una versió idèntica, de manera que un script de desplegament pot cridar-ho cada vegada que s'executa.
Un cos que referencia una clau que no declara res és invalid_template, un 422, i no es publica res.