Publicar una versión
Congela el borrador actual y lo convierte en lo que resuelve un envío.
Ejecuta la llamada real contra tu espacio de trabajo, con tu propia clave.
POST /templates/{id}/versions
Congela el borrador actual y lo convierte en lo que resuelve un envío.
Ejemplo
Necesita templates:write. Un POST a la colección de versiones, porque es lo que crea. Devuelve 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 cuerpo se compila aquí y no en el momento del envío. Una plantilla que no renderiza falla para quien la publica, que es el último momento en que puede fallar delante de alguien capaz de arreglarla.
Idempotente. Publicar una cabeza ya publicada la devuelve sin cambios en lugar de acuñar una versión idéntica, así que un script de despliegue puede llamar a esto cada vez que se ejecuta.
Un cuerpo que referencia una clave que nadie declara es invalid_template, un 422, y no se publica nada.