Actualizar una plantilla
Los metadatos se parchean en el sitio. Tocar el cuerpo de una plantilla publicada acuña un borrador nuevo.
Ejecuta la llamada real contra tu espacio de trabajo, con tu propia clave.
PATCH /templates/{id}
Los metadatos se parchean en el sitio. Tocar el cuerpo de una plantilla publicada acuña un borrador nuevo.
Ejemplo
Necesita templates:write. name, description y status son metadatos; subject, document, html, slots, props y engine son el cuerpo, y enviar cualquiera de ellos es lo que acuña una versión.
curl -X PATCH "$OE/templates/order-shipped" -H "$AUTH" -H "Content-Type: application/json" \ -d '{ "html": "<p>Hello {{customer}}, {{orderId}} is on its way.</p>", "expectedVersion": 4 }'{ "object": "template", "id": "tpl_9c1f0a4b7e05d3862c1f0a44", "publishedVersion": 3, "latestVersion": 5, "latest": { "object": "template_version", "version": 5, "state": "draft", "publishedAt": null }}El borrador nuevo no es enviable y nada en vivo se ha movido: los envíos siguen resolviendo la versión 3 hasta que publiques. Esa es la razón entera de que la edición no ocurra en el sitio.
expectedVersion es la versión que leíste antes de editar. Súminístrala y una edición concurrente es un 409 version_conflict en lugar de una sobrescritura silenciosa; omítela y gana la última escritura, lo cual está bien para una persona en una pestaña y está mal para un script.
status: "archived" saca una plantilla de la lista sin borrarla. Una plantilla archivada sigue resolviendo para un envío que la nombre. Archivar es ordenar, no un interruptor de apagado.